AISeeWhy API en MCP-server

Stuur één POST met een URL naar het audit-endpoint en ontvang een JSON-rapport: een score van 0–100 en bevindingen met prioriteit, bewijs en kant-en-klare oplossingen, in een van 30 talen. AI-agents verbinden met het MCP-endpoint en roepen audit_url aan. Zonder Pro- of proefsleutel krijg je een voorbeeld.

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

Hoe roep ik de API aan?

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

Velden: url (verplicht; https:// wordt toegevoegd als het ontbreekt), language (taalcode van het rapport, standaard en), bots (optionele lijst met crawlernamen), markdown (voeg een Markdown-rapport toe). Stuur je sleutel in de header x-api-key. Sitemapbatches gebruiken POST /v1/sitemap en vereisen een sleutel. OpenAPI-beschrijving.

Hoe verbind ik een AI-agent via MCP?

Voeg een externe MCP-server toe met de onderstaande URL (streamable HTTP) en stuur je sleutel in de header x-api-key. Tools: audit_url, audit_sitemap (tot 10 pagina's) en explain_finding. Documentatie van het Model Context Protocol.

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

Hoe ziet een bevinding eruit?

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

Prioriteiten: P1 betekent dat AI-antwoorden de pagina niet kunnen lezen of citeren, P2 is belangrijk, P3 is wenselijk of een beleidskeuze, bijvoorbeeld het blokkeren van een trainingscrawler. robots.txt wordt gelezen zoals gedefinieerd in RFC 9309. RFC 9309.

Wat zijn de limieten?

Verzoeken naar privé- of interne adressen worden geweigerd. Pagina's die niet geauditeerd kunnen worden, worden gemeld met een fetch.error- of fetch.status-bevinding.