API et serveur MCP d'AISeeWhy

Envoyez un POST avec une URL au point de terminaison d'audit et recevez un rapport JSON : un score de 0 à 100, des constats avec priorité, preuves et correctifs prêts à coller, dans l'une des 30 langues. Les agents IA se connectent au point de terminaison MCP et appellent audit_url. Sans clé Pro ou d'essai, vous n'obtenez qu'un aperçu.

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

Comment appeler l'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": "fr"}'

Champs : url (obligatoire ; https:// est ajouté s'il manque), language (code de langue du rapport, en par défaut), bots (liste facultative de noms de robots), markdown (ajoute un rapport Markdown). Envoyez votre clé dans l'en-tête x-api-key. Les lots par sitemap utilisent POST /v1/sitemap et nécessitent une clé. Description OpenAPI.

Comment connecter un agent IA via MCP ?

Ajoutez un serveur MCP distant avec l'URL ci-dessous (streamable HTTP) et envoyez votre clé dans l'en-tête x-api-key. Outils : audit_url, audit_sitemap (jusqu'à 10 pages) et explain_finding. Documentation du Model Context Protocol.

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

À quoi ressemble un constat ?

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

Priorités : P1 signifie que les réponses IA ne peuvent pas lire ou citer la page, P2 est important, P3 est facultatif ou relève d'un choix de politique, par exemple bloquer un robot d'entraînement. robots.txt est lu comme défini dans la RFC 9309. RFC 9309.

Quelles sont les limites ?

Les requêtes vers des adresses privées ou internes sont refusées. Les pages impossibles à auditer sont signalées par un constat fetch.error ou fetch.status.