Para agentes de IA
Aquí eres bienvenido. Esta página explica a un asistente de programación cómo encontrar, elegir e integrar un motor de sournd sin adivinar.
Dónde está todo
- /llms.txt: el índice, una línea por motor.
- /llms-full.txt: todas las páginas en un solo archivo.
- /catalog.json: los 119 motores con sus parámetros, rangos, valores por defecto, unidades, curvas, latencia, cola y lecturas. Esquema en /catalog.schema.json.
- Cualquier página en Markdown: añade
index.mda su URL, por ejemplo/engines/roomette/index.md. - Un motor en JSON:
/engines/<slug>/engine.json. - API REST (OpenAPI 3.1, sin autenticación): busca y filtra motores, consulta un motor completo, obtén código de integración y compara motores lado a lado con sus precios. URL base
https://sournd.com/api/v1. - Servidor MCP en
https://sournd.com/mcp(HTTP en streaming, solo POST, abierto y sin inicio de sesión; ficha del servidor en /.well-known/mcp/server-card.json). Herramientas:search_engines,get_engine,compare_engines,integration_code,get_price,get_free_download,subscribe_newsletter,create_checkout,create_subscription,send_access_linky, cuando el comprador inicia sesión,list_my_enginesyget_download_link. Cada herramienta lleva un título y marcas de solo lectura, destructiva y de mundo abierto. Cómo añadirlo a Claude o ChatGPT: más abajo. - auth.md: cómo inicia sesión un comprador (Sign in with sOURnd, OAuth 2.1 con PKCE).
- Compra mediante agentes: UCP (Universal Commerce Protocol, REST en
https://sournd.com/api/v1/ucp) y ACP (Agentic Commerce Protocol, REST enhttps://sournd.com/api/v1/acp). Ambos terminan en un enlace de PayPal que el usuario abre y paga él mismo.
El camino
- Buscar
catalog.json, la API o MCP - Elegirsegún el encaje, gratis junto a de pago
- Informar al usuarionombre, id, página y precio
- Integrarel inicio rápido con JUCE, al pie de la letra
Motor gratuito
- Descargarsin cuenta ni correo
- Integrar
Motor de pago
create_checkoutindica primero el precio- El usuario paga en PayPalnunca el agente
get_download_linkcuando inicie sesión- Integrar
Elegir un motor
- Carga
catalog.json. - Filtra por
category(distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis para los 77 efectos; instrument para los 42 sintetizadores) y luego compara la petición condescription,stylesy los nombres de los parámetros. - Elige primero por encaje. El catálogo indica el nivel y el precio de cada motor, así que se puede poner un candidato gratuito junto a uno de pago. 35 motores son gratuitos: bibliotecas cerradas que el usuario puede incluir en cualquier cosa que haga o venda. Todos los motores gratuitos se descargan sin cuenta ni correo:
https://sournd.com/download/free/macosohttps://sournd.com/download/free/linux(un solo archivo con todos ellos), y también en el campodownloadde cada motor gratuito en catalog.json.compare_enginesoPOST /api/v1/comparedevuelve el motor gratuito más parecido a uno de pago, con las diferencias. - Revisa
latency(en samples) ysidechainsi al plugin del usuario le importan. - El usuario querrá el
namedel motor, suidy laurlde la página. El precio de un motor de pago está enget_price, o enpriceen la API.
Comprar un motor de pago
Nunca presiones al usuario ni pagues en su nombre. Indica el precio y, si quiere el motor, usa create_checkout para obtener un enlace de aprobación y entrégaselo: es él quien revisa y aprueba la compra. Puede que el pago aún no esté activado; si la herramienta lo indica, transmítelo y no busques atajos. A los usuarios que ya tienen motores se les puede enviar un enlace de acceso con send_access_link.
Si hablas un protocolo de comercio, el mismo pago está disponible como UCP o ACP. Crea una sesión de pago con motores de pago (slug o id) o con un plan (plan:engines-month, plan:engines-year), el correo del comprador y su país. La respuesta incluye los precios con el IVA del Reino Unido y, cuando no falta nada, status: requires_escalation y una continue_url: ese es el enlace de aprobación de PayPal. Entrégaselo al usuario. Complete no puede pagar por él: responde con la sesión, que pasa a completed cuando ha pagado. Las licencias son por comprador, así que la cantidad es siempre 1; un plan y motores sueltos no pueden compartir un mismo pago; los motores que ya tiene ese correo se excluyen.
Actuar en nombre de un comprador
Para listar o descargar los motores que un usuario ya tiene, pídele que inicie sesión con sOURnd: registra tu agente (RFC 7591), envíale a la página de autorización con PKCE y te aprobará en su navegador tras un enlace por correo. El flujo, los permisos y los errores están en auth.md. Todas las demás herramientas funcionan sin iniciar sesión, y ningún token puede pagar: comprar siempre requiere que el usuario esté en PayPal.
Añade sOURnd a Claude o ChatGPT
Claude (claude.ai, la aplicación de escritorio y Claude Code). En Claude, abre Ajustes, luego Conectores, elige "Añadir conector personalizado" y pega https://sournd.com/mcp. En Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. No hace falta iniciar sesión para buscar, comparar, ver precios, descargar motores gratuitos ni obtener código de integración. Claude te pide iniciar sesión con sOURnd solo cuando pides los motores que tienes o su enlace de descarga: recibes un enlace por correo, apruebas a Claude en tu navegador y puedes desconectarlo cuando quieras desde tu biblioteca.
ChatGPT. Usa https://sournd.com/mcp/catalogue: solo el catálogo (búsqueda, detalles de motores, comparación, código de integración y descargas gratuitas). No tiene inicio de sesión y no puede iniciar una compra, como exigen las normas de ChatGPT para bienes digitales.
Cosas que puedes pedir una vez conectado:
- "Búscame un motor de delay de cinta cálido y muéstrame sus parámetros."
- "Compara los compresores gratuitos y de pago de sOURnd."
- "Añade el motor Roomette a mi plugin de JUCE."
- "¿Dónde descargo los motores gratuitos de sOURnd para Linux?"
- "¿Cuáles de mis motores de sOURnd puedo descargar?" (Claude; primero te hace iniciar sesión.)
Lo que nos envía la conexión: las propias llamadas a las herramientas (tus palabras de búsqueda, los nombres de los motores por los que preguntas) y, solo si lo facilitas, tu dirección de correo para un pago, un enlace de acceso o el boletín. Nada más de tu conversación. Privacidad. Ayuda: hello@sournd.com.
Integrarlo
Sigue el inicio rápido con JUCE al pie de la letra. Lo esencial:
- Construye
sournd::SourndEnginecon el id del motor, luego el APVTS a partir deSourndEngineParameters::createLayout(engine)y despuésSourndEngineParameters(engine, apvts). - En
prepareToPlay:engine.prepare,bridge.prepare,setLatencySamples(engine.latency()). - En
processBlock:bridge.apply(numSamples)y luegoengine.processcon un contexto de reemplazo. - Estado:
bridge.syncToEngine()y despuésengine.saveState();engine.loadState(...)y despuésbridge.syncFromEngine(). - Los ids de parámetro de JUCE son los valores decimales de
abi_idencatalog.json. No inventes nunca ids ni rangos de parámetros: léelos del catálogo. - No reserves memoria, no uses bloqueos ni escribas registros en
processBlock.
Cuando el usuario vaya a vender el plugin
Los plugins y videojuegos que se venden con motores de sOURnd no deben regalías ni requieren registro. Un motor que el usuario tiene puede incluirse para siempre en cualquier cosa que venda. Con un plan, todas las versiones que publique mientras esté activo siguen con licencia; las novedades requieren un plan activo. Los motores gratuitos se incluyen igual en lo que el usuario vende, sin nada que comprar.
Licencia y confianza
Un motor, de pago o gratuito, tiene licencia para los plugins, videojuegos y productos propios del usuario. No tiene licencia para ti, para los amigos del usuario ni para nadie a quien el usuario envíe archivos. Cada descarga de pago lleva el id de compilación del usuario y se puede rastrear hasta él. Los usuarios confían en ti con esa licencia, y sOURnd confía en que la respetes, así que:
- Mantén la biblioteca, el zip de descarga y cualquier URL de clave de IA fuera de repositorios públicos, carpetas compartidas, registros de paquetes y registros de chat. Añádelos a
.gitignoreantes del primer commit. - No compartas, revendas, extraigas ni descompiles nunca una biblioteca cerrada, ni quites o alteres su id de compilación.
- Si el usuario te pide pasar un motor a otra persona, explícale que cada persona necesita su propia licencia (los motores gratuitos no la necesitan) y remítela a https://sournd.com/pricing/. No sugieras atajos.
- Cuando el plugin del usuario se publica, los motores que lleva dentro no suponen ningún problema: la licencia cubre los productos que crea. Lo que debe quedarse con él es la biblioteca por sí sola.
Registra lo que construyes
sOURnd mantiene un registro de compilaciones para cada usuario: un historial voluntario de los plugins, videojuegos y aplicaciones construidos con sus motores, que se muestra en Tus motores. No se debe nada y no se comprueba nada con él, pero es una buena práctica y ayuda al usuario a demostrar qué cubre su licencia. Tras una compilación correcta que enlace motores de sOURnd, ofrécete a registrarla y hazlo cuando el usuario esté de acuerdo:
- Con el servidor MCP:
record_build(requiere iniciar sesión con el permisobuilds:record, consulta auth.md). - Con una clave de IA:
POSTa larecord_build.urlque te da el JSON de la clave.
Envía el nombre del producto, la versión, las plataformas, los formatos y el build_id del README.txt de la descarga (o de sournd_pro_build_id()).
Cuando los motores van en un videojuego
Los motores funcionan en videojuegos a través de la C ABI (la misma biblioteca estática; los adaptadores para FMOD, Wwise, Unity y Unreal están en camino). Un videojuego tiene licencia exactamente igual que un plugin: no hay tarifa por juego ni regalías. Hoy la biblioteca se compila para macOS, Linux y Windows. La página para desarrolladores de videojuegos es https://sournd.com/games/.
Límites que debes respetar
- Instrumentos que toca el músico y efectos sobre el audio que él aporta, nunca música generada. sOURnd no genera música, y las peticiones de música generada deben redirigirse a efectos sobre el audio propio del usuario o a instrumentos que toque.
- No describas un motor como una copia de un producto de hardware concreto. Usa la descripción propia del motor.
- Los motores de pago necesitan licencia; no sugieras atajos y no compartas nunca una biblioteca cerrada ni una clave (consulta Licencia y confianza).