API e server MCP di AISeeWhy

Invia una POST con un URL all'endpoint di audit e ricevi un report JSON: un punteggio da 0 a 100, problemi con priorità, prove e correzioni pronte da incollare, in una qualsiasi di 30 lingue. Gli agenti AI si collegano all'endpoint MCP e chiamano audit_url. Senza una chiave Pro o di prova ottieni un'anteprima.

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

Come chiamo l'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": "it"}'

Campi: url (obbligatorio; https:// viene aggiunto se manca), language (codice della lingua del report, predefinito en), bots (elenco facoltativo di nomi di crawler), markdown (aggiunge un report Markdown). Invia la chiave nell'header x-api-key. I batch da sitemap usano POST /v1/sitemap e richiedono una chiave. Descrizione OpenAPI.

Come collego un agente AI tramite MCP?

Aggiungi un server MCP remoto con l'URL qui sotto (streamable HTTP) e invia la chiave nell'header x-api-key. Strumenti: audit_url, audit_sitemap (fino a 10 pagine) ed explain_finding. Documentazione del Model Context Protocol.

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

Che aspetto ha un problema rilevato?

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

Priorità: P1 significa che le risposte AI non possono leggere o citare la pagina, P2 è importante, P3 è opzionale o una scelta di policy, per esempio bloccare un crawler di addestramento. robots.txt viene letto come definito in RFC 9309. RFC 9309.

Quali sono i limiti?

Le richieste verso indirizzi privati o interni vengono rifiutate. Le pagine che non possono essere controllate sono segnalate con un problema fetch.error o fetch.status.