Cookies

Usamos cookies para el inicio de sesión (necesarias) y para la analítica (opcionales). Más información - Política de privacidad.

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.

Leads y sus resultadosread:leadswrite:leadswrite:quality-outcomes
Campañasread:campaignswrite:campaigns
Clientesread:clientswrite:clients
Informesread:reportswrite:reports
Alertasread:alertswrite:alerts
Tareasread:taskswrite:tasks
Propuestas de cambios y borradores de campañasread:proposalswrite:proposals
Webhooksread:webhookswrite:webhooks
Envíosread:outreachwrite:outreach
Seguridad de publicación de un sitioread: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.

macOS, Linux
curl -s https://adsbeast.pro/api/whoami -H "Authorization: Bearer absk_your_key"
Windows PowerShell
Invoke-RestMethod -Uri https://adsbeast.pro/api/whoami -Headers @{ Authorization = "Bearer absk_your_key" }

MCP

  • Dos servidores sobre Streamable HTTP: https://adsbeast.pro/api/mcp con las herramientas abiertas y https://adsbeast.pro/api/mcp/workspace con las herramientas de tu organización.
  • El handshake y tools/list responden 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.
macOS, Linux
curl -s https://adsbeast.pro/api/mcp/workspace \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Windows PowerShell
(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.name

Servidor MCP

Webhooks

  • ADS Beast envía eventos a tu dirección como un HTTP POST con JSON, por ejemplo lead.created cuando llega un lead nuevo.
  • Cada petición lleva X-ADS-Beast-Event con el nombre del evento y X-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_webhook o con la API REST; list_webhook_events devuelve 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-Signature

Plugins

  • El repositorio público contiene dos plugins con licencia MIT: ad-spec-guard con las herramientas abiertas y adsbeast con 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.

github.com/notformal/adsbeast-plugins

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.

FreePrecio$0 al mesLlamadas MCP al mes100Cuentas publicitarias1
ConnectorPrecio$19 al mesLlamadas MCP al mes2.000Cuentas publicitariasSin tope
StarterPrecio$49 al mesLlamadas MCP al mes10.000Cuentas publicitariasSin tope
AgencyPrecio$199 al mesLlamadas MCP al mes100.000Cuentas publicitariasSin tope
EnterprisePrecio$599 al mesLlamadas MCP al mesSin límite fijo, uso razonableCuentas publicitariasSin tope

Ver precios

Soporte

Preguntas sobre una integración: support@adsbeast.pro. Problemas con los plugins: el gestor de incidencias del repositorio.

support@adsbeast.pro