agent-discogs
npx skills add https://github.com/jmfontaine/agent-discogs --skill agent-discogs
Agent 安装分布
Skill 文档
agent-discogs
CLI for searching and exploring the Discogs music database. Returns compact text output with a ref system for chaining commands.
Setup
Requires DISCOGS_TOKEN for full access (60 req/min, search, price data):
export DISCOGS_TOKEN=<your-token> # discogs.com/settings/developers
Without a token: 25 req/min, no search, no price suggestions.
Check status: agent-discogs status
Core Workflow
- Search â find entities by name
agent-discogs search release "The Downward Spiral" --year 1994 - Inspect â get full details using refs from search output
agent-discogs get release @r367113 - Drill down â tracklist, pricing
agent-discogs tracks @r367113 agent-discogs price @r367113 - Explore â discography, versions
agent-discogs get versions @m4917 --country US
Common Patterns
| Goal | Commands |
|---|---|
| Find a specific pressing | search release "<title>" --year --country â get release @r... |
| Compare pressings | search master "<title>" â get versions @m... |
| Explore discography | search artist "<name>" â get releases @a... |
| Check price | search release "<title>" â price @r... |
| Identify by catalog number | search release --catno "INT-92346" â get release @r... |
| Find by barcode | search release --barcode "606949235024" |
| Get original pressing | search master "<title>" â get versions @m... â get release @r... |
| Narrow release search | search release "<title>" --artist "<name>" |
| Get release notes | get release @r... --verbose |
| Get artist/label IDs from a release | get release @r... --verbose â inline [@a...] and [@l...] refs |
| VA compilation tracks | get release @r... â per-track artists shown automatically |
| Machine-readable output | Add --json to any command for raw JSON |
Machine-Readable Output
All commands support --json for raw JSON output, useful for piping into other tools or extracting structured data:
agent-discogs search release "Blue Monday" --artist "New Order" --json
agent-discogs get release @r367113 --json
Anti-Patterns
- Don’t search without a type filter when you know the entity type.
- Don’t fetch full release details just to check price. Use
price @r...directly. - Don’t paginate through all results. Narrow with filters first.
- Don’t guess IDs. Always search first to find the right entity.
- Don’t use
get versionson a release ID. Use a master ref (smart resolution costs an extra API call).
Refs
Refs encode entity type and Discogs ID: @a3857 (artist), @r367113 (release), @m4917 (master), @l2919 (label). Raw numeric IDs also work.
Key Concepts
Master = canonical album. Release = specific pressing. Version = a release belonging to a master. Search masters to find all pressings; search releases to find a specific one. See references/pressings-guide.md for details.
Formats, genres, identifiers, and other Discogs-specific data conventions are documented in references/discogs-domain.md.
Reference Docs
| Document | Content |
|---|---|
| references/commands.md | Full command reference with all flags |
| references/search-patterns.md | Effective search strategies |
| references/pressings-guide.md | Master/release/version mental model |
| references/discogs-domain.md | Discogs data model: formats, genres, country, artists, labels, identifiers |