music-release-landscape

Map artist discographies and comparable music releases through Crawlora Spotify artist, album, and track tools. Use for a release-cohort or catalog-positioning brief with artist/recording identity, release types, date precision, editions, and public-metric limits preserved.

Access and scope

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the listed Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact methods and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound calls/pages by the requested scope and credit budget. Retain source IDs, URLs, source dates, and observation/crawl times separately.

Compare public catalog releases for a specified artist/cohort, genre/topic, release window, and album/single/appearance scope. Use supplied artists first; search/related results are discovery leads rather than a complete scene or genre census.

Resolve catalog identities and release types

1. Search artists and verify returned artist ID/URI, credited names, profile URL, and selected releases. Artist, album, track, and profile IDs/URIs are separate namespaces. Name similarity, related-artist suggestions, or shared playlist placement do not establish collaboration, label ownership, or creative influence.
2. Retrieve artist discography with explicit type (album, single, compilation, appears_on, all) and order, plus bounded offset/limit. Featured appearances and compilation credits are not the artist's own primary releases. Selected overview discography is not automatically the full archive.
3. Resolve selected albums and track lists with returned IDs/URIs. Preserve title, credited artists, release type, supplied date/date precision, label/identifiers when present, track sequence, duration units, edition/version cues, and sources. An artist/album lookup needs an identifier even when schema fields are optional.
4. Group duplicate/variant releases only with recording/edition evidence. Use an actual returned recording identifier when available, otherwise documented credits/duration/release corroboration; equal titles alone are insufficient. Originals, deluxe editions, remasters, live versions, clean/explicit versions, translations, and territorial releases can be distinct catalog objects.

sh

scripts/crawlora.sh /spotify/artists/search q="jazz trio" limit=5
scripts/crawlora.sh /spotify/albums/search q="jazz trio" limit=5
# Use verified returned artist IDs/URIs before discography:
# scripts/crawlora.sh /spotify/artist/albums id="$ARTIST_ID" type=all order=date_desc limit=20 offset=0

Compare catalog structure and observed positioning

Build a release-by-type/theme/format matrix from available catalog metadata, keeping primary releases versus appearances and unique recordings versus edition counts separate. Preserve year-only/month-only date precision; do not invent an exact date or chronological order among ambiguous releases. Duration is not listening time or streaming revenue. No guaranteed transcript/lyric/full-audio analysis is provided here, so do not invent musical or lyrical claims from a title.

Public popularity, play/listener fields, recommendations, or charts may have different scopes and dates. Report only supplied fields with attribution, and do not sum duplicate-recording metrics, infer historical momentum from a single snapshot, or treat a rank as audited streams/revenue. These routes do not supply a complete time-series of royalties, sales, listeners, or market availability. Return identity/grouping and date/coverage ledgers, the catalog matrix, sourced positioning hypotheses, and unknowns. Do not reproduce copyrighted songs, download restricted audio, contact artists, or alter playlists/accounts from this task.