الانتقال إلى المحتوى الرئيسي
تجمع إضافة Ayrshare لـ Claude Code إعدادات خادم MCP، وأمر الإعداد، والوكلاء (agents)، والمهارات (skills)، وخطاف أمان. بعد تثبيتها، يمكنك نشر المنشورات، وجلب السجل والتحليلات، وإدارة الملفات الشخصية، والمزيد — مباشرةً من داخل Claude Code. قبل نشر أي شيء، يتحقق الوكيل من كل منشور وفقًا لقواعد الشبكة المستهدفة ويطلب منك التأكيد، ممّا يمنع الرفض القابل للتفادي مسبقًا. سجل المنشورات متاح لمطابقة صوت العلامة التجارية، ويمكن قراءة التحليلات للاستفادة منها في المنشور التالي. الإضافة مفتوحة المصدر. راجع المستودع للاطلاع على التفاصيل الداخلية: ayrshare/ayrshare-social-media-api-claude-plugin.

​
التثبيت

1

إضافة المتجر (لمرة واحدة)

2

تثبيت الإضافة

​
نطاقات التثبيت

يستخدم واجهة سطر أوامر Claude Code التسمية --scope user للنطاق العام.

​
بيانات الاعتماد

قدّم مفتاح Ayrshare API الخاص بك بإحدى الطريقتين التاليتين:
  • شغّل /ayrshare:setup لتهيئة المفتاح أو تدويره.
  • عيّن متغير البيئة AYRSHARE_API_KEY.
يعلن ملف .mcp.json المُرفق مع الإضافة بالفعل عن رأس Authorization بالإضافة إلى الرأسين الاختياريين Profile-Key وX BYOK، ولكل منها قيمة افتراضية فارغة (${VAR:-})، لذا يمكنك تفعيل رأس ببساطة عبر تعيين متغير البيئة الخاص به (يستبدل Claude Code القيم عند بدء التشغيل). لاستهداف ملف شخصي فرعي في كل استدعاء، عيّن AYRSHARE_PROFILE_KEY (عبر /ayrshare:setup أو كتلة env في settings.json) وأعد تشغيل Claude Code؛ يحمل رأس Profile-Key المُرفق هذه القيمة، ويبقى فارغًا (يُعامل كأنه غير مُقدَّم) عند عدم تعيينه. لاستهداف ملف شخصي فرعي لاستدعاء واحد فقط، مرّر وسيط الأداة profileKey (دون الحاجة إلى تغيير الإعدادات). لا يلزمك تعديل ملف .mcp.json المُرفق، ولا ينبغي لك ذلك، لأن أمر claude plugin update سيستبدله.
يُهيَّأ خادم MCP عند بدء الجلسة. أعد تشغيل Claude Code بعد تثبيت الإضافة أو تغيير مفتاحك.

​
بيانات اعتماد BYO لـ X/Twitter

يتطلب النشر على X/Twitter بيانات اعتماد تطبيق X Developer الخاصة بك (اشتراط X BYO-key، الساري اعتبارًا من 31 مارس 2026؛ راجع نظرة عامة على واجهة API). يعلن ملف .mcp.json المُرفق بالفعل عن رأسي X BYOK بقيم افتراضية فارغة، إلى جانب Authorization وProfile-Key:
لذلك ما عليك سوى تعيين متغيرات البيئة المطابقة (X_TWITTER_OAUTH1_API_KEY، X_TWITTER_OAUTH1_API_SECRET) عبر /ayrshare:setup أو env في settings.json، ثم أعد تشغيل Claude Code؛ لا تعدّل ملف .mcp.json المُرفق (لأنه يُستبدل عند claude plugin update). عيّن الاثنين معًا أو لا تعيّن أيًّا منهما: إذا لم يُعيَّن أيٌّ منهما فإن استدعاء X/Twitter يُرجع الخطأ 419 (x_credentials_required)؛ وإذا عُيّن واحد فقط فإنه يُرجع الخطأ 400. هذا هو زوج مفاتيح واحد لكل حساب Ayrshare، يُرسل مع كل طلب يستهدف X (نفس الزوج لجميع الملفات الشخصية الفرعية).
تفضّل الاتصال المباشر بدلًا من الإضافة؟ يمكن تمرير رؤوس BYO نفسها عبر claude mcp add --header — راجع الاتصال والإعداد ← بيانات اعتماد BYO لـ X/Twitter.

​
ما تتضمنه الإضافة

​
الأمر

  • /ayrshare:setup — تهيئة مفتاح Ayrshare API أو تدويره.

​
الوكلاء

  • social-manager: ينشر المحتوى ويجدوله ويحلّله عبر المنصات.
  • profile-manager: ينشئ الملفات الشخصية ويسردها ويُصدر عناوين URL بصيغة JWT لربط الحسابات الاجتماعية لملفات العملاء ضمن حساب Business.
  • insights-analyst: تقارير للقراءة فقط. يسحب المقاييس وسجل المنشورات ويلخّص الأداء؛ لا ينشر أبدًا ولا يُعلّق ولا يُرسل رسائل ولا يعدّل أي شيء.

​
المهارات

​
خطاف التأكيد

يطلب خطاف PreToolUse تأكيدًا قبل أي إجراء نشر أو إرسال. وهو يغطي هذه الأدوات السبع تحديدًا:
  • create_post
  • update_post
  • retry_post
  • add_comment
  • reply_comment
  • send_message
  • set_auto_response

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

نعم. تُشغّل الإضافة validate_post لتنفيذ محاكاة تجريبية لمحتواك وفق قواعد كل شبكة — الطول والتنسيق ومتطلبات الوسائط — قبل النشر، لتتمكن من تلافي الرفض القابل للتفادي مسبقًا.
نعم. يطلب خطاف تأكيد PreToolUse منك الموافقة قبل أي إجراء نشر أو إرسال: create_post، update_post، retry_post، add_comment، reply_comment، send_message، وset_auto_response.
نعم. تقرأ مهارة draft-in-brand-voice سجل منشوراتك لصياغة نصوص جديدة بصوت متسق للعلامة التجارية. تنتج مسودات فقط — ولا يُنشر شيء بدون تأكيدك.
نعم. تُرجع أدوات التحليلات مقاييس على مستوى المنشور والحساب، بحيث يمكنك قراءة النتائج والاستعانة بها في إعداد المنشور التالي.
مفتاح Ayrshare API (مفتاح Business Plan للملفات الشخصية والملفات الفرعية) وClaude Code. اضبط المفتاح عبر /ayrshare:setup أو متغير البيئة AYRSHARE_API_KEY، ثم أعد تشغيل Claude Code.
نعم. يتطلب X/Twitter بيانات اعتماد OAuth 1.0a الخاصة بك، تُضاف عبر رأسين للاتصال (X-Twitter-OAuth1-Api-Key وX-Twitter-OAuth1-Api-Secret). راجع بيانات اعتماد BYO لـ X/Twitter أعلاه.

​
الخطوات التالية

الاتصال والإعداد

المصادقة واستهداف الملف الشخصي وبيانات اعتماد BYO.

كتالوج الأدوات

الأدوات الـ 27 مصنّفة حسب النطاق، مع الغرض والصلاحيات.