Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Developer Tools
Discogs Sync
Add and remove albums from a Discogs wantlist or collection by artist and album name, master ID, or release ID. Search marketplace pricing for vinyl, CD, and...
skill openclawclawhub Free
Add and remove albums from a Discogs wantlist or collection by artist and album name, master ID, or release ID. Search marketplace pricing for vinyl, CD, and...
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md, discogs-sync.py, requirements.txt, src/discogs_sync/__init__.py, src/discogs_sync/auth.py, src/discogs_sync/cache.py
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- 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.
New install
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
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.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 0.1.9
Provenance
- Publisher
- khaney64
- Source page
- View original listing
- Canonical URL
- Open canonical page
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_<type>_<hash>.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.
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
4 Scripts1 Docs1 Files
- SKILL.md
- discogs-sync.py
- src/discogs_sync/__init__.py
- src/discogs_sync/auth.py
- src/discogs_sync/cache.py
- requirements.txt