[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [Openverse audio search](https://spiral.ai/integrations/muse-code/openverse-audio-search)

# How to Use Openverse audio search in Muse Code

Openverse audio search returns matching recordings with creator, license, attribution, and file metadata. Use it to build a shortlist from a sound description or music brief before inspecting individual tracks.

|  |  |
| --- | --- |
| Model | Openverse audio search |
| Available through | Alexandria |
| Category | News & Media |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Openverse audio search in Muse Code

- Use Openverse audio search to find ocean waves for the beach scene in this project. Add a shortlist with titles, creators, source pages, and listed licenses to docs/audio-candidates.md.
- Use Openverse audio search to find wooden door creaks for this game prototype. Build a review table from the returned recording metadata.
- Use Openverse audio search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Openverse audio search and tell me what changed since last week.
- Check Openverse audio search and summarize what you find in three bullet points.

## How to set up Openverse audio search in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Openverse audio search**: One request; the result comes back by polling or a webhook.

```bash
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": "openverse-org/audio-assets/search_audio",
    "input": {
      "url": "<url>"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds Openverse audio search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## Openverse audio search tools and prices

- [Openverse · Search audio](https://spiral.ai/tools/alexandria/openverse-org/audio-assets/search_audio) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | An openverse.org/search/audio?q=... or api.openverse.org/v1/audio/?q=... URL; its q, license, license_type, source, category, length and extension fill any filter not given. |
| limit | 1 to 20 | — | Results per page; default 10. Anonymous access allows at most 20. |
| query |  | — | Words to search titles, tags and descriptions, e.g. rain on window. |
| length |  | — | Keep only these lengths: shortest (under 30 s), short (30 s to 2 min), medium (2 to 10 min), long (over 10 min). |
| source |  | — | Keep only these collections (names from list_sources): freesound for sound effects and samples, jamendo for music, wikimedia_audio for Wikimedia Commons. |
| license |  | — | Keep only these licences. |

## What can you do with Openverse audio search in Muse Code?

Build an audio candidate list for your project with recording links, creators, and draft credits. A coding agent can turn Openverse records into a review screen or an asset manifest tied to the scenes that need sound.

### Build a podcast sound shortlist

Compare indexed collections, search for rain and station ambience, explore suggestions from a promising recording, and inspect the selected clips’ source links and attribution for production review.

### Choose sounds for a game prototype

Review available collections, find footsteps and door sounds, explore related recordings, and assemble a candidate list with file links, creators, and licenses for review.

### Prepare audio for a classroom lesson

Compare collection coverage, search for birdsong and ocean recordings, inspect related suggestions, and prepare a listening list with original source pages and draft credits.

### Research a documentary sound palette

Review indexed collections, search for train and harbor sounds, explore alternatives from selected tracks, and inspect recording metadata before sending candidates to an editor.

### Find replacement audio candidates

Explore suggestions from a previously selected track and run a fresh descriptive search. Inspect each candidate’s source and license before approving a replacement.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## Openverse audio search in other agents

- [Amp](https://spiral.ai/integrations/amp/openverse-audio-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/openverse-audio-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/openverse-audio-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/openverse-audio-search)
- [Cline](https://spiral.ai/integrations/cline/openverse-audio-search)
- [Codex](https://spiral.ai/integrations/codex/openverse-audio-search)
- [Cursor](https://spiral.ai/integrations/cursor/openverse-audio-search)
- [Devin](https://spiral.ai/integrations/devin/openverse-audio-search)
- [dots](https://spiral.ai/integrations/dots/openverse-audio-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/openverse-audio-search)
- [Gemini](https://spiral.ai/integrations/gemini/openverse-audio-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/openverse-audio-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/openverse-audio-search)
- [goose](https://spiral.ai/integrations/goose/openverse-audio-search)
- [Grok](https://spiral.ai/integrations/grok/openverse-audio-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/openverse-audio-search)
- [Hermes](https://spiral.ai/integrations/hermes/openverse-audio-search)
- [Instinct](https://spiral.ai/integrations/instinct/openverse-audio-search)
- [Manus](https://spiral.ai/integrations/manus/openverse-audio-search)
- [Muse](https://spiral.ai/integrations/muse/openverse-audio-search)
- [n8n](https://spiral.ai/integrations/n8n/openverse-audio-search)
- [Notion](https://spiral.ai/integrations/notion/openverse-audio-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/openverse-audio-search)
- [opencode](https://spiral.ai/integrations/opencode/openverse-audio-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/openverse-audio-search)
- [Raycast](https://spiral.ai/integrations/raycast/openverse-audio-search)
- [VS Code](https://spiral.ai/integrations/vscode/openverse-audio-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/openverse-audio-search)
- [Zapier](https://spiral.ai/integrations/zapier/openverse-audio-search)

## More Muse Code guides

- [Openverse audio details](https://spiral.ai/integrations/muse-code/openverse-audio-details)
- [Openverse audio sources](https://spiral.ai/integrations/muse-code/openverse-audio-sources)
- [New Hampshire Bulletin news search](https://spiral.ai/integrations/muse-code/new-hampshire-bulletin-news-search)
- [Openverse related audio](https://spiral.ai/integrations/muse-code/openverse-related-audio)
- [New Hampshire Bulletin latest news](https://spiral.ai/integrations/muse-code/new-hampshire-bulletin-latest-news)
- [Poly Haven asset categories](https://spiral.ai/integrations/muse-code/poly-haven-asset-categories)

## Questions about Openverse audio search in Muse Code

**Can Muse Code use Openverse audio search?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run Openverse audio search like any built-in tool.

**How much does Openverse audio search cost in Muse Code?**

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

**Do I need an Alexandria account to use Openverse audio search in Muse Code?**

No. Spiral runs Openverse audio 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 Openverse audio search in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while Openverse audio search runs?**

Openverse audio search runs in the background. Muse Code starts the run, checks on it and gives you the json when it's ready.

**Does Openverse host the original recordings?**

Openverse aggregates metadata for recordings hosted on third-party websites. Its audio records include the original landing page and a file URL.

**Does an Openverse listing prove that I can reuse a recording?**

No. Openverse explicitly says it does not verify licensing status, so the listed license must be checked against the original source before reuse.

**What do the collection totals measure?**

They count media items indexed by Openverse from each source. They are catalog counts, so they do not establish the complete size of a source website’s audio collection.

**Can I copy the entire catalog through repeated requests?**

Openverse’s terms prohibit scraping the catalog. Use the data to find and inspect recordings for a specific project.

**Does the timestamp tell me when a recording was published?**

The indexing timestamp tells you when Openverse indexed the media. It does not establish the recording’s original publication date.

