API e servidor MCP do AISeeWhy

Envie um POST com uma URL ao endpoint de auditoria e receba um relatório em JSON: uma nota de 0 a 100 e achados com prioridade, evidências e correções prontas para colar, em qualquer um dos 30 idiomas. Agentes de IA se conectam ao endpoint MCP e chamam audit_url. Sem uma chave Pro ou de teste, você recebe uma prévia.

POST https://api.aiseewhy.com/v1/audit · https://api.aiseewhy.com/mcp

Como chamo a API?

curl -s https://api.aiseewhy.com/v1/audit \
  -H 'content-type: application/json' \
  -H 'x-api-key: asw_…' \
  -d '{"url": "https://example.com/pricing", "language": "pt-BR"}'

Campos: url (obrigatório; https:// é adicionado se faltar), language (código do idioma do relatório, padrão en), bots (lista opcional de nomes de crawlers), markdown (adiciona um relatório em Markdown). Envie sua chave no cabeçalho x-api-key. Lotes por sitemap usam POST /v1/sitemap e exigem uma chave. Descrição OpenAPI.

Como conecto um agente de IA via MCP?

Adicione um servidor MCP remoto com a URL abaixo (streamable HTTP) e envie sua chave no cabeçalho x-api-key. Ferramentas: audit_url, audit_sitemap (até 10 páginas) e explain_finding. Documentação do Model Context Protocol.

{
  "mcpServers": {
    "aiseewhy": { "type": "http", "url": "https://api.aiseewhy.com/mcp",
                  "headers": { "x-api-key": "asw_…" } }
  }
}

Como é um achado?

{
  "id": "access.blocked", "priority": "P1", "bot": "OAI-SearchBot", "bot_class": "search",
  "evidence": { "status": 403, "control_status": 200, "waf": "cloudflare" },
  "fixes": [ { "kind": "cloudflare", "body": "…" } ]
}

Prioridades: P1 significa que as respostas de IA não conseguem ler nem citar a página, P2 é importante, P3 é desejável ou uma escolha de política, como bloquear um crawler de treinamento. O robots.txt é lido conforme definido na RFC 9309. RFC 9309.

Quais são os limites?

Requisições a endereços privados ou internos são recusadas. Páginas que não podem ser auditadas aparecem com um achado fetch.error ou fetch.status.