AISeeWhy API und MCP-Server

Senden Sie einen POST mit einer URL an den Audit-Endpunkt und erhalten Sie einen JSON-Bericht: einen Score von 0 bis 100, Befunde mit Priorität, Belegen und fertigen Fixes, in einer von 30 Sprachen. KI-Agenten verbinden sich mit dem MCP-Endpunkt und rufen audit_url auf. Ohne Pro- oder Testschlüssel erhalten Sie nur eine Vorschau.

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

Wie rufe ich die API auf?

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

Felder: url (erforderlich; https:// wird ergänzt, falls es fehlt), language (Sprachcode des Berichts, Standard en), bots (optionale Liste von Crawler-Namen), markdown (fügt einen Markdown-Bericht hinzu). Senden Sie Ihren Schlüssel im Header x-api-key. Sitemap-Batches nutzen POST /v1/sitemap und erfordern einen Schlüssel. OpenAPI-Beschreibung.

Wie verbinde ich einen KI-Agenten über MCP?

Fügen Sie einen Remote-MCP-Server mit der unten stehenden URL hinzu (Streamable HTTP) und senden Sie Ihren Schlüssel im Header x-api-key. Tools: audit_url, audit_sitemap (bis zu 10 Seiten) und explain_finding. Dokumentation zum Model Context Protocol.

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

Wie sieht ein Befund aus?

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

Prioritäten: P1 bedeutet, dass KI-Antworten die Seite nicht lesen oder zitieren können, P2 ist wichtig, P3 ist wünschenswert oder eine Richtlinienfrage, etwa das Blockieren eines Trainings-Crawlers. robots.txt wird gemäß RFC 9309 gelesen. RFC 9309.

Welche Limits gibt es?

Anfragen an private oder interne Adressen werden abgelehnt. Seiten, die nicht geprüft werden können, werden mit einem Befund fetch.error oder fetch.status gemeldet.