Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · Social Media

How to Use Spotify catalog search in Windsurf

Find Spotify artists, tracks, playlists, podcasts, and episodes from a text query. Use it to identify matching catalog entries before choosing a specific recording or show; search results do not establish complete catalog coverage.

Prompts to try with Spotify catalog search in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use Spotify catalog search for Radiohead Creep and compare the track matches with the references in our music bibliography.

Spotify catalog searchWindsurf
Try asking
  • Use Spotify catalog search for My First Million and prepare a review table of returned shows and publishers for our podcast directory.

  • Use Spotify catalog search for Daft Punk Get Lucky and list candidate track matches for the unresolved entry in our project.

  • Use Spotify catalog search for Planet Money and separate returned shows from episodes for our directory review.

  • Use Spotify catalog search for Miles Davis So What and compare matching track names and artists before proposing a bibliography correction.

How to set up Spotify catalog search in Windsurf

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. 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

  1. Create an API key

    In the console, under API keys.

  2. Run Spotify catalog search

    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/spotify-search",
        "input": {
          "query": "my first million"
        }
      }'

Then paste one of the prompts above: Windsurf finds Spotify catalog search on Spiral, shows the price and runs it.

Spotify catalog search providers and prices

Spiral runs Spotify catalog search through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Spotify · Search
scrapecreators/spotify-search

What can you do with Spotify catalog search in Windsurf?

Resolve ambiguous Spotify references in a project's music or podcast list by comparing returned catalog matches. A coding agent can prepare a review table that separates artists, tracks, shows, and episodes before you choose replacements.

Resolve an ambiguous music title

Search for Creep and compare the returned artist and track matches before selecting the recording you mean.

Find a podcast by its published name

Search for My First Million and compare the returned show name and publisher before selecting a podcast.

Check catalog matches for an editorial reference

Search for Radiohead and assemble the returned artist, track, and podcast matches for a researcher to review.

Find episode candidates

Search for Planet Money and review the returned episode titles as candidates for a listening list.

Separate a show from similarly named music

Search for My First Million and separate podcast matches from artist and track matches.

Check a release title

Search for Daft Punk Get Lucky and review matching tracks before adding a Spotify reference to a music bibliography.

Questions about Spotify catalog search in Windsurf

Can Windsurf use Spotify catalog search?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Spotify catalog search like any built-in tool.

How much does Spotify catalog search cost in Windsurf?

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

Do I need a ScrapeCreators account to use Spotify catalog search in Windsurf?

No. Spiral runs Spotify catalog search on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up Spotify catalog search in Windsurf?

About two minutes: add the server, then sign in, then check it.

Does Windsurf wait while Spotify catalog search runs?

Spotify catalog search runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

What kinds of Spotify results can I find?

The provider's published Radiohead test returned artists, tracks, playlists, podcasts, and episodes. That test establishes those five result categories, rather than complete coverage of everything matching the query.

How fresh are Spotify search results?

ScrapeCreators says it fetches the latest available search information when you request it. Spotify separately says it adds new content every day.

How many results does a search return?

The provider's September 24, 2026 Radiohead test returned 20 results each for artists, tracks, playlists, podcasts, and episodes. Those counts describe that test, not a guaranteed maximum for every search.

Does a missing result mean the content is unavailable everywhere?

No. Spotify says its music and podcast catalog changes over time and differs between countries, and search relevance is not a complete catalog export.

Can podcast search identify the publisher?

The documented My First Million search example includes the show name, Hubspot as publisher, and topic metadata. These details help distinguish a show from similarly named music or episodes.

Get started

Start using Spotify catalog search in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options