菜单
Knowledge about third-party music databases and asset providers used for album identification and cover art — per-provider endpoints, auth, rate limits, response shapes, and scraping recipes
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | music-scraping |
| description | Knowledge about third-party music databases and asset providers used for album identification and cover art — per-provider endpoints, auth, rate limits, response shapes, and scraping recipes |
Per-provider knowledge base for the identification and asset providers registered with PhonoContext in phono-junk-lib. Each provider documented here corresponds to a phono-junk-* crate implementing IdentificationProvider and/or AssetProvider from phono-junk-identify.
IMPORTANT: When adding or extending a provider, document every upstream endpoint, auth requirement, rate-limit policy, and response format here. Cite official API docs; save HTML fixtures under fixtures/ for scraper-backed providers. Same rule as the sibling phono-archive skill — see ../phono-archive/SKILL.md.
| Provider | Crate | Identify | Assets | Auth | Shape |
|---|---|---|---|---|---|
| MusicBrainz | phono-junk-musicbrainz | yes (DiscID, barcode) | via Cover Art Archive | none (User-Agent required) | JSON/XML API |
| Discogs | phono-junk-discogs | yes (barcode, catno) | yes | user token | JSON API |
| iTunes Search | phono-junk-itunes | — | yes | none | JSON API |
| Amazon | phono-junk-amazon | — | yes | optional PA-API | ASIN + PA-API |
| Tower Records MDB | (planned) phono-junk-tower | yes (barcode, catno) | cover art | none | HTML scrape — see tower-mdb.md |
Official JSON-API providers each get a short notes file only where their behavior diverges from the public docs (rate-limit surprises, undocumented fields, auth edge cases). Scraper-backed providers always get a full doc: URL patterns, selectors, caveats, and at least one fixture under fixtures/.
phono-junk-lib::http, shared with rate-limited JSON providers; per-host policy is configured at provider registration.phono-junk/0.x (+https://github.com/.../phono-junk). Never impersonate a browser to bypass throttling.fixtures/ contains verbatim HTML responses used when documenting scraper selectors and as regression fodder for parser tests. Filename convention: {provider}-{page-kind}-{key}.html. Always record the source URL and fetch date in the accompanying provider doc so fixtures can be refreshed.