API وخادم MCP في AISeeWhy

أرسل طلب POST واحدًا يتضمن رابطًا إلى نقطة نهاية التدقيق لتحصل على تقرير JSON: درجة من 0 إلى 100 وملاحظات مع الأولوية والأدلة وإصلاحات جاهزة للصق، بأي لغة من 30 لغة. يتصل وكلاء الذكاء الاصطناعي بنقطة نهاية 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": "ar"}'

الحقول: url (مطلوب؛ تتم إضافة https:// عند غيابه)، وlanguage (رمز لغة التقرير، والافتراضي en)، وbots (قائمة اختيارية بأسماء الزواحف)، وmarkdown (لإضافة تقرير Markdown). أرسل مفتاحك في الترويسة x-api-key. تستخدم دفعات خريطة الموقع POST /v1/sitemap وتتطلب مفتاحًا. وصف OpenAPI.

كيف أربط وكيل ذكاء اصطناعي عبر MCP؟

أضف خادم MCP بعيدًا بالرابط أدناه (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 تعني أن إجابات الذكاء الاصطناعي لا تستطيع قراءة الصفحة أو الاستشهاد بها، وP2 مهمة، وP3 مستحسنة أو خيار سياسة، مثل حجب زاحف تدريب. تُقرأ robots.txt وفق ما يحدده RFC 9309. RFC 9309.

ما هي الحدود؟

تُرفض الطلبات الموجهة إلى عناوين خاصة أو داخلية. تُبلَّغ الصفحات التي لا يمكن تدقيقها بملاحظة fetch.error أو fetch.status.