المطوّرون

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

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

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

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

عنوان URL الأساسي لـ REST: https://citevana.com/api/v1
المصادقة: لا شيء للأدوات المجانية. وفي غير ذلك مفتاح API لمساحة العمل: Authorization: Bearer cv_live_…
الحصة المجانية: 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.

تعمل الأدوات المجانية الثلاث دون مصادقة. أما 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 مجانية؟

نعم. لا تحتاج الأدوات المجانية إلى مفتاح وتسمح بـ 100 استدعاء يوميًا لكل عنوان IP. ومع المفتاح، تُحتسب الاستدعاءات ضمن حصة 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.