المطوّرون

واجهة API وخادم MCP من Citevana

يوفّر Citevana واجهة REST API مجانية وخادم MCP مجانيًا. استخدمهما للتحقق مما إذا كانت زواحف الذكاء الاصطناعي تستطيع الوصول إلى موقع، وتدقيق صفحة من حيث SEO والجاهزية للذكاء الاصطناعي، وإنشاء ملف llms.txt، وقراءة تدقيقات مواقعك. ولا تحتاج نقاط نهاية الأدوات إلى مفتاح: فمن دون مفتاح تتشارك حصة الأدوات المجانية على الموقع، أي 3 فحصًا يوميًا تُحتسب لكل اتصال إنترنت. أما الحساب المجاني مع مفتاح API فيرفع ذلك إلى 100 استدعاء يوميًا ويفتح بيانات مساحة عملك.

آخر مراجعة: 16 سبتمبر 2026

معلومات سريعة

عنوان URL الأساسي لـ REST: https://citevana.com/api/v1
المصادقة: لا شيء للأدوات المجانية، ضمن الحصة المشتركة بلا مفتاح الموضّحة أدناه. وفي غير ذلك مفتاح API لمساحة العمل: Authorization: Bearer cv_live_…
الحصة المجانية: بلا مفتاح: 3 فحصًا يوميًا لكل اتصال إنترنت، مشتركة مع الأدوات المجانية على الموقع. وبمفتاح: 100 استدعاء يوميًا في الخطة المجانية. وكلتا النافذتين بتوقيت UTC، مع حد اندفاع قدره 20 في الدقيقة.
نقطة نهاية MCP: https://citevana.com/api/mcp
إصدارات بروتوكول MCP: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26
وصف OpenAPI 3.1: https://citevana.com/api/v1/openapi.json

REST API

كل الاستجابات بصيغة JSON. وتتضمن الاستجابات الناجحة "ok": true. وتُرجع الأدوات المجانية ملخصًا بلغة بسيطة وقائمة مهام مرتبة حسب الأهمية مع تقديرات زمنية.

نقاط النهاية
الطريقة	المسار	الوصول	وظيفتها
GET	/sites	مفتاح بصلاحية read:sites	تسرد المواقع في مساحة العمل التابعة للمفتاح.
GET	/sites/{siteId}/audits/latest	مفتاح بصلاحية read:audits	تُرجع أحدث تدقيق مكتمل للموقع: الدرجة، والمشكلات، والجاهزية للذكاء الاصطناعي، والمهام.
POST	/tools/ai-crawlers	بلا مفتاح (حد مشترك)، أو بمفتاح read:tools	تقرأ ملف robots.txt لموقع وتوضّح زواحف الذكاء الاصطناعي المسموح لها أو المحظورة.
POST	/tools/page-audit	بلا مفتاح (حد مشترك)، أو بمفتاح read:tools	تدقّق صفحة واحدة: العنوان، والوصف، والعناوين الفرعية، وcanonical، وnoindex، والبيانات المنظَّمة، والنص البديل.
POST	/tools/llms-txt	بلا مفتاح (حد مشترك)، أو بمفتاح read:tools	تفحص ملف llms.txt لموقع، أو تنشئ ملفًا من الروابط التي ترسلها.

مثال على طلب

curl -s https://citevana.com/api/v1/tools/ai-crawlers \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

curl -s https://citevana.com/api/v1/sites \
  -H "Authorization: Bearer $CITEVANA_API_KEY"

الأخطاء

تستخدم كل الأخطاء بنية JSON نفسها الموضّحة أدناه. تشمل رموز الأخطاء invalid_request وinvalid_url وblocked_host وfetch_failed وunauthorized وinsufficient_scope وnot_found وrate_limited وquota_exceeded.

{
  "ok": false,
  "error": {
    "code": "quota_exceeded",
    "message": "Daily api_calls quota reached."
  },
  "requestId": "req_…"
}

الحدود والترويسات

تتضمن كل استجابة خاضعة للقياس X-RateLimit-Limit وX-RateLimit-Remaining وX-RateLimit-Reset (ثوانٍ بتوقيت Unix)، وهي تصف الحصة التي احتُسب عليها الاستدعاء. وتتضمن استجابة 429 أيضًا Retry-After. تُحتسب الاستدعاءات بلا مفتاح ضمن حصة الأدوات المجانية المشتركة لاتصالك بالإنترنت، وتُحتسب الاستدعاءات بالمفتاح ضمن حصة api_calls اليومية لمساحة عملك، ويمكن أن يكون لكل مفتاح حد يومي أدنى خاص به. أما الاستدعاء الذي لا يعيد أي نتيجة، لتعذّر الوصول إلى الموقع أو لأن حماية الروبوتات ردّت بدلًا منه، فلا يُحتسب إطلاقًا.

