getAdvantage MCP

Documentação de API e MCP

Execute os três scans da Advantage a partir do seu próprio código, do seu CI ou de dentro do seu editor de IA. Get Found mede como a IA lê uma URL ao vivo. Convert mede se um visitante de primeira viagem se cadastraria. Ship Verified verifica o que a página publicou que não deveria ter publicado. Cada resultado é uma medição observada no momento do scan — nunca um veredito, certificação ou garantia.

A API é gratuita para testar sem chave, com limite por IP. Uma chave de API eleva o limite para o nível do seu plano e retorna saída de modelo ao vivo em planos pagos. A especificação legível por máquina está em /api/openapi.json.

Por que integrar uma única vez? Para você não precisar manter AEO manualmente. Coloque o embed ou uma chamada de API no seu CI e as correções seguras para DOM (JSON-LD, meta, FAQ) continuam se aplicando sozinhas; nós reavaliamos conforme ChatGPT, Perplexity, Gemini e Claude mudam a forma como leem sites, então suas pontuações permanecem atualizadas sem você precisar acompanhar o alvo. Uma ferramenta neutra mantém vigilância contínua sobre visibilidade de IA e segurança do que foi publicado — supervisão independente, não uma auditoria pontual. (Seus arquivos llms.txt e robots.txt continuam sendo arquivos que você coloca uma única vez.)

Autenticação

Crie uma chave em /app/api-keys (exibida apenas uma vez — armazene-a como segredo de ambiente, nunca a envie para o repositório). Envie-a como token Bearer em qualquer requisição:

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com" \
  -H "Authorization: Bearer adv_live_…"

Sem o cabeçalho, você obtém o nível gratuito sem chave (limite por IP, saída amostrada). Com uma chave, o limite segue seu plano e um plano pago retorna saída de modelo ao vivo. Exceder o limite retorna HTTP 429 com um cabeçalho retry-after; uma chave inválida retorna 401.

Limites de taxa

Os limites são observados por chave (ou por IP, sem chave) no momento da requisição:

• Sem chave: 5/min · 30/dia, saída amostrada
• Starter: 60/min · 1.000/dia, saída ao vivo
• Pro: 120/min · 5.000/dia, saída ao vivo
• Agency: 240/min · 20.000/dia (uso justo), saída ao vivo

O endpoint combinado conta como uma única requisição na mesma taxa por mecanismo (nunca cobra três vezes por uma chamada).

Endpoints

GET /api/analyze?url=

Get Found — scan de legibilidade para IA (9 sinais)

Pontua o quão legível a página é para mecanismos de IA em nove sinais (título, meta description, dados estruturados, cabeçalhos, llms.txt, proporção conteúdo-para-markup, Open Graph, canonical, robots). Retorna um detalhamento por sinal, correções prontas para colar e um llms.txt inicial gerado.

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com"

GET /api/verify-convert?url=

Convert — prontidão de conversão + leitura rápida de 5 segundos

Pontua os sinais que determinam se um visitante de primeira viagem entende o aplicativo e se cadastra. Com uma chave paga, também executa um teste agêntico de primeira impressão de 5 segundos. Retorna verificações, correções, um percentil de referência e um relatório /v compartilhável.

curl "https://getadvantage.app/api/verify-convert?url=https://yourapp.com"

GET /api/verify-safety?url=

Ship Verified — verificações de segurança do que foi publicado + selo

Executa verificações determinísticas para exposições comuns de código "vibe-coded" (segredos no bundle do cliente, configuração de backend, arquivos expostos, cabeçalhos de segurança, CORS, transporte, source maps). Uma verificação aprovada significa que não encontramos aquele problema específico — nunca que o aplicativo é seguro ou certificado. Retorna verificações, correções, um percentil de referência, um relatório /v e um selo "Checked by Advantage".

curl "https://getadvantage.app/api/verify-safety?url=https://yourapp.com"

POST /api/v1/scan/combined

Combinado — todos os três mecanismos, uma única chamada

Executa todos os três mecanismos em uma única URL e retorna um único payload: três blocos de pontuação independentes (nunca calculados como média), um resumo de interseção nomeando a dimensão mais fraca e a maior próxima ação, e um permalink. A forma mais rápida de obter o panorama completo em uma única requisição.

curl -X POST "https://getadvantage.app/api/v1/scan/combined" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer adv_live_…" \
  -d '{"url":"https://yourapp.com"}'

Servidor MCP — scan de dentro do seu editor

A Advantage também é um servidor Model Context Protocol, então você pode adicioná-lo uma única vez ao Claude Code, Cursor, Claude Desktop ou Windsurf e simplesmente digitar "scan my app with getadvantage". Ele fala Streamable HTTP remoto (o transporte remoto oficial atual) — zero instalação, os scans rodam em nossos servidores. Ele expõe quatro ferramentas: get_found, convert_check, ship_verified e combined_scan. Cada uma começa com a pontuação e a maior correção pronta para colar, e inclui o link do relatório.

Adicionar (Cursor / Claude Desktop / Claude Code)

Coloque isto na configuração do seu cliente MCP:

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp"
    }
  }
}

Com uma chave de API (limite maior, saída ao vivo), adicione o cabeçalho:

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp",
      "headers": { "Authorization": "Bearer adv_live_…" }
    }
  }
}

Ou, no Claude Code, uma única linha:

claude mcp add --transport http getadvantage https://getadvantage.app/api/mcp

O servidor MCP é gratuito para testar sem chave no limite sem chave; uma chave eleva o limite e retorna saída ao vivo, exatamente como na API HTTP.

Quer acompanhar sites, ver histórico e aplicar correções automaticamente via embed? Crie uma conta — ou faça o scan de um aplicativo gratuitamente primeiro.