How to Use Apple Music catalog search results in opencode
Returns public Apple Music search matches for songs, artists, albums, playlists, and other music content. Use it to discover catalog entries by name; the documented song results include IDs, titles, artist names, links, and durations.
Prompts to try with Apple Music catalog search results in opencode
Copy an example into opencode, or ask in your own words.
Use Apple Music catalog search results to search for Radiohead No Surprises, then add the returned song candidates to our project's review screen with their IDs, titles, artists, links, and durations.
Use Apple Music catalog search results to search for Blue Moon as songs and build a comparison table in the project showing each returned title, artist, and duration.
Use Apple Music catalog search results to find Daft Punk songs and add a filter to our existing results component for returned tracks shorter than four minutes.
Use Apple Music catalog search results to find Kendrick Lamar albums and populate our existing catalog review page with the returned matches.
Use Apple Music catalog search results to find jazz piano playlists and display the returned matches in our project's playlist review view.
How to set up Apple Music catalog search results in opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Apple Music catalog search results
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "scrapecreators", "model": "scrapecreators/apple-music-search", "input": { "query": "taylor swift" } }'
Then paste one of the prompts above: opencode finds Apple Music catalog search results on Spiral, shows the price and runs it.
Apple Music catalog search results providers and prices
Spiral runs Apple Music catalog search results through ScrapeCreators. Open a card for today's price, with every fee included.
What can you do with Apple Music catalog search results in opencode?
Build a song matching feature that turns artist and title text into reviewable Apple Music links. A coding agent can work with returned song IDs, artist names, and durations to help resolve ambiguous matches.
Match a music reference to a catalog entry
Search a song title together with its artist, then compare returned titles, artist names, and durations to select the intended Apple Music link.
Prepare links for a music article
Find Apple Music entries for the artists, albums, and songs mentioned in a draft. Build a review list of matching catalog results before adding links.
Compare recordings with the same title
Search a title such as Blue Moon and compare the returned song titles, artists, and durations to distinguish candidate recordings.
Find playlists for a listening brief
Search for public playlists around a term such as jazz piano or workout. Use the matches as candidates for a human listening review.
Locate music videos
Search for music videos associated with a public artist such as Beyoncé. Collect the returned matches for an editorial viewing shortlist.
Build a shortlist by song length
Search for songs by an artist such as Daft Punk and filter the returned matches by duration. Keep the selection limited to the results actually returned.
Review changes in search matches
Where authorized under Apple's terms, repeat a fixed artist or title search and compare returned catalog IDs. Report additions to the search results without labeling them newly released music.
More on Apple Music catalog search results and opencode
Apple Music catalog search results in other agents
Questions about Apple Music catalog search results in opencode
Can opencode use Apple Music catalog search results?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Apple Music catalog search results like any built-in tool.
How much does Apple Music catalog search results cost in opencode?
$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.
Do I need a ScrapeCreators account to use Apple Music catalog search results in opencode?
No. Spiral runs Apple Music catalog search results on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.
How long does it take to set up Apple Music catalog search results in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while Apple Music catalog search results runs?
Apple Music catalog search results runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.
What information comes back for a song?
The documented example includes the song's ID, title, artist name, Apple Music link, content kind, and duration in milliseconds. It shows a duration of 226000 milliseconds, or 3 minutes 46 seconds.
How fresh are Apple Music search results?
ScrapeCreators says it fetches the latest available Apple Music information when you make a request. That describes retrieval freshness, rather than a guaranteed delay between a catalog change and its appearance in search.
Can this search access someone's private music library?
ScrapeCreators documents public data extraction only. This search is for public Apple Music catalog content, so private libraries and listening histories fall outside that coverage.
Does an Apple Music result establish worldwide availability?
No. Apple says its web services and features vary by country or region, so a search match does not establish availability everywhere.
Are Apple Music search matches guaranteed to be accurate?
ScrapeCreators explicitly disclaims guarantees of data accuracy and availability. For song matching, compare the returned title, artist name, and duration before accepting a result.
Start using Apple Music catalog search results in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


