ADS Beast para asistentes de IA
ADS Beast para desarrolladores
Todo lo que puede alcanzar una integración pasa por una sola clave de API con permisos. La misma clave sirve para la API REST y para el servidor MCP.
Claves de API
- Un administrador crea las claves en ADS Beast, en Claves de API. Una clave empieza por
absk_y se muestra una sola vez. - Una clave pertenece a una sola organización. También se puede vincular a un cliente, y entonces solo ve a ese cliente.
- Cada clave tiene su propio límite de peticiones por minuto: 60, salvo que fijes otro.
- La facturación, los ajustes y las conexiones con las plataformas publicitarias no son accesibles con una clave en ningún caso.
- Una clave nunca cambia una cuenta publicitaria directamente, ni siquiera con permiso de escritura. Un cambio de campaña, presupuesto, puja, anuncio o palabra clave se convierte en una propuesta: la aprueba una persona, o la política de aplicación automática del cliente aplica un conjunto seguro y limitado. Aprobar propuestas y cambiar los ajustes de protección queda en manos de una persona.
Permisos
Un permiso abre un área para lectura o escritura. Un área que la clave no nombra responde 403. read:* cubre toda la lectura.
| Área | Permisos |
|---|---|
| Leads y sus resultados | read:leadswrite:leadswrite:quality-outcomes |
| Campañas | read:campaignswrite:campaigns |
| Clientes | read:clientswrite:clients |
| Informes | read:reportswrite:reports |
| Alertas | read:alertswrite:alerts |
| Tareas | read:taskswrite:tasks |
| Propuestas de cambios y borradores de campañas | read:proposalswrite:proposals |
| Webhooks | read:webhookswrite:webhooks |
| Envíos | read:outreachwrite:outreach |
| Seguridad de publicación de un sitio | read:seo |
API REST
Dirección base: https://adsbeast.pro/api. Envía la clave como Authorization: Bearer absk_... o X-API-Key.
El comando de abajo devuelve el nombre de la clave, su organización y sus permisos. Empieza por él cuando algo responda 401 o 403.
curl -s https://adsbeast.pro/api/whoami -H "Authorization: Bearer absk_your_key"Invoke-RestMethod -Uri https://adsbeast.pro/api/whoami -Headers @{ Authorization = "Bearer absk_your_key" }MCP
- Dos servidores sobre Streamable HTTP:
https://adsbeast.pro/api/mcpcon las herramientas abiertas yhttps://adsbeast.pro/api/mcp/workspacecon las herramientas de tu organización. - El handshake y
tools/listresponden sin clave. Cada llamada a una herramienta de la cuenta necesita una. - Las herramientas que escriben están marcadas en sus metadatos, así que un cliente que confirma esas acciones preguntará antes.
curl -s https://adsbeast.pro/api/mcp/workspace \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'(Invoke-RestMethod -Method Post -Uri https://adsbeast.pro/api/mcp/workspace -ContentType "application/json" -Body '{"jsonrpc":"2.0","id":1,"method":"tools/list"}').result.tools.nameWebhooks
- ADS Beast envía eventos a tu dirección como un HTTP POST con JSON, por ejemplo
lead.createdcuando llega un lead nuevo. - Cada petición lleva
X-ADS-Beast-Eventcon el nombre del evento yX-ADS-Beast-Signature: sha256=..., un HMAC del cuerpo sin procesar con el secreto del endpoint. Compruébalo antes de fiarte del cuerpo. - Una entrega que falla se reintenta hasta tres veces con pausas cada vez más largas.
- Un endpoint se registra con la herramienta
create_webhooko con la API REST;list_webhook_eventsdevuelve los nombres de los eventos.
import hashlib, hmac
def is_from_adsbeast(secret: str, raw_body: bytes, header: str) -> bool:
expected = "sha256=" + hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, header) # header: X-ADS-Beast-SignaturePlugins
- El repositorio público contiene dos plugins con licencia MIT:
ad-spec-guardcon las herramientas abiertas yadsbeastcon las herramientas de la cuenta. - Claude Code y Codex los instalan desde el repositorio como marketplace. Los demás clientes añaden el servidor por URL.
Límites por plan
El plan fija cuántas llamadas a herramientas MCP puede hacer una organización en un mes. Cuando se acaba el cupo, las herramientas responden con un error hasta el mes siguiente. No se cobra nada adicional.
La tabla se lee del mismo catálogo que la página de precios.
| Plan | Precio | Llamadas MCP al mes | Cuentas publicitarias |
|---|---|---|---|
| Free | Precio$0 al mes | Llamadas MCP al mes100 | Cuentas publicitarias1 |
| Connector | Precio$19 al mes | Llamadas MCP al mes2.000 | Cuentas publicitariasSin tope |
| Starter | Precio$49 al mes | Llamadas MCP al mes10.000 | Cuentas publicitariasSin tope |
| Agency | Precio$199 al mes | Llamadas MCP al mes100.000 | Cuentas publicitariasSin tope |
| Enterprise | Precio$599 al mes | Llamadas MCP al mesSin límite fijo, uso razonable | Cuentas publicitariasSin tope |
Soporte
Preguntas sobre una integración: support@adsbeast.pro. Problemas con los plugins: el gestor de incidencias del repositorio.