API și server MCP AISeeWhy

Trimite un POST cu o adresă URL la endpointul de audit și primești un raport JSON: un scor de la 0 la 100, constatări cu prioritate, dovezi și remedii gata de lipit, în oricare dintre cele 30 de limbi. Agenții AI se conectează la endpointul MCP și apelează audit_url. Fără cheie Pro sau de probă primești o previzualizare.

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

Cum apelez API-ul?

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

Câmpuri: url (obligatoriu; https:// se adaugă dacă lipsește), language (codul limbii raportului, implicit en), bots (listă opțională de nume de crawlere), markdown (adaugă un raport Markdown). Trimite cheia în antetul x-api-key. Loturile după sitemap folosesc POST /v1/sitemap și necesită o cheie. Descriere OpenAPI.

Cum conectez un agent AI prin MCP?

Adaugă un server MCP la distanță cu adresa URL de mai jos (streamable HTTP) și trimite cheia în antetul x-api-key. Instrumente: audit_url, audit_sitemap (până la 10 pagini) și explain_finding. Documentația Model Context Protocol.

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

Cum arată o constatare?

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

Priorități: P1 înseamnă că răspunsurile AI nu pot citi sau cita pagina, P2 este important, P3 este de dorit sau o alegere de politică, de exemplu blocarea unui crawler de antrenare. robots.txt este citit conform RFC 9309. RFC 9309.

Care sunt limitele?

Cererile către adrese private sau interne sunt refuzate. Paginile care nu pot fi auditate sunt raportate cu o constatare fetch.error sau fetch.status.