خادم MCP لوسائل التواصل الاجتماعي: إعداده في Claude وCursor

تعرف النماذج اللغوية الكبيرة الكثير عن وسائل التواصل الاجتماعي عمومًا، ولا تعرف شيئًا تقريبًا عمّا نشره صانع محتوى هذا الصباح. والحل أن تمنح مساعدك أداة تجلب البيانات العامة الحية. يشرح هذا الدليل إعداد خادم MCP من crawlfeed في Claude Code وClaude Desktop وCursor وVS Code وWindsurf وCodex، ثم يتناول الأدوات، وأمثلة الأوامر، والتكاليف، والأخطاء التي قد تواجهك.

ما خادم MCP من crawlfeed؟

Model Context Protocol (MCP) طريقة معيارية تكتشف بها عملاء الذكاء الاصطناعي الأدوات وتستدعيها. يغلّف خادم MCP من crawlfeed واجهة crawlfeed، فيستطيع مساعدك قراءة البيانات العامة من 26 منصة، منها TikTok وInstagram وYouTube وX وReddit وLinkedIn، دون أن تكتب سطر كود واحدًا.

بعض الحقائق المهمة للإعداد:

• نقطة النهاية: https://mcp.crawlfeed.dev/mcp
• طريقة النقل: Streamable HTTP بلا حالة. لا جلسة تحتاج إلى إبقائها نشطة، ولا شيء تثبّته في العملاء التي تتعامل مع HTTP.
• المصادقة: ترويسة Authorization: Bearer sk_live_… مع مفتاح API من crawlfeed.
• الأدوات: 14، من get_profile إلى run_request العامة التي تصل إلى كل نقطة نهاية في الفهرس.

تعود النتائج بالبنية الموحّدة نفسها التي تعيدها واجهة REST: الحقل data (‏Profile أو Post أو Comment أو نتيجة بحث) مع meta مختصر يضم credits_used وcredits_remaining، وnext_cursor في النتائج المقسّمة إلى صفحات. ويُبقي meta المختصر نافذة السياق صغيرة.

ما الذي تحتاجه قبل البدء؟

شيء واحد: مفتاح API. أنشئ حسابًا، ثم أنشئ مفتاحًا من app.crawlfeed.dev/dashboard/keys. تحصل الحسابات الجديدة على 100 من الرصيد المجاني، وهذا يكفي لتجربة كل الأدوات.

يظهر المفتاح مرة واحدة فقط، فانسخه واحفظه في مكان آمن. وفي صفحة التكاملات بلوحة التحكم إعدادات جاهزة للنسخ لكل العملاء أدناه، إن كنت تفضّل اللصق على القراءة.

كيف تضيفه إلى Claude Code؟

يدعم Claude Code خوادم HTTP البعيدة والترويسات المخصصة، فيكفيك أمر واحد. صدّر مفتاحك باسم CRAWLFEED_KEY ثم شغّل:

claude mcp add --transport http crawlfeed https://mcp.crawlfeed.dev/mcp \
  --header "Authorization: Bearer $CRAWLFEED_KEY"

ابدأ جلسة جديدة وشغّل /mcp لتتأكد من اتصال crawlfeed. وأضف --scope user إن أردته متاحًا في كل مشاريعك لا في المشروع الحالي وحده.

كيف تربط Cursor؟

يقرأ Cursor خوادم MCP من .cursor/mcp.json في مشروعك (أو من ~/.cursor/mcp.json لكل المشاريع). أضف الخادم المستضاف مع مفتاحك في الترويسات:

{
  "mcpServers": {
    "crawlfeed": {
      "type": "http",
      "url": "https://mcp.crawlfeed.dev/mcp",
      "headers": {
        "Authorization": "Bearer sk_your_key_here"
      }
    }
  }
}

ضع مفتاحك مكان sk_your_key_here. وإذا كان الملف داخل مستودع، فأضفه إلى .gitignore حتى لا يُرفع المفتاح مع الكود أبدًا.

كيف تضبطه في VS Code؟

يتبع VS Code الفكرة نفسها مع فرق واحد: المفتاح في المستوى الأعلى هو servers لا mcpServers. أنشئ .vscode/mcp.json:

{
  "servers": {
    "crawlfeed": {
      "type": "http",
      "url": "https://mcp.crawlfeed.dev/mcp",
      "headers": { "Authorization": "Bearer sk_your_key_here" }
    }
  }
}

افتح Copilot Chat في وضع الوكيل، وستظهر أدوات crawlfeed في قائمة الأدوات.

كيف تربط Claude Desktop؟

يشغّل Claude Desktop خوادم محلية (stdio) من ملف إعدادات، فتصل إلى الخادم المستضاف عبر الجسر mcp-remote. يعمل على جهازك عبر npx ويحتاج إلى Node.js 18 أو أحدث. افتح Settings → Developer → Edit config لتجد claude_desktop_config.json، وأضف:

{
  "mcpServers": {
    "crawlfeed": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.crawlfeed.dev/mcp",
        "--header",
        "Authorization:${CRAWLFEED_AUTH}"
      ],
      "env": { "CRAWLFEED_AUTH": "Bearer sk_your_key_here" }
    }
  }
}

