AdTest.AI

Evalúa un anuncio de imagen, video o texto en 13 dimensiones de efectividad antes de gastar en medios: la herramienta analyze_advert devuelve la puntuación, un informe sección por sección y correcciones concretas (npx -y adtest-mcp, clave API).

GitHub

Documentación

Servidor MCP de AdTest.AI

npm · Nombre en el registro: ai.adtest/adtest-mcp · Licencia: MIT

Añade una única herramienta analyze_advert a Claude (Desktop, Code, o cualquier cliente MCP) que ejecuta el análisis solo con IA de 13 dimensiones de AdTest.AI sobre un anuncio — imagen, video o texto — y devuelve un informe detallado con puntuaciones. (La validación con panel humano está disponible solo en la aplicación web, no a través de este servidor).

Añadido rápido para Claude Code:

claude mcp add adtest -e ADTEST_API_KEY=adk_your_key_here -- npx -y adtest-mcp

Configuración

  1. Obtén una clave de API: inicia sesión en https://app.adtest.ai → icono Developer (engranaje) → Generate key. Asegúrate de que tu cartera tenga fondos — cada análisis exitoso cuesta $1.

  2. Añade el servidor a tu configuración de Claude (Claude Desktop: claude_desktop_config.json; Claude Code: .mcp.json):

    {
  "mcpServers": {
    "adtest": {
      "command": "npx",
      "args": ["-y", "adtest-mcp"],
      "env": { "ADTEST_API_KEY": "adk_your_key_here" }
    }
  }
}

    O ejecútalo desde una copia local (después de npm install en esta carpeta):

    {
  "mcpServers": {
    "adtest": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/index.js"],
      "env": { "ADTEST_API_KEY": "adk_your_key_here" }
    }
  }
}

  3. Reinicia Claude y luego simplemente pregunta:

    • “Analiza este anuncio: https://example.com/ad.jpg”
    • “Analiza este archivo de video de anuncio: /Users/me/promo.mp4”
    • “Puntúa este texto publicitario: 50% de descuento en todos los zapatos este fin de semana — compra ahora.”

La herramienta

analyze_advert — proporciona uno de:

argumentosignificado
urlURL pública de un anuncio de imagen o video (lo descargamos)
file_patharchivo local de imagen/video para subir
texttexto publicitario para analizar
brand_url (opcional)sitio web del anunciante — mejora la detección de marca/logotipo

Devuelve el texto del análisis de IA más el importe cobrado y tu saldo restante.

Cómo funciona (asíncrono — por eso el video funciona)

El servidor envía el trabajo a POST /developer/ai-analysis/jobs, recibe un job_id inmediatamente, y luego consulta GET /developer/ai-analysis/jobs/{job_id} cada pocos segundos hasta que está complete o failed. Por eso el video funciona: una única solicitud síncrona sería cortada por el tiempo de espera del borde de la CDN (~100s), pero el análisis de video puede tardar varios minutos. Se te cobra una vez, al tener éxito, cuando el trabajo se completa — un trabajo fallido nunca se factura.

Notas

  • Registrado en el Registro MCP oficial como ai.adtest/adtest-mcp.

  • La autenticación es el encabezado x-api-key, configurado desde ADTEST_API_KEY.

  • El endpoint por defecto es https://app.adtest.ai/adtest-api; se puede sobrescribir con ADTEST_API_BASE para staging.

  • El límite de consultas por defecto es 15 min; se puede sobrescribir con ADTEST_POLL_TIMEOUT_MS (milisegundos) para videos muy largos.

  • Límites de tasa: 30 envíos/min y 2000/día por clave (60/min por IP); la consulta es generosa (240/min) y se maneja por ti.

  • Los errores se devuelven como texto legible: invalid_api_key, insufficient_funds, no_creative, invalid_url, unsupported_media_type, too_many_requests, analysis_failed (el último no se cobra).

  • Requiere Node ≥ 18.

Enlaces

Licencia

MIT — consulta LICENSE.