getAdvantage MCP Server

Autenticação

Crie uma chave em /app/api-keys (exibida uma única vez — armazene-a como um segredo de ambiente, nunca a inclua em commits). 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 plano gratuito sem chave (limite por IP, saída amostrada). Com uma chave, o limite segue seu plano e um plano pago retorna saída do modelo ao vivo. Exceder o limite retorna HTTP 429 com um cabeçalho retry-after; uma chave inválida retorna 401.

Limites de requisição

Os limites são aplicados 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 um único consumo na mesma taxa por mecanismo (nunca cobra três vezes por uma chamada).

Endpoints

GET/api/analyze?url=

Get Found — varredura de legibilidade por IA (9 sinais)

Avalia o quão legível a página é para mecanismos de IA em nove sinais (título, meta descrição, dados estruturados, cabeçalhos, llms.txt, proporção conteúdo/marcação, Open Graph, canônico, 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 para conversão + leitura fria de 5 segundos

Avalia 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 de publicação + selo

Executa verificações determinísticas para exposições comuns de código vibe (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

Combined — todos os três mecanismos, uma chamada

Executa os três mecanismos em uma URL e retorna uma carga útil: três blocos de pontuação independentes (nunca calcula média), um resumo de interseção nomeando a dimensão mais fraca e a única maior próxima ação, e um link permanente. 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 — escaneie de dentro do seu editor

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

Adicionar (Cursor / Claude Desktop / Claude Code)

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

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

Com uma chave de API (maior limite, 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, em uma 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 aumenta o limite e retorna saída ao vivo, exatamente como a API HTTP.

Quer monitorar sites, ver histórico e aplicar correções automaticamente via incorporação? Crie uma conta — ou escaneie um aplicativo gratuitamente primeiro.

Pergunte ao Ray