API a server MCP služby AISeeWhy

Pošlete jeden POST s URL na endpoint auditu a získáte zprávu v JSON: skóre 0–100, zjištění s prioritou, důkazy a hotovými opravami k vložení, v kterémkoli z 30 jazyků. AI agenti se připojí k endpointu MCP a volají audit_url. Bez klíče Pro nebo zkušebního klíče dostanete jen náhled.

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

Jak zavolat 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": "cs"}'

Pole: url (povinné; pokud chybí, doplní se https://), language (kód jazyka zprávy, výchozí en), bots (volitelný seznam názvů crawlerů), markdown (přidá zprávu v Markdownu). Klíč posílejte v hlavičce x-api-key. Hromadné audity podle sitemapy používají POST /v1/sitemap a vyžadují klíč. Popis OpenAPI.

Jak připojit AI agenta přes MCP?

Přidejte vzdálený server MCP s níže uvedenou URL (streamable HTTP) a klíč posílejte v hlavičce x-api-key. Nástroje: audit_url, audit_sitemap (až 10 stránek) a explain_finding. Dokumentace Model Context Protocol.

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

Jak vypadá zjištění?

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

Priority: P1 znamená, že odpovědi AI stránku nepřečtou ani necitují, P2 je důležité, P3 je vhodné mít nebo věc volby, například blokace trénovacího crawleru. robots.txt se čte tak, jak jej definuje RFC 9309. RFC 9309.

Jaké jsou limity?

Požadavky na soukromé nebo interní adresy jsou odmítnuty. Stránky, které nelze auditovat, jsou nahlášeny zjištěním fetch.error nebo fetch.status.