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

Hermes · Social Media

How to Use SoundCloud search in Hermes

Returns matching SoundCloud creators, tracks, playlists, or albums. Use it when you have a name or keyword and need to discover the right public record before inspecting its details.

Prompts to try with SoundCloud search in Hermes

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

Every Monday at 9am: use SoundCloud search to look this up and give me the result as a table.

SoundCloud searchHermes
Try asking
  • Pull the latest numbers from SoundCloud search and tell me what changed since last week.

  • Check SoundCloud search and summarize what you find in three bullet points.

  • Pull the newest data from SoundCloud search and give me the result as a table.

  • Check SoundCloud search every morning and tell me only when something changed.

How to set up SoundCloud search in Hermes

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

Use the Spiral skill

  1. Send Hermes 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 Spiral's MCP server

  1. Add the server and sign in

    Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

    hermes mcp add spiral \
      --url https://api.spiral.ai/mcp \
      --auth oauth \
      --connect-timeout 300
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

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 SoundCloud 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": "alexandria",
        "model": "soundcloud-com/profiles/search",
        "input": {
          "query": "<query>"
        }
      }'

Then paste one of the prompts above: Hermes finds SoundCloud search on Spiral, shows the price and runs it.

SoundCloud search providers and prices

Spiral runs SoundCloud search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaSocial Media
SoundCloud · Search
soundcloud-com/profiles/search

Settings you can ask for

Ask Hermes for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Typeall, users, tracks, playlists, or albumsall

all: mixed users, tracks and sets with per-type facet counts. users, tracks, playlists, albums: one type.

Limit1 to 5020

Page size, 1..50 (default 20).

Every API field of SoundCloud · Search is on its tool page: open its card above.

What can you do with SoundCloud search in Hermes?

Produce recurring SoundCloud catalog reports for a public artist or label. Compare returned releases, collection contents, and public counters with the previous report.

Artist research brief

Resolve an artist’s name, identify the public profile, and assemble a brief covering releases, curated collections, public activity, professional connections, and track response.

Label catalog review

Resolve roster names and compare public artist profiles, uploads, albums, and playlist contents to prepare a catalog review.

Editorial listening shortlist

Find artists and releases, inspect their collections, and use public curation, professional connections, and track feedback to build a listening shortlist with source links.

Public music network research

Resolve public artist and label names, inspect their profiles and following relationships, and review shared music to identify professional connections worth researching.

Playlist curation research

Resolve remembered names, find candidate tracks, inspect existing playlist contents, and explore public artist curation, professional connections, and related-track recommendations.

Internal music research workspace

Bring name discovery, public profiles, catalogs, collection contents, curation, professional connections, and track response into one internal research workspace.

Questions about SoundCloud search in Hermes

Can Hermes use SoundCloud search?

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

How much does SoundCloud search cost in Hermes?

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.

Do I need an Alexandria account to use SoundCloud search in Hermes?

No. Spiral runs SoundCloud search on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up SoundCloud search in Hermes?

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

Does Hermes wait while SoundCloud search runs?

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

Does public SoundCloud data include private tracks?

Private tracks do not appear on public profiles and cannot be found through SoundCloud search. Public likes, reposts, comments, and follows have a different visibility boundary.

How quickly do profile changes become searchable?

SoundCloud says a new display name or profile URL becomes searchable immediately within SoundCloud. Google search can take longer to reflect the change.

How large can a SoundCloud playlist be?

SoundCloud enforces a 500-track limit per playlist.

What is the difference between albums and playlists?

SoundCloud describes albums as collections of tracks released as albums. Playlists are curated track lists from creators or fans.

Which profile interactions are public?

SoundCloud says likes, reposts, comments, and follows are always public. Making uploads private does not make those interactions private.

Get started

Start using SoundCloud search in Hermes

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

Paste this into Hermes:

Set up Hermes

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