search_sounds
Free-text search over the SFXMint library of free CC0 sound effects. Use it for sound descriptions, additional constraints or gaps left by another tool. Choose get_role_sound for a named event or get_sound_set for multiple events when that fits the task; these are task branches, not a fixed sequence. Hard constraints (duration, loop, format, excluded words) always apply. results hold sounds whose text has every word of the query. When there are none, closest lists the nearest sounds that meet every hard constraint, best first, each with missing_terms: judge them from title and description and let the user listen. library_fit says how well the library covers the request (full, close, weak, none); anything short of full also returns generation options. Returns direct, hotlinkable MP3/WAV URLs and verified OGG (Vorbis) URLs where available — no API key, no attribution required — plus measured acoustics (attack_ms, tail_ms, centroid_hz), character labels like 'bright · punchy · tight', loop/file-QC status, and score/match as ranking evidence only (role = known role default, exact = all words hit, partial = some words hit, semantic = nearest by meaning).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| loop | No | Require (true) or exclude (false) a candidate marked with prepared loop metadata; seam evidence is returned separately. | |
| limit | No | Max results (default 20, max 50) | |
| query | Yes | Keywords or a natural-language description, e.g. 'door slam', 'soft UI confirmation chime', 'coin pickup' | |
| format | No | Delivery format (ogg = Ogg Vorbis); loop=true defaults to WAV when omitted. | |
| category | No | Optional category slug: ui, retro-game, transition, impact, ambience, water, fire-electric, footsteps, door, mechanical, paper-fabric, glass, animal, crowd, cartoon, magic-scifi, horror, feedback, instrument, office, human, vehicle, household | |
| max_duration_ms | No | Hard maximum delivered duration in milliseconds; format-specific measurement is required. |