MCP e API

Meça a visibilidade em IA a partir do Claude, dos seus agentes e do seu pipeline.

A AeoState executa um servidor Model Context Protocol (MCP) em https://aeostate.com/mcp, com a mesma API HTTP por trás. Ligue-se uma vez e a pontuação gratuita de visibilidade em IA aparece como um cartão interativo no Claude Desktop, claude.ai, Claude Code, Cursor e em qualquer outro host MCP — ou chame a API diretamente a partir de um script.

Ferramentas

As ferramentas gratuitas funcionam para qualquer pessoa — sem conta, sem chave. As ferramentas marcadas com “Chave de API” atuam em nome de uma conta registada: crie uma conta gratuita e depois uma chave pessoal em Conta → Acesso à API.

Ligue-se num só passo

Copie um destes excertos para o seu host. Adicione o cabeçalho Authorization quando tiver uma chave.

Endpoint MCP
https://aeostate.com/mcp
Claude Code
claude mcp add --transport http aeostate https://aeostate.com/mcp
Cursor, VS Code, conectores do claude.ai e outros hosts (JSON)
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp"
    }
  }
}
O mesmo, a atuar pela sua conta
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

HTTP simples para pipelines

As mesmas três chamadas que o servidor MCP faz. Inicie uma análise, consulte-a e leia o relatório — a partir de CI, de um fluxo de CRM ou de uma tarefa noturna.

1 · Iniciar uma análise
curl -s -X POST https://aeostate.com/api/analyze \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","industry":"family dental clinic","category":"family dental clinic","locale":"en"}'
# → {"mode":"async","jobId":"…"} (poll below) or the finished free summary
2 · Consultar até terminar
curl -s https://aeostate.com/api/scan-jobs/<jobId>
# → {"status":"queued|running|completed|failed","stage":"crawling|scoring|completed","reportId":"…"}
3 · Ler o relatório
curl -s https://aeostate.com/api/reports/<reportId>
# → 402 + the free summary (score, grade, confidence, section teasers)

As análises anónimas seguem as regras da pontuação gratuita do site (limites de utilização; onde a pontuação gratuita está protegida por e-mail, a ligação é enviada por e-mail). Com uma chave, correm como a sua conta: sem barreira, limites por chave e os seus relatórios pagos.

Como os agentes de IA encontram a AeoState

Além do servidor MCP, a AeoState publica descrições legíveis por máquina para que agentes de IA e registros de agentes a descubram por conta própria. Cada endereço abaixo responde com JSON que qualquer site pode ler.

Cartão do servidor MCP
https://aeostate.com/.well-known/mcp/server-card.json
Catálogo de IA (ARD)
https://aeostate.com/.well-known/ai-catalog.json
Catálogo de API (RFC 9727)
https://aeostate.com/.well-known/api-catalog

Skills para agentes (Agent Skills)

Agentes compatíveis com Agent Skills podem carregar a partir deste índice a skill que a AeoState publica. Ela mostra como executar uma verificação gratuita da visibilidade em IA pelo servidor MCP ou pela API HTTP e como ler o resultado. Cada skill é listada com um resumo SHA-256 para que o agente possa verificar o que descarregou.

Índice de Agent Skills
https://aeostate.com/.well-known/agent-skills/index.json

Páginas em markdown

Peça qualquer página pública com o cabeçalho Accept: text/markdown para receber o texto dela em markdown em vez de HTML, com título, endereço e idioma no início. Os navegadores continuam a receber a página normal.

Exemplo
curl -H "Accept: text/markdown" https://aeostate.com/pt/pricing

Ferramentas no navegador (WebMCP)

Num navegador compatível com WebMCP, um agente de IA que trabalhe neste site pode abrir as páginas, consultar os preços atuais, acompanhar uma análise em andamento e preencher o formulário de pontuação gratuita. O visitante continua a confirmar e enviar o formulário. O WebMCP é experimental e só está disponível em algumas versões de navegador; nos demais, nada muda.

Pontuação gratuita e Relatório Advanced

Sem conta

Pontuação gratuita — todas as ferramentas, todos os visitantes

  • A sua pontuação geral de visibilidade, a classificação e a nossa confiança nela
  • Que rastreadores de IA conseguem ou não conseguem aceder ao seu site
  • A primeira conclusão que limita a sua visibilidade

Obtenha uma chave de API pessoal

Inicie sessão (ou crie uma conta gratuita), abra Conta → Acesso à API, crie uma chave e cole-a nos excertos acima. As chaves atuam apenas sobre análises e os relatórios que comprou — nunca sobre a sua conta, a faturação ou os relatórios de outras pessoas.

Obtenha a sua chave