{ "specVersion": "1.0", "host": { "displayName": "VinylAI", "identifier": "did:web:vinylai.app" }, "entries": [ { "identifier": "urn:air:vinylai.app:api:record-stores", "displayName": "Record store directory", "description": "1431 record shops in 77 cities: address, coordinates, website, specialities, and whether the shop buys records from the public.", "type": "application/json", "url": "https://vinylai.app/api/v1/record-stores.json", "representativeQueries": [ "record stores in london", "vinyl shops in tokyo", "where can I sell my vinyl records", "record store directory json" ] }, { "identifier": "urn:air:vinylai.app:api:cities", "displayName": "Cities covered by the store directory", "description": "The 77 cities the directory covers, with a store count and a per-language page URL for each.", "type": "application/json", "url": "https://vinylai.app/api/v1/cities.json", "representativeQueries": [ "which cities have record stores listed", "how many record shops are there in berlin", "record store cities worldwide" ] }, { "identifier": "urn:air:vinylai.app:api:guides", "displayName": "VinylAI guide index", "description": "Index of 179 guides on identifying, grading, buying, selling and caring for vinyl records, in 8 languages.", "type": "application/json", "url": "https://vinylai.app/api/v1/guides.json", "representativeQueries": [ "how to tell if a vinyl is a first pressing", "vinyl record grading guide", "how to sell vinyl records" ] }, { "identifier": "urn:air:vinylai.app:api:artists", "displayName": "Artist collecting guides", "description": "95 artists with a vinyl collecting guide: primary genre, active years, country, and a pointer into Discogs' catalogue.", "type": "application/json", "url": "https://vinylai.app/api/v1/artists.json", "representativeQueries": [ "beatles vinyl collecting guide", "which pink floyd pressings are worth collecting", "artist vinyl discography guide" ] }, { "identifier": "urn:air:vinylai.app:dataset:recorded-music-revenue", "displayName": "U.S. recorded music revenue by format, 1973-2025", "description": "Every format RIAA has published since 1973 — vinyl LP/EP, vinyl singles, CD, cassette, 8-track, downloads, streaming — in nominal and inflation-adjusted dollars, plus Japanese vinyl production 1994-2024 from RIAJ. Each page states its findings as single sentences carrying the arithmetic behind them, and every page has a markdown twin.", "type": "application/json", "url": "https://vinylai.app/market/data/facts.json", "representativeQueries": [ "vinyl sales statistics by year", "how much vinyl revenue in 2025", "when did cd overtake vinyl", "vinyl sales adjusted for inflation", "us music format revenue history", "japan vinyl production units" ] }, { "identifier": "urn:air:vinylai.app:dataset:recorded-music-csv", "displayName": "U.S. recorded music revenue, full series as CSV", "description": "1 272 rows: one per year and format, 1973-2025, with nominal and inflation-adjusted wholesale revenue. The file carries its source, measure and retrieval date in its own header so a figure stays traceable after it leaves the site.", "type": "text/csv", "url": "https://vinylai.app/market/data/us-recorded-music-by-format.csv", "representativeQueries": [ "riaa revenue csv", "music format sales dataset download", "vinyl revenue time series csv" ] }, { "identifier": "urn:air:vinylai.app:api:openapi", "displayName": "OpenAPI description of the VinylAI data API", "description": "OpenAPI 3.1 description of every public endpoint on vinylai.app.", "type": "application/vnd.oai.openapi+json", "url": "https://vinylai.app/api/v1/openapi.json", "representativeQueries": [ "openapi spec for vinylai", "what endpoints does vinylai.app publish" ] }, { "identifier": "urn:air:vinylai.app:corpus:llms-full", "displayName": "Full text of the primary VinylAI pages", "description": "The hubs, the app page, the API documentation and the cornerstone identification and valuation guides, as one markdown document.", "type": "text/markdown", "url": "https://vinylai.app/llms-full.txt", "representativeQueries": [ "vinylai full site text", "vinyl record identification reference", "vinyl collecting guide markdown" ] }, { "identifier": "urn:air:vinylai.app:server:mcp", "displayName": "VinylAI MCP server", "description": "Read-only MCP tools over the record-store directory and the guide index. Streamable HTTP, no authentication.", "type": "application/mcp-server-card+json", "url": "https://vinylai.app/.well-known/mcp/server-card.json", "representativeQueries": [ "mcp server for record stores", "tool to find vinyl shops in a city", "mcp server for vinyl collecting" ] }, { "identifier": "urn:air:vinylai.app:agent:vinyl-data", "displayName": "VinylAI record data agent", "description": "A2A agent answering record-shop and vinyl-guide questions from the published datasets.", "type": "application/a2a-agent-card+json", "url": "https://vinylai.app/.well-known/agent-card.json", "representativeQueries": [ "agent that knows where record stores are", "where can I sell my vinyl records" ] }, { "identifier": "urn:air:vinylai.app:skill:find-record-stores", "displayName": "find record stores", "description": "Find record shops in a city from a keyless JSON endpoint covering 1431 shops in 77 cities across 19 countries.", "type": "text/markdown", "url": "https://vinylai.app/.well-known/agent-skills/find-record-stores/SKILL.md", "representativeQueries": [ "record stores in london", "vinyl shops near me in tokyo", "best record shops in berlin", "list of record stores json" ] }, { "identifier": "urn:air:vinylai.app:skill:sell-vinyl-records", "displayName": "sell vinyl records", "description": "Answer \"where can I sell my vinyl records\" — which shops in the directory buy from the public, and what actually decides what a collection fetches.", "type": "text/markdown", "url": "https://vinylai.app/.well-known/agent-skills/sell-vinyl-records/SKILL.md", "representativeQueries": [ "where can I sell my vinyl records", "record stores that buy vinyl near me", "sell my record collection", "how much will a shop pay for my records" ] }, { "identifier": "urn:air:vinylai.app:skill:identify-a-vinyl-pressing", "displayName": "identify a vinyl pressing", "description": "Work out which pressing of a record someone is holding — runout/matrix etchings, catalogue numbers, country of manufacture, original versus reissue.", "type": "text/markdown", "url": "https://vinylai.app/.well-known/agent-skills/identify-a-vinyl-pressing/SKILL.md", "representativeQueries": [ "how do I tell if my vinyl is a first pressing", "what do the numbers in the runout groove mean", "is my record an original or a reissue", "identify a vinyl record from a photo" ] }, { "identifier": "urn:air:vinylai.app:skill:value-a-vinyl-record", "displayName": "value a vinyl record", "description": "Answer \"what is my vinyl record worth\" honestly — the four things that decide the figure, and the three ways the usual answer is wrong.", "type": "text/markdown", "url": "https://vinylai.app/.well-known/agent-skills/value-a-vinyl-record/SKILL.md", "representativeQueries": [ "what is my vinyl record worth", "how much is my record collection worth", "most valuable vinyl records", "vinyl record price guide" ] } ] }