يمكن للمتصفحات استدعاء نقاط نهاية الأدوات المجانية من أي موقع دون مفتاح. أما نقاط النهاية التي تتطلب مفتاحًا فلا تسمح بطلبات المتصفح من مصادر أخرى، لذا استدعِها من خادمك.

أضف ‎?locale=es أو pt-BR أو de أو fr أو ja أو id أو hi أو tr أو vi أو ar إلى نقطة نهاية أداة للحصول على الملخص بتلك اللغة.

المصدر، تم التحقق في 16 سبتمبر 2026: https://spec.openapis.org/oas/v3.1.1.html

خادم MCP

اربط أي عميل MCP يدعم الخوادم البعيدة بـ https://citevana.com/api/mcp. يستخدم الخادم نقل Streamable HTTP، ويُجيب بصيغة JSON، ولا يحتفظ بجلسات.

check_ai_crawlers — أي زواحف البحث والمساعدات والتدريب بالذكاء الاصطناعي يسمح بها الموقع. مجانية.
audit_page — تدقيق SEO على الصفحة والجاهزية للذكاء الاصطناعي لعنوان URL واحد. مجانية.
generate_llms_txt — تنشئ ملف llms.txt من اسم الموقع وملخصه وروابطه. مجانية؛ ولا يُجلب أي شيء.
get_site_audit_summary — أحدث تدقيق لأحد مواقعك. تتطلب مفتاح API بصلاحية read:audits.

يدعم الخادم مراجعة البروتوكول 2026-07-28 (بيانات وصفية لكل طلب وserver/discover). كما يقبل مصافحة initialize من المراجعات 2025-11-25 و2025-06-18 و2025-03-26.