تمر الترويسة عبر متغير البيئة CRAWLFEED_AUTH لأن بعض العملاء يقسّمون الوسائط عند المسافات، وهذا يكسر Bearer sk_…. أعد تشغيل Claude Desktop بعد الحفظ.

وماذا عن Windsurf وCodex؟

يقبل Windsurf إعدادات JSON نفسها الخاصة بـ mcp-remote في Claude Desktop. الصق مُدخل crawlfeed في ملف mcp_config.json الخاص بـ Windsurf، ثم حدّث خوادم MCP فيه.

يحفظ Codex خوادم MCP في ~/.codex/config.toml. وهذا الجسر نفسه مكتوبًا بصيغة TOML:

[mcp_servers.crawlfeed]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.crawlfeed.dev/mcp", "--header", "Authorization:${CRAWLFEED_AUTH}"]
env = { CRAWLFEED_AUTH = "Bearer sk_your_key_here" }

وأي عميل آخر يشغّل خوادم stdio يعمل بالطريقة نفسها: شغّل npx -y mcp-remote مع الرابط والترويسة.

ما الأدوات التي يمنحها لمساعدك؟

تسع أدوات. الأربع الأولى تغطي معظم الأسئلة، وrun_request تغطي كل ما عدا ذلك في الفهرس.

وتقبل أدوات البيانات أيضًا fresh (لتجاوز التخزين المؤقت، بضعف السعر) وenrich (اللهجة العربية والمشاعر لكل عنصر، مقابل 3 أرصدة إضافية).

أداتان تستحقان نظرة أقرب. search مع المصفوفة platforms تبحث في عدة منصات في طلب واحد. المنصات التي تتجاوز المهلة الزمنية تكتمل في الخلفية، وتحمل النتيجة meta.job_id. يتابعها مساعدك عبر run_request مع op_id بالقيمة job، وذلك مجاني. أما run_request فتصل إلى العمليات الموسّعة، مثل المتابعين والنصوص المفرّغة والوسوم والرائج والإعلانات والمتاجر. ويجد المساعد قيمة op_id لكل منها ومُعاملاتها عبر list_endpoints.

ماذا يمكنك أن تسأل بعد الربط؟

اسأل بلغة عادية، والمساعد يختار الأدوات. بعض الأوامر التي تعمل جيدًا:

• «اجلب الملف الشخصي على TikTok لـ @charlidamelio ولخّص آخر 10 فيديوهات لها حسب المشاهدات».
• «قارن أعداد متابعي @nasa على Instagram وX وYouTube في جدول».
• «اسحب أبرز التعليقات على فيديو YouTube هذا وصنّفها حسب المشاعر». (الصق معرّف الفيديو.)
• «ابحث في TikTok وInstagram وYouTube عن ‹وصفة ماتشا لاتيه› واعرض النتائج الخمس الأعلى مشاهدةً».
• «اجلب النص المفرّغ لفيديو TikTok هذا واكتب ملخصًا من سطرين».
• «كم رصيدي في crawlfeed، وكم عملية بحث عن ملف شخصي يغطي؟»

وللعمل المتكرر، حدّد للمساعد ميزانية: «لا تستخدم أكثر من 20 رصيدًا». فكل نتيجة تتضمن meta.credits_used، فيستطيع أن يتابع العدّ.

كم تكلّف؟

تكلّف أدوات MCP بالضبط ما يكلّفه طلب REST نفسه، لأنها تستدعي الواجهة نفسها بمفتاحك. معظم المنصات تحتسب رصيدًا واحدًا لكل طلب: الملف الشخصي على Instagram يكلّف رصيد واحد، وصفحة فيديوهات YouTube تكلّف رصيد واحد. والعمليات الأثقل تكلّف أكثر؛ فالنص المفرّغ لفيديو TikTok يكلّف 10 أرصدة.

القواعد التي تجعل الفواتير متوقعة:

• كل صفحة تُحتسب. التنقل عبر 10 صفحات من المنشورات يعني 10 طلبات.
• البحث في عدة منصات يُحتسب لكل منصة يُبحث فيها، وتُستردّ قيمة ما يفشل منها.
• list_endpoints وget_balance ومتابعة المهام مجانية.
• تُستردّ قيمة الطلبات الفاشلة، فإعادة المحاولة لا تحاسبك مرتين أبدًا.

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

لماذا لا يعمل خادم MCP من crawlfeed؟

تحتفظ الأخطاء بقيم code الثابتة نفسها التي في الواجهة، فيسهل تشخيصها:

كذلك تأخذ search إما platform أو platforms، لا الاثنين معًا؛ فتمريرهما معًا يعيد invalid_request. وبعد تعديل أي ملف إعدادات، أعد تشغيل العميل أو أعد تحميل خوادم MCP فيه.

إلى أين بعد ذلك؟

إذا كنت تختار بين MCP وأداة REST وAgent Skill وllms.txt لوكيلك الخاص، فاقرأ كيف تزوّد وكلاء الذكاء الاصطناعي ببيانات وسائل التواصل الاجتماعي. ولتفاصيل كل منصة، اطّلع على كيف تجمع بيانات TikTok وكيف تجمع بيانات YouTube. والمرجع الكامل للواجهة في التوثيق.