AdTest.AI

Avalie um anúncio de imagem, vídeo ou texto em 13 dimensões de eficácia antes de gastar com mídia: a ferramenta analyze_advert retorna a pontuação, um relatório seção por seção e correções concretas (npx -y adtest-mcp, chave de API).

GitHub

Documentação

Servidor MCP AdTest.AI

· Nome no registro: ai.adtest/adtest-mcp · Licença: MIT

Adiciona uma única ferramenta analyze_advert ao Claude (Desktop, Code ou qualquer cliente MCP) que executa a análise somente com IA de 13 dimensões do AdTest.AI em um anúncio — imagem, vídeo ou texto — e retorna um relatório detalhado de pontuação. (A validação por painel humano está disponível apenas no web app, não por meio deste servidor.)

Adição rápida para o Claude Code:

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

Configuração

Obtenha uma chave de API: entre em https://app.adtest.ai → clique no ícone Developer (engrenagem) → Generate key. Certifique-se de que sua carteira tenha fundos — cada análise bem-sucedida custa $1.

Adicione o servidor à sua configuração do 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" }
    }
  }
}

Ou execute-o a partir de um checkout local (após npm install nesta pasta):

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

Reinicie o Claude e então basta perguntar:
- “Analise este anúncio: https://example.com/ad.jpg”
- “Analise este arquivo de vídeo de anúncio: /Users/me/promo.mp4”
- “Pontue este texto de anúncio: 50% de desconto em todos os sapatos neste fim de semana — compre agora.”

A ferramenta

analyze_advert — forneça um dos seguintes:

argumento	significado
`url`	URL pública de um anúncio em imagem ou vídeo (nós o baixamos)
`file_path`	arquivo local de imagem/vídeo para enviar
`text`	texto do anúncio para analisar
`brand_url` (opcional)	site do anunciante — melhora a detecção de marca/logotipo

Retorna o texto da análise da IA, além do valor cobrado e seu saldo restante.

Como funciona (assíncrono — para que o vídeo funcione)

O servidor envia o trabalho para POST /developer/ai-analysis/jobs, recebe um job_id imediatamente e então consulta GET /developer/ai-analysis/jobs/{job_id} a cada poucos segundos até que esteja complete ou failed. É por isso que o vídeo funciona: uma única solicitação síncrona seria interrompida pelo tempo limite da borda da CDN (~100s), mas a análise de vídeo pode levar vários minutos. Você é cobrado uma vez, em caso de sucesso, quando o trabalho é concluído — um trabalho com falha nunca é faturado.

Notas

Registrado no Registro MCP oficial como ai.adtest/adtest-mcp.
A autenticação é o cabeçalho x-api-key, definido a partir de ADTEST_API_KEY.
O endpoint padrão é https://app.adtest.ai/adtest-api; substitua por ADTEST_API_BASE para staging.
O limite de consultas padrão é de 15 min; substitua por ADTEST_POLL_TIMEOUT_MS (milissegundos) para vídeos muito longos.
Limites de taxa: 30 envios/min e 2000/dia por chave (60/min por IP); a consulta é generosa (240/min) e é tratada por você.
Os erros retornam como texto legível: invalid_api_key, insufficient_funds, no_creative, invalid_url, unsupported_media_type, too_many_requests, analysis_failed (o último não é cobrado).
Requer Node ≥ 18.

Licença

MIT — consulte LICENSE.