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

# How to Use BigSoundBank sound search in opencode

Find BigSoundBank recordings with titles, descriptions, durations, categories, and preview links. Use it to compare candidates for a sound cue before fetching a recording's full details.

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

- Use BigSoundBank sound search to find door recordings for the opening and closing events in this game's audio manifest. Return titles, descriptions, durations, and preview links for five candidates.
- Use BigSoundBank sound search for footsteps on concrete. Compare the returned descriptions and durations with the movement cues in this project and propose three candidates.
- Use BigSoundBank sound search for rain ambience. Make a shortlist with titles, durations, categories, and source links for the outdoor level described in this repository.
- Use BigSoundBank sound search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from BigSoundBank sound search and tell me what changed since last week.

## How to set up BigSoundBank 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 BigSoundBank 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": "bigsoundbank-com/sound-effects/search_sounds",
    "input": {
      "url": "<url>"
    }
  }'
```

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

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

## BigSoundBank sound search tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | A bigsoundbank.com/search URL; supplies its q, CatID, tri, type, mode, duree, frequence and page unless those inputs are given. |
| sort | popular, newest, rating, alphabetical, shortest, longest | — | Default popular. |
| query |  | — | Keywords, 1-2 English nouns work best (door, rain, engine). |
| category |  | — | UCS category code: a top-level one such as DOOR, AMB, VEH, WATR or a subcategory such as DOORWood or VEHDoor (see suggested_categories and each sound's categories). Pattern: ^[A-Za-z]+$. |
| channels | mono, stereo, multichannel | — | channels |
| duration | max_1s, max_10s, max_1min, min_1min, min_5min | — | Length bucket. |

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

Build a BigSoundBank cue sheet that matches the events in your game or app. The agent can compare recording descriptions and durations, then put selected sounds' specifications and source links beside the project's audio references.

### Build a game sound cue sheet

Find candidates for door openings, footsteps, and impacts, then check selected recordings for duration, audio specifications, download links, and licensing.

### Plan podcast scene effects

Compare telephone, door, and room sounds for an audio drama. Keep the chosen recording's source, duration, and file links beside each cue.

### Choose effects for a video edit

Shortlist recordings that match the visible action, then inspect the selected sound's specifications and available files before editing.

### Prepare an ambience shortlist

Compare rain, wind, and forest recordings by description and duration. Review each selected recording's channels and available formats for the intended mix.

### Replace an unsuitable sound asset

Find alternatives to a recording that does not fit a scene, then compare the replacements' descriptions, lengths, specifications, and license details.

### Document production sound choices

Identify recordings used in a production and assemble their titles, source pages, and license information into an asset reference sheet.

## Overview

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

## BigSoundBank sound search in other agents

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

## More opencode guides

- [BigSoundBank sound details](https://spiral.ai/integrations/opencode/bigsoundbank-sound-details)
- [CBC News article details](https://spiral.ai/integrations/opencode/cbc-news-article-details)
- [BFI search fields](https://spiral.ai/integrations/opencode/bfi-search-fields)
- [CBC News article search](https://spiral.ai/integrations/opencode/cbc-news-article-search)
- [BFI record details](https://spiral.ai/integrations/opencode/bfi-record-details)
- [CBC News region lookup](https://spiral.ai/integrations/opencode/cbc-news-region-lookup)

## Questions about BigSoundBank sound search in opencode

**Can opencode use BigSoundBank sound search?**

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

**How much does BigSoundBank 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 BigSoundBank sound search in opencode?**

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

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

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

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

**What does BigSoundBank cover?**

BigSoundBank advertises more than 3,500 sound effects and ambiences recorded since 2005. It is a recording library created by Joseph Sardin.

**Can I edit the sounds for a commercial project?**

BigSoundBank's published license permits adaptation, remixing, and commercial use. Check the selected recording's license details when choosing an asset.

**Do BigSoundBank sounds require attribution?**

BigSoundBank states that attribution is optional. Its sound pages explicitly say that credit is appreciated but isn't required.

**Does every recording have the same audio formats?**

No. BigSoundBank explicitly says that not every format is available for every sound, and recommends WAV for editing and mixing.

**Are search results complete recording specifications?**

No. The documented search response can have null sample rates and tags; full sound records add recording details and direct file links.

