> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# إضافة Claude Code

> ثبّت إضافة Ayrshare لـ Claude Code لنشر منشورات وسائل التواصل الاجتماعي وجدولتها وتحليلها من داخل محرّرك — مع التحقق قبل النشر، ومطالبة تأكيد قبل النشر، وصياغة المحتوى بصوت العلامة التجارية، وقراءة التحليلات.

تجمع إضافة Ayrshare لـ Claude Code إعدادات [خادم MCP](/additional/mcp-action-server)، وأمر الإعداد، والوكلاء (agents)، والمهارات (skills)، وخطاف أمان. بعد تثبيتها، يمكنك نشر المنشورات، وجلب السجل والتحليلات، وإدارة الملفات الشخصية، والمزيد — مباشرةً من داخل Claude Code. قبل نشر أي شيء، يتحقق الوكيل من كل منشور وفقًا لقواعد الشبكة المستهدفة ويطلب منك التأكيد، ممّا يمنع الرفض القابل للتفادي مسبقًا. سجل المنشورات متاح لمطابقة صوت العلامة التجارية، ويمكن قراءة التحليلات للاستفادة منها في المنشور التالي.

الإضافة مفتوحة المصدر. راجع المستودع للاطلاع على التفاصيل الداخلية: [ayrshare/ayrshare-social-media-api-claude-plugin](https://github.com/ayrshare/ayrshare-social-media-api-claude-plugin).

## التثبيت

<Steps>
  <Step title="إضافة المتجر (لمرة واحدة)">
    ```bash theme={"system"}
    claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin
    ```
  </Step>

  <Step title="تثبيت الإضافة">
    ```bash theme={"system"}
    claude plugin install ayrshare@ayrshare
    ```
  </Step>
</Steps>

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

| النطاق            | مجال التطبيق                                    |
| ----------------- | ----------------------------------------------- |
| Global (افتراضي)  | كل مشروع على هذا الجهاز.                        |
| `--scope local`   | المشروع الحالي فقط، دون تضمينه في git.          |
| `--scope project` | المشروع الحالي، مُضمَّن في git ومشترك مع فريقك. |

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

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

قدّم مفتاح Ayrshare API الخاص بك بإحدى الطريقتين التاليتين:

<ul class="custom-bullets">
  <li>شغّل `/ayrshare:setup` لتهيئة المفتاح أو تدويره.</li>
  <li>عيّن متغير البيئة `AYRSHARE_API_KEY`.</li>
</ul>

يعلن ملف `.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` سيستبدله.

<Warning>
  يُهيَّأ خادم MCP عند بدء الجلسة. **أعد تشغيل Claude Code** بعد تثبيت الإضافة أو تغيير مفتاحك.
</Warning>

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

يتطلب النشر على X/Twitter بيانات اعتماد تطبيق X Developer الخاصة بك (اشتراط X BYO-key، الساري اعتبارًا من 31 مارس 2026؛ راجع [نظرة عامة على واجهة API](/apis/overview#xtwitter-byo-credentials)). يعلن ملف `.mcp.json` المُرفق بالفعل عن رأسي X BYOK بقيم افتراضية فارغة، إلى جانب `Authorization` و`Profile-Key`:

```json theme={"system"}
"headers": {
  "Authorization": "Bearer ${AYRSHARE_API_KEY}",
  "Profile-Key": "${AYRSHARE_PROFILE_KEY:-}",
  "X-Twitter-OAuth1-Api-Key": "${X_TWITTER_OAUTH1_API_KEY:-}",
  "X-Twitter-OAuth1-Api-Secret": "${X_TWITTER_OAUTH1_API_SECRET:-}"
}
```

لذلك ما عليك سوى تعيين متغيرات البيئة المطابقة (`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 (نفس الزوج لجميع الملفات الشخصية الفرعية).

<Note>
  تفضّل الاتصال المباشر بدلًا من الإضافة؟ يمكن تمرير رؤوس BYO نفسها عبر `claude mcp add --header` — راجع [الاتصال والإعداد ← بيانات اعتماد BYO لـ X/Twitter](/additional/mcp-action-connect#xtwitter-byo-credentials).
</Note>

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

### الأمر

<ul class="custom-bullets">
  <li>`/ayrshare:setup` — تهيئة مفتاح Ayrshare API أو تدويره.</li>
</ul>

### الوكلاء

<ul class="custom-bullets">
  <li>`social-manager`: ينشر المحتوى ويجدوله ويحلّله عبر المنصات.</li>
  <li>`profile-manager`: ينشئ الملفات الشخصية ويسردها ويُصدر عناوين URL بصيغة JWT لربط الحسابات الاجتماعية لملفات العملاء ضمن حساب Business.</li>
  <li>`insights-analyst`: تقارير للقراءة فقط. يسحب المقاييس وسجل المنشورات ويلخّص الأداء؛ لا ينشر أبدًا ولا يُعلّق ولا يُرسل رسائل ولا يعدّل أي شيء.</li>
</ul>

### المهارات

| المهارة                      | الغرض                                                    |
| ---------------------------- | -------------------------------------------------------- |
| `getting-started`            | التوجيه والاتصال لأول استخدام.                           |
| `post`                       | إنشاء المنشورات والتحقق منها وتحديثها وإعادة محاولتها.   |
| `history`                    | جلب سجل المنشورات والمنصات.                              |
| `analytics`                  | سحب تحليلات المنشور والحساب.                             |
| `comments`                   | قراءة التعليقات وإضافتها والرد عليها.                    |
| `messages`                   | قراءة الرسائل المباشرة وإرسالها وتهيئة الردود التلقائية. |
| `profiles`                   | إنشاء الملفات الشخصية الفرعية وسردها.                    |
| `media`                      | التحقق من إمكانية الوصول إلى عناوين URL للوسائط.         |
| `generate`                   | صياغة نصوص المنشورات بالذكاء الاصطناعي والتوصية بالوسوم. |
| `webhooks`                   | تسجيل webhooks وإلغاء تسجيلها وسردها.                    |
| `errors`                     | فكّ رموز أخطاء Ayrshare.                                 |
| `draft-in-brand-voice`       | صياغة نصوص المنشورات بصوت متسق للعلامة التجارية.         |
| `plan-and-schedule-campaign` | تخطيط حملة متعددة المنشورات وجدولتها.                    |

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

يطلب خطاف `PreToolUse` تأكيدًا قبل أي إجراء نشر أو إرسال. وهو يغطي هذه الأدوات السبع تحديدًا:

<ul class="custom-bullets">
  <li>`create_post`</li>
  <li>`update_post`</li>
  <li>`retry_post`</li>
  <li>`add_comment`</li>
  <li>`reply_comment`</li>
  <li>`send_message`</li>
  <li>`set_auto_response`</li>
</ul>

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

<AccordionGroup>
  <Accordion title="هل تتحقق الإضافة من المنشورات قبل النشر؟">
    نعم. تُشغّل الإضافة `validate_post` لتنفيذ محاكاة تجريبية لمحتواك وفق قواعد كل شبكة — الطول والتنسيق ومتطلبات الوسائط — قبل النشر، لتتمكن من تلافي الرفض القابل للتفادي مسبقًا.
  </Accordion>

  <Accordion title="هل تسأل قبل النشر على حساباتي الحيّة؟">
    نعم. يطلب خطاف تأكيد `PreToolUse` منك الموافقة قبل أي إجراء نشر أو إرسال: `create_post`، `update_post`، `retry_post`، `add_comment`، `reply_comment`، `send_message`، و`set_auto_response`.
  </Accordion>

  <Accordion title="هل يمكن للإضافة مطابقة صوت علامتي التجارية؟">
    نعم. تقرأ مهارة `draft-in-brand-voice` سجل منشوراتك لصياغة نصوص جديدة بصوت متسق للعلامة التجارية. تنتج مسودات فقط — ولا يُنشر شيء بدون تأكيدك.
  </Accordion>

  <Accordion title="هل يمكنني قراءة التحليلات للاستفادة منها في المنشور التالي؟">
    نعم. تُرجع أدوات التحليلات مقاييس على مستوى المنشور والحساب، بحيث يمكنك قراءة النتائج والاستعانة بها في إعداد المنشور التالي.
  </Accordion>

  <Accordion title="ما الذي أحتاج إليه لاستخدام الإضافة؟">
    مفتاح Ayrshare API (مفتاح Business Plan للملفات الشخصية والملفات الفرعية) وClaude Code. اضبط المفتاح عبر `/ayrshare:setup` أو متغير البيئة `AYRSHARE_API_KEY`، ثم أعد تشغيل Claude Code.
  </Accordion>

  <Accordion title="هل يحتاج النشر على X/Twitter إلى إعداد إضافي؟">
    نعم. يتطلب X/Twitter بيانات اعتماد OAuth 1.0a الخاصة بك، تُضاف عبر رأسين للاتصال (`X-Twitter-OAuth1-Api-Key` و`X-Twitter-OAuth1-Api-Secret`). راجع [بيانات اعتماد BYO لـ X/Twitter](#xtwitter-byo-credentials) أعلاه.
  </Accordion>
</AccordionGroup>

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

<CardGroup cols={2}>
  <Card title="الاتصال والإعداد" icon="plug" href="/additional/mcp-action-connect" horizontal>
    المصادقة واستهداف الملف الشخصي وبيانات اعتماد BYO.
  </Card>

  <Card title="كتالوج الأدوات" icon="list" href="/additional/mcp-action-tools" horizontal>
    الأدوات الـ 27 مصنّفة حسب النطاق، مع الغرض والصلاحيات.
  </Card>
</CardGroup>