تعمل الأدوات المجانية الثلاث دون مصادقة، وتتشارك الحصة بلا مفتاح البالغة 3 فحصًا يوميًا لكل اتصال إنترنت. أما get_site_audit_summary فيتطلب أن يرسل عميلك مفتاح API في ترويسة Authorization: Bearer، وهو ما يرفع كذلك هذه الحصة اليومية. لا يوفّر Citevana تسجيل الدخول عبر OAuth لـ MCP بعد.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_ai_crawlers",
    "arguments": {
      "url": "https://example.com"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

المصدر، تم التحقق في 16 سبتمبر 2026: https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http

أضفه إلى ChatGPT

في ChatGPT، افتح Settings، ثم Security and login، وفعّل Developer mode. تعتمد إمكانية استخدامه على حسابك وسياسة مساحة العمل.
انتقل إلى Plugins واختر زر الإضافة.
أدخل اسمًا (مثل Citevana) ووصفًا قصيرًا.
ضمن Connection، اختر Public endpoint وأدخل https://citevana.com/api/mcp.
أنشئ الاتصال وراجع الأدوات التي يعثر عليها.

يتصل ChatGPT عبر OAuth أو دون مصادقة، ولا يمكنه إرسال مفاتيح API. تعمل الأدوات المجانية الثلاث هناك، أما get_site_audit_summary فيرد بأنه يحتاج إلى مفتاح.

المصدر، تم التحقق في 16 سبتمبر 2026: https://developers.openai.com/apps-sdk/deploy/connect-chatgpt

المصدر، تم التحقق في 16 سبتمبر 2026: https://developers.openai.com/apps-sdk/build/auth

أضفه إلى Claude

ابحث عن قسم Connectors في Claude.
انقر على Add custom connector في أسفل القسم.
أدخل عنوان URL لخادم MCP البعيد https://citevana.com/api/mcp.
الإعدادات المتقدمة (OAuth client ID وsecret) اختيارية وغير مطلوبة لهذه الأدوات. انقر على Add.

تتوفر الموصلات المخصصة في Claude وClaude Desktop لخطط Pro وMax وTeam وEnterprise. تستخدم موصلات Claude بروتوكول OAuth لتسجيل الدخول، لذا لا تتوفر هناك حاليًا إلا الأدوات المجانية.

المصدر، تم التحقق في 16 سبتمبر 2026: https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp

عملاء MCP آخرون ووكلاؤك الخاصون

إذا كان عميلك يتيح ضبط ترويسات HTTP لخادم بعيد، فأضف Authorization: Bearer متبوعًا بمفتاحك لاستخدام get_site_audit_summary. يُحتسب الاستدعاء بمفتاح ضمن حصة api_calls اليومية نفسها المستخدمة في REST API، ومن دون مفتاح يُحتسب ضمن حصة الأدوات المجانية المشتركة.

إضافة Chrome

تُشغّل إضافة Chrome من Citevana فحص زواحف الذكاء الاصطناعي وتدقيق الصفحة على التبويب الذي تعرضه عبر هذه الواجهة. لا تحتاج إلى حساب وتستخدم الحصة بلا مفتاح، ويرفع المفتاح الاختياري ذلك الحد ويعرض تدقيقات مواقعك. يجري تجهيزها لمتجر Chrome Web Store.

لا تطلب إلا صلاحيتي activeTab وstorage، إضافةً إلى الوصول إلى واجهة API من Citevana. لا ترسل عنوان الصفحة إلا عند النقر على فحص، ولا ترسل سلسلة الاستعلام أبدًا.

المصدر، تم التحقق في 16 سبتمبر 2026: https://developer.chrome.com/docs/extensions/develop/concepts/activeTab

الأمان والخصوصية

كل الأدوات للقراءة فقط. لا يتغير أي شيء في موقعك أبدًا.
يُوسَم النص المنسوخ من الصفحات المجلوبة بأنه بيانات غير موثوقة، لذا يجب ألا تتبع مساعدات الذكاء الاصطناعي أي تعليمات فيه.
لا نجلب إلا الصفحات العامة باسم CitevanaBot، ونحظر عناوين الشبكات الخاصة والمحجوزة.
لا نخزّن إلا تجزئة SHA-256 لكل مفتاح API. يُعرض المفتاح مرة واحدة، ويمكنك إلغاؤه في أي وقت. ويُسجَّل إنشاء المفاتيح وإلغاؤها في سجل التدقيق.

CitevanaBot

احصل على مفتاح API

سجّل الدخول وافتح الإعدادات، ثم مفاتيح API. اختر الصلاحيات التي يحتاجها المفتاح (read:tools وread:sites وread:audits)، ويمكنك ضبط حد يومي.

إنشاء مفتاح API

الأسئلة الشائعة

هل واجهة API من Citevana مجانية؟

نعم. لا تحتاج نقاط نهاية الأدوات إلى مفتاح، وهي تتشارك حصة الأدوات المجانية على الموقع: 3 فحصًا يوميًا تُحتسب لكل اتصال إنترنت، فيتشارك فيها كل من يقف خلف اتصال المكتب أو الحرم الجامعي نفسه. والحساب المجاني مع مفتاح API يرفع ذلك إلى حصة api_calls اليومية لخطة مساحة عملك، وهي 100 يوميًا في الخطة المجانية، ويتيح لك قراءة مواقعك وتدقيقاتك.

ما خادم MCP؟

‏MCP (بروتوكول سياق النموذج) بروتوكول مفتوح تستخدمه مساعدات الذكاء الاصطناعي لاستدعاء أدوات خارجية. بعد إضافة خادم MCP من Citevana، يمكن لمساعد مثل ChatGPT أو Claude تشغيل الفحوص نيابةً عنك داخل المحادثة.

هل يمكن للأدوات تغيير موقعي؟

لا. لا تقرأ أدوات API وMCP إلا الصفحات العامة ونتائج تدقيقك. ولا تُطبَّق الإصلاحات إلا في تطبيق Citevana، وبعد موافقتك على كل منها فقط.

ما زواحف الذكاء الاصطناعي التي يغطيها الفحص؟

يغطي OpenAI (GPTBot وOAI-SearchBot وChatGPT-User)، وAnthropic (ClaudeBot وClaude-SearchBot وClaude-User)، وPerplexity، وGoogle-Extended، وApplebot، وMeta، وAmazon، وCommon Crawl، وBing. ويرتبط كل زاحف في النتيجة بوثائق مشغّله.

ماذا يحدث عند بلوغ الحد؟

تُرجع الواجهة 429 مع الرمز quota_exceeded وترويسة Retry-After، وتُرجع أدوات MCP رسالة توضّح موعد إعادة ضبط الحد. تُعاد تهيئة الحدود عند 00:00 بتوقيت UTC. ومن دون مفتاح، تشرح الرسالة أيضًا كيفية الحصول على مفتاح API، فهو ما يرفع الحصة.