[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [SoundBible sound search](https://spiral.ai/integrations/opencode/soundbible-sound-search)

# How to Use SoundBible sound search in opencode

Find SoundBible clips by keyword or tag, or browse the newest-first listing, with creator and license information. Use it to compare candidates for a scene before inspecting a selected sound.

|  |  |
| --- | --- |
| Model | SoundBible sound 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 SoundBible sound search in opencode

- Use SoundBible sound search to find public-domain wind effects for this project's outdoor scenes. Add a candidate table with descriptions, source links, and licenses to the audio planning document.
- Use SoundBible sound search for service bell effects for the shop scene in this game. List candidates with creator credits and license information in the project's cue sheet.
- Use SoundBible sound search for thunder effects for this project's storm scene. Produce a candidate manifest with descriptions and licenses, without inventing durations or sample rates.
- Use SoundBible sound search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from SoundBible sound search and tell me what changed since last week.

## How to set up SoundBible sound search in opencode

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

### Use Spiral's MCP server

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

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **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.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 SoundBible sound 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": "soundbible-com/sound-effects/search_sounds",
    "input": {
      "tag": "<tag>"
    }
  }'
```

Then paste one of the prompts above: opencode finds SoundBible sound search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## SoundBible sound search tools and prices

- [SoundBible · Search sounds](https://spiral.ai/tools/alexandria/soundbible-com/sound-effects/search_sounds) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| tag |  | — | A SoundBible tag such as dog-bark, fart, horn or crowd (spaces become hyphens). |
| url |  | — | A soundbible.com search, tags-<tag>.html, free-sound-effects-<n>.html or royalty-free-sounds-<n>.html URL. |
| page | 1 to 1000 | — | Listing page, 9 sounds each; default 1. |
| query |  | — | Keywords for SoundBible's search, e.g. dog bark, doorbell, thunder. The site returns up to about 30 matches on one page. |
| license | CC-BY-3.0, public-domain, CC-sampling-plus-1.0, CC-BY-NC-3.0, personal-use-only | — | Keep only sounds under this licence. Choosing CC-BY-NC-3.0 or personal-use-only implies include_restricted. |
| listing | free, royalty_free | — | Browse listing when no query or tag is given: free (all sounds, newest first; default) or royalty_free (the site's Creative Commons and public domain section). |

## What can you do with SoundBible sound search in opencode?

Build a game audio manifest with SoundBible descriptions, file links, licenses, and credits beside each cue. A coding agent can use that information to update the project's asset list and credits draft.

### Build a game sound cue sheet

Find candidates for doorbells, wind, and engine cues, then inspect selected clips for file links and credits. Keep each sound's license beside its intended game event.

### Plan a podcast scene

Compare airport and store sound effects for a scripted scene. Review each chosen sound's description and attribution before adding it to the production cue sheet.

### Prepare video sound credits

Find effects for a video's scenes, inspect their licenses, and assemble the supplied attribution lines into a credits draft.

### Choose effects for a classroom presentation

Find animal, weather, or transportation sounds for a lesson. Collect descriptions, source links, and creator credits for the selected clips.

### Replace unsuitable project audio

Inspect an existing SoundBible clip's license and search for another sound depicting the same event. Compare descriptions and licensing before proposing a replacement.

### Maintain a production sound shortlist

Gather candidates for recurring production needs and revisit selected sound records. Keep descriptions, licenses, credits, and file links together for the editor.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## SoundBible sound search in other agents

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

## More opencode guides

- [SoundBible sound details](https://spiral.ai/integrations/opencode/soundbible-sound-details)
- [Spaceflight News API item details](https://spiral.ai/integrations/opencode/spaceflight-news-api-item-details)
- [Sketchfab model search](https://spiral.ai/integrations/opencode/sketchfab-model-search)
- [Spaceflight News API launch coverage](https://spiral.ai/integrations/opencode/spaceflight-news-api-launch-coverage)
- [Sketchfab model details](https://spiral.ai/integrations/opencode/sketchfab-model-details)
- [Spaceflight News API topic news](https://spiral.ai/integrations/opencode/spaceflight-news-api-topic-news)

## Questions about SoundBible sound search in opencode

**Can opencode use SoundBible sound search?**

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

**How much does SoundBible sound search cost in opencode?**

$0.00873 per call. 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 an Alexandria account to use SoundBible sound search in opencode?**

No. Spiral runs SoundBible sound 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 SoundBible sound search in opencode?**

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

**Does opencode wait while SoundBible sound search runs?**

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

**How large is SoundBible's library, and which audio formats does it offer?**

SoundBible describes its library as containing thousands of sound effects. It offers clips in WAV and MP3 formats.

**How complete is a SoundBible keyword search?**

The source returns up to about 30 matches on one page, so a broad keyword search is a limited candidate list. Noncommercial sounds are also excluded unless requested.

**Can I compare exact durations and sample rates?**

The provider documentation says SoundBible does not publish structured duration or sample-rate data. A description may mention a length, but the returned technical metadata does not provide a measured duration.

**Can SoundBible clips be used commercially?**

SoundBible says commercial use of its free sounds requires a Creative Commons Attribution or public-domain license. Check the selected clip's license rather than assuming every search result permits commercial use.

**What extra information can I inspect for a selected sound?**

Sound details include tags, download count, file size, attribution text, and MP3/WAV download links. These help you review a candidate's subject, credit, and available files before choosing it.

