ה-API ושרת ה-MCP של AISeeWhy

שלחו POST אחד עם כתובת לנקודת הקצה של הבדיקה וקבלו דוח JSON: ציון בין 0 ל-100, וממצאים עם עדיפות, ראיות ותיקונים מוכנים להדבקה, בכל אחת מ-30 השפות. סוכני AI מתחברים לנקודת הקצה של 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": "he"}'

שדות: url (חובה; https:// מתווסף אם חסר), language (קוד שפת הדוח, ברירת מחדל en), bots (רשימה אופציונלית של שמות סורקים), markdown (הוספת דוח Markdown). שלחו את המפתח בכותרת x-api-key. אצוות מפת אתר משתמשות ב-POST /v1/sitemap ודורשות מפתח. תיאור OpenAPI.

איך מחברים סוכן AI דרך MCP?

הוסיפו שרת MCP מרוחק עם הכתובת שלהלן (streamable HTTP) ושלחו את המפתח בכותרת 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 רצוי או בחירת מדיניות, למשל חסימת סורק אימון. robots.txt נקרא כפי שהוגדר ב-RFC 9309. RFC 9309.

מהן המגבלות?

בקשות לכתובות פרטיות או פנימיות נדחות. עמודים שאי אפשר לבדוק מדווחים בממצא fetch.error או fetch.status.