discogs-claw

What This Skill Does

The discogs-claw is a specialized agent skill designed to interface directly with the Discogs API, the premier global database for vinyl records. By leveraging the power of curl and jq, this skill performs real-time queries against the Discogs marketplace to retrieve current pricing metrics for specific vinyl releases. It extracts critical valuation data, specifically the Low, Median, and High price points, alongside live marketplace statistics such as the total number of listings and the absolute lowest price currently available. This tool acts as a bridge for collectors and enthusiasts to get instant financial snapshots of their music library without navigating through browser-based interfaces.

Installation

Installation is streamlined through the OpenClaw ecosystem. You can add this skill to your local agent environment by running the command: clawhub install openclaw/skills/skills/abreumatheus/discogs-claw. Once installed, you must provide your authentication credentials to access the Discogs API. You can either set the DISCOGS_TOKEN as an environment variable in your shell profile or create a configuration file at ~/.openclaw/credentials/discogs.json. Ensure your token has the necessary read-only permissions to query the database, keeping security best practices in mind by never sharing this token in public repositories.

Use Cases

This skill is perfect for vinyl collectors looking to appraise their current collection or verify the fair market value of a record before purchasing. It is particularly useful for users attempting to avoid price gouging in secondary markets. Additionally, developers can integrate this skill into larger automation workflows, such as generating automated reports on collection value or tracking price fluctuations of rare pressings over time. Its objective output format makes it ideal for piping into other analytical scripts.

Example Prompts

1. "Check the current market value for the vinyl release of Pink Floyd - The Dark Side of the Moon."
2. "What are the low, median, and high prices for Miles Davis - Kind of Blue on Discogs?"
3. "Run a price lookup for Daft Punk - Discovery and show me the number of active listings."

Tips & Limitations

To ensure optimal performance, provide specific artist and title information in your query to minimize ambiguity. Because the skill relies on live data, network connectivity is required for every request. Please note that the skill does not perform historical trend analysis; it provides a 'point-in-time' snapshot of the marketplace. Users should ensure their Discogs API token remains active to avoid 401 Unauthorized errors during execution.