API και διακομιστής MCP του AISeeWhy
Στείλτε ένα POST με ένα URL στο endpoint ελέγχου και λάβετε αναφορά JSON: βαθμολογία 0–100, ευρήματα με προτεραιότητα, αποδείξεις και έτοιμες διορθώσεις, σε οποιαδήποτε από τις 30 γλώσσες. Οι πράκτορες AI συνδέονται στο endpoint MCP και καλούν το audit_url. Χωρίς κλειδί Pro ή δοκιμής λαμβάνετε μόνο προεπισκόπηση.
POST https://api.aiseewhy.com/v1/audit · https://api.aiseewhy.com/mcp
Πώς καλώ το 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": "el"}'
Πεδία: url (υποχρεωτικό· προστίθεται https:// αν λείπει), language (κωδικός γλώσσας της αναφοράς, προεπιλογή en), bots (προαιρετική λίστα ονομάτων crawlers), markdown (προσθέτει αναφορά Markdown). Στείλτε το κλειδί σας στο header x-api-key. Οι μαζικοί έλεγχοι sitemap χρησιμοποιούν POST /v1/sitemap και απαιτούν κλειδί. Περιγραφή OpenAPI.
Πώς συνδέω έναν πράκτορα AI μέσω MCP;
Προσθέστε έναν απομακρυσμένο διακομιστή MCP με το παρακάτω URL (streamable HTTP) και στείλτε το κλειδί σας στο header x-api-key. Εργαλεία: audit_url, audit_sitemap (έως 10 σελίδες) και explain_finding. Τεκμηρίωση Model Context Protocol.
{
"mcpServers": {
"aiseewhy": { "type": "http", "url": "https://api.aiseewhy.com/mcp",
"headers": { "x-api-key": "asw_…" } }
}
}
Πώς μοιάζει ένα εύρημα;
{
"id": "access.blocked", "priority": "P1", "bot": "OAI-SearchBot", "bot_class": "search",
"evidence": { "status": 403, "control_status": 200, "waf": "cloudflare" },
"fixes": [ { "kind": "cloudflare", "body": "…" } ]
}
Προτεραιότητες: το P1 σημαίνει ότι οι απαντήσεις AI δεν μπορούν να διαβάσουν ή να παραθέσουν τη σελίδα, το P2 είναι σημαντικό, το P3 είναι καλό να υπάρχει ή θέμα πολιτικής, για παράδειγμα το μπλοκάρισμα ενός crawler εκπαίδευσης. Το robots.txt διαβάζεται όπως ορίζει το RFC 9309. RFC 9309.
Ποια είναι τα όρια;
| Πρόσβαση | Όριο |
|---|---|
| Χωρίς κλειδί ή λογαριασμό | Προεπισκόπηση (πρώτο εύρημα), 1 έλεγχος την ημέρα ανά δίκτυο |
| Pro ή δοκιμή 7 ημερών (ιστότοπος) | Πλήρεις αναφορές, 30 έλεγχοι ημερησίως, ιστορικό |
| Κλειδί API Pro ή δοκιμής (API και MCP) | Πλήρεις αναφορές, 100 έλεγχοι ημερησίως, μαζικοί έλεγχοι sitemap έως 50 URL |
| Μαζικοί έλεγχοι μέσω sitemap | Έως 5.000 URL ανά εκτέλεση, πληρωμή ανά ελεγμένο URL |
Τα αιτήματα προς ιδιωτικές ή εσωτερικές διευθύνσεις απορρίπτονται. Οι σελίδες που δεν μπορούν να ελεγχθούν αναφέρονται με εύρημα fetch.error ή fetch.status.