# Send Discogs Sync to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "discogs-sync", "name": "Discogs Sync", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/khaney64/discogs-sync", "canonicalUrl": "https://clawhub.ai/khaney64/discogs-sync", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/discogs-sync", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=discogs-sync", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "discogs-sync.py", "requirements.txt", "src/discogs_sync/__init__.py", "src/discogs_sync/auth.py", "src/discogs_sync/cache.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "discogs-sync", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-02T14:14:38.919Z", "expiresAt": "2026-05-09T14:14:38.919Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=discogs-sync", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=discogs-sync", "contentDisposition": "attachment; filename=\"discogs-sync-0.1.10.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "discogs-sync" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/discogs-sync" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/discogs-sync", "downloadUrl": "https://openagent3.xyz/downloads/discogs-sync", "agentUrl": "https://openagent3.xyz/skills/discogs-sync/agent", "manifestUrl": "https://openagent3.xyz/skills/discogs-sync/agent.json", "briefUrl": "https://openagent3.xyz/skills/discogs-sync/agent.md" } } ``` ## Documentation ### Discogs Sync — Wantlist, Collection & Marketplace CLI Add and remove albums from your Discogs wantlist or collection, search marketplace pricing, and list what you have. Identify albums by artist/album name, Discogs master ID, or release ID. For bulk operations, pass a CSV or JSON file. ### Runtime & Dependencies Runtime: Python 3.10+ Python packages (installed automatically on first run): python3-discogs-client>=2.8 — Discogs API client click>=8.1 — CLI framework rich>=13.0 — Terminal output formatting Installation: No manual pip install needed. On first run, discogs-sync.py creates a local .deps/ virtual environment inside the skill directory and installs dependencies from requirements.txt. Subsequent runs reuse the existing venv. This works on macOS (including Homebrew Python), Linux, and Windows without requiring system-level package installation. To force a clean reinstall of dependencies, delete the .deps/ directory and run any command again. ### Quick Start # Authenticate (one-time setup — also installs dependencies on first run) python3 discogs-sync.py auth # Add an album to your wantlist by name python discogs-sync.py wantlist add --artist "Radiohead" --album "OK Computer" # Add to your collection by release ID python discogs-sync.py collection add --release-id 7890 # Check marketplace prices for a vinyl pressing python discogs-sync.py marketplace search --artist "Miles Davis" --album "Kind of Blue" --format Vinyl # List your wantlist python discogs-sync.py wantlist list # Remove from collection python discogs-sync.py collection remove --artist "Nirvana" --album "Nevermind" ### Authentication Run once to authenticate. Two modes are available: Personal access token (default) — simplest option. Generate a token at https://www.discogs.com/settings/developers. python discogs-sync.py auth python discogs-sync.py auth --mode token OAuth 1.0a — full OAuth flow with consumer key/secret, for apps that need delegated access. python discogs-sync.py auth --mode oauth Credentials are stored in ~/.discogs-sync/config.json. # Verify authentication python discogs-sync.py whoami python discogs-sync.py whoami --output-format json ### Wantlist — Add, Remove, List # Add by artist/album name python discogs-sync.py wantlist add --artist "Radiohead" --album "OK Computer" [--format Vinyl] # Add by Discogs master ID (resolves to main release, or filters by --format) python discogs-sync.py wantlist add --master-id 3425 # Add by specific release ID python discogs-sync.py wantlist add --release-id 7890 # Remove by artist/album name python discogs-sync.py wantlist remove --artist "Radiohead" --album "OK Computer" # Remove by release ID python discogs-sync.py wantlist remove --release-id 7890 # List current wantlist python discogs-sync.py wantlist list [--search "QUERY"] [--format Vinyl] [--year 1997] [--no-cache] [--output-format json] Duplicate check: skips if the release is already in the wantlist (by release_id, master_id, or fuzzy artist+title match). ### Collection — Add, Remove, List # Add by artist/album name python discogs-sync.py collection add --artist "Miles Davis" --album "Kind of Blue" [--format Vinyl] # Add by master ID or release ID python discogs-sync.py collection add --master-id 3425 [--folder-id 1] python discogs-sync.py collection add --release-id 7890 [--folder-id 1] # Add a second copy of something already owned python discogs-sync.py collection add --release-id 7890 --allow-duplicate # Remove by artist/album name python discogs-sync.py collection remove --artist "Miles Davis" --album "Kind of Blue" # Remove by release ID python discogs-sync.py collection remove --release-id 7890 # List collection (all folders) python discogs-sync.py collection list [--search "QUERY"] [--format CD] [--year 1959] [--folder-id 0] [--no-cache] [--output-format json] Duplicate check: by default, add skips if the release is already in the collection (by release_id, master_id, or fuzzy artist+title match). Use --allow-duplicate to add another copy. ### Marketplace — Search Pricing # Search by artist/album name python discogs-sync.py marketplace search --artist "Radiohead" --album "OK Computer" [--format Vinyl] [--country US] [--output-format json] # Search by master ID python discogs-sync.py marketplace search --master-id 3425 [--format Vinyl] [--country US] # Search by specific release ID (skips master version scan) python discogs-sync.py marketplace search --release-id 7890 # Filter by price range and country python discogs-sync.py marketplace search --artist "Pink Floyd" --album "The Dark Side of the Moon" --format Vinyl --country US --min-price 10 --max-price 50 --currency USD # Show detailed progress and condition grade price suggestions python discogs-sync.py marketplace search --artist "Radiohead" --album "OK Computer" --verbose --details Returns release versions sorted by lowest price, with number of copies for sale. Single-item results are cached for 1 hour by lookup parameters. With --details, a separate details cache entry is used; if only the base cache is warm the tool fetches just the condition-grade price suggestions rather than re-running the full search. Pass --no-cache to force a live fetch (result is still written to cache). ### Bulk Operations via File For batch operations, pass a CSV or JSON file instead of individual --artist/--album flags. # Sync wantlist from file (preview first with --dry-run) python discogs-sync.py wantlist sync albums.csv --dry-run python discogs-sync.py wantlist sync albums.csv [--remove-extras] [--threshold 0.7] [--output-format json] # Sync collection from file python discogs-sync.py collection sync albums.csv [--folder-id 1] [--remove-extras] [--dry-run] # Batch marketplace search from file python discogs-sync.py marketplace search albums.csv [--format Vinyl] [--country US] [--max-price 50] [--max-versions 25] [--output-format json] CSV format (header row required, artist and album required): artist,album,format,year,notes Radiohead,OK Computer,Vinyl,,Must have Miles Davis,Kind of Blue,,1959,Original pressing Nirvana,Nevermind,CD,1991, JSON format (array of objects with the same fields): [ {"artist": "Radiohead", "album": "OK Computer", "format": "Vinyl"}, {"artist": "Miles Davis", "album": "Kind of Blue", "year": 1959} ] Format synonyms are normalized automatically: LP/record/12" → Vinyl, compact disc → CD, tape/mc → Cassette. ### Options OptionApplies ToDescription--output-formatAlltable (default) or json for machine-readable output--thresholdadd, remove, search, syncMatch score threshold 0.0–1.0 (default: 0.7)--formatadd, list, marketplace searchFilter by format: Vinyl, CD, Cassette (synonyms like LP, record are normalized)--yearlistFilter by release year (exact match)--folder-idcollectionTarget folder (default: 1 for adds, 0 for reads)--allow-duplicatecollection addAllow adding another copy of an album already in collection--countrymarketplace searchFilter by country of pressing (exact match: US, UK, Germany, etc.)--release-idmarketplace searchFetch stats for a specific release (bypasses master version scan)--min-pricemarketplaceMinimum price filter--max-pricemarketplaceMaximum price filter--currencymarketplaceCurrency code (default: USD)--max-versionsmarketplaceMax release versions to check per master (default: 25)--detailsmarketplace searchInclude suggested prices by condition grade--no-cachelist, marketplace searchBypass local cache; fresh results are still written back to cache--verbosesync, marketplace searchShow detailed progress and API call logging--searchlistFilter results by artist or title (case-insensitive substring match)--dry-runsyncPreview changes without modifying Discogs--remove-extrassyncRemove wantlist/collection items not in the input file ### Text (Default) wantlist list / collection list: Wantlist ┌────────────┬───────────┬─────────────┬─────────────┬────────┬──────┐ │ Release ID │ Master ID │ Artist │ Title │ Format │ Year │ ├────────────┼───────────┼─────────────┼─────────────┼────────┼──────┤ │ 7890 │ 3425 │ Radiohead │ OK Computer │ Vinyl │ 1997 │ │ 1234 │ 1000 │ Miles Davis │ Kind of Blue│ Vinyl │ 1959 │ └────────────┴───────────┴─────────────┴─────────────┴────────┴──────┘ Total: 2 marketplace search: Marketplace Results ┌───────────┬────────────┬───────────┬─────────────┬────────┬──────────┬──────────────┐ │ Master ID │ Release ID │ Artist │ Title │ Format │ For Sale │ Lowest Price │ ├───────────┼────────────┼───────────┼─────────────┼────────┼──────────┼──────────────┤ │ 3425 │ 7890 │ Radiohead │ OK Computer │ Vinyl │ 42 │ 25.99 USD │ │ 3425 │ 15432 │ Radiohead │ OK Computer │ Vinyl │ 18 │ 32.50 USD │ └───────────┴────────────┴───────────┴─────────────┴────────┴──────────┴──────────────┘ add / remove result: Sync Report Total input: 1 Added: 1 Removed: 0 Skipped: 0 Errors: 0 ### JSON (--output-format json) wantlist list / collection list: { "items": [ { "release_id": 7890, "master_id": 3425, "title": "OK Computer", "artist": "Radiohead", "format": "Vinyl", "year": 1997 } ], "total": 1 } marketplace search: { "results": [ { "master_id": 3425, "release_id": 7890, "title": "OK Computer", "artist": "Radiohead", "format": "Vinyl", "country": "US", "year": 1997, "num_for_sale": 42, "lowest_price": 25.99, "currency": "USD" } ], "total": 1 } add / remove / sync report: { "summary": { "total_input": 1, "added": 1, "removed": 0, "skipped": 0, "errors": 0 }, "actions": [ { "action": "add", "artist": "Radiohead", "title": "OK Computer", "release_id": 7890, "master_id": 3425, "reason": null, "error": null } ] } ### Output Fields release_id — Unique Discogs release identifier master_id — Discogs master release identifier (groups all versions of an album) title — Album title artist — Artist name format — Physical format (Vinyl, CD, Cassette, etc.) year — Release year country — Country of release num_for_sale — Number of copies currently for sale on the marketplace lowest_price — Lowest listed price for the release currency — Price currency code instance_id — Collection-specific instance identifier (for duplicate copies) folder_id — Collection folder identifier action — Sync action taken: add, remove, skip, or error ### Release Matching When using --artist and --album, the tool runs a multi-pass search to find the best Discogs match: Structured search — artist, album, format, and year Relaxed search — drops format and year constraints Free text search — searches "artist album" as plain text Each result is scored 0.0–1.0: 40% artist similarity + 40% title similarity + 10% year match + 10% format match. Results below --threshold (default 0.7) are rejected. Lower the threshold for fuzzy matches. When using --master-id or --release-id, no search is needed — the ID is used directly. ### Exit Codes 0 — Success (all items processed) 1 — Partial failure (some items failed) 2 — Complete failure (no items processed, or auth/config error) ### Notes Authentication supports personal access tokens (default) and OAuth 1.0a. Run python discogs-sync.py auth once. The Discogs API is rate-limited to 60 requests/minute for authenticated users. The tool throttles automatically — no manual pacing needed. Batch operations are resilient: individual item failures are collected and reported without aborting the entire batch. Use --dry-run before any sync to preview what would change. This makes no API writes. The --remove-extras flag on sync commands will remove items from your wantlist/collection that are not in the input file. Use with caution. Collection allows multiple instances of the same release (e.g., two copies of the same LP). By default, collection add skips duplicates with a message. Use --allow-duplicate to add another copy. Cache files are stored in ~/.discogs-sync/ alongside config.json: wantlist_cache.json, collection_cache.json, and marketplace__.json (plus …_details.json variants). Delete any of these files to manually clear a stale cache entry. Credentials in ~/.discogs-sync/config.json contain your Discogs tokens. On Linux/macOS, restrict permissions: chmod 600 ~/.discogs-sync/config.json. Revoke tokens at https://www.discogs.com/settings/developers if compromised. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: khaney64 - Version: 0.1.9 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-02T14:14:38.919Z - Expires at: 2026-05-09T14:14:38.919Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/discogs-sync) - [Send to Agent page](https://openagent3.xyz/skills/discogs-sync/agent) - [JSON manifest](https://openagent3.xyz/skills/discogs-sync/agent.json) - [Markdown brief](https://openagent3.xyz/skills/discogs-sync/agent.md) - [Download page](https://openagent3.xyz/downloads/discogs-sync)