AISeeWhys API och MCP-server

Skicka en POST med en URL till granskningens slutpunkt och få en JSON-rapport: en poäng på 0–100, fynd med prioritet, belägg och färdiga åtgärder, på valfritt av 30 språk. AI-agenter ansluter till MCP-slutpunkten och anropar audit_url. Utan Pro- eller provnyckel får du en förhandsvisning.

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

Hur anropar jag API:t?

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": "sv"}'

Fält: url (obligatoriskt; https:// läggs till om det saknas), language (rapportens språkkod, standard en), bots (valfri lista med crawlernamn), markdown (lägger till en Markdown-rapport). Skicka din nyckel i headern x-api-key. Sitemap-batcher använder POST /v1/sitemap och kräver en nyckel. OpenAPI-beskrivning.

Hur ansluter jag en AI-agent via MCP?

Lägg till en fjärr-MCP-server med URL:en nedan (streamable HTTP) och skicka din nyckel i headern x-api-key. Verktyg: audit_url, audit_sitemap (upp till 10 sidor) och explain_finding. Dokumentation för Model Context Protocol.

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

Hur ser ett fynd ut?

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

Prioriteringar: P1 betyder att AI-svar inte kan läsa eller citera sidan, P2 är viktigt, P3 är bra att ha eller ett policyval, till exempel att blockera en träningscrawler. robots.txt läses enligt RFC 9309. RFC 9309.

Vilka är gränserna?

Anrop till privata eller interna adresser nekas. Sidor som inte kan granskas rapporteras med ett fetch.error- eller fetch.status-fynd.