> ## 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.

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

> الأدوات الـ 27 التي يعرضها Ayrshare MCP Server — المنشورات والسجل والتحليلات والتعليقات والرسائل المباشرة والملفات الشخصية والوسائط والتوليد وWebhooks والأخطاء — مجمّعة حسب المجال مع النطاق والغرض.

يعرض [MCP Server](/additional/mcp-action-server) الخاص بـ Ayrshare **27 أداة**، مجمّعة أدناه حسب المجال. يتم توزيع كل أداة داخل العملية عبر سلسلة API الحقيقية لـ Ayrshare.

## النطاق

كل أداة إمّا بنطاق **Profile** أو **Account**:

<ul class="custom-bullets">
  <li>**Profile** — تقبل الأداة وسيطًا `profileKey` لاستهداف ملف شخصي فرعي.</li>
  <li>**Account** — الأداة **لا** تأخذ `profileKey`؛ تعمل على مستوى الحساب.</li>
</ul>

الأدوات الست التي **لا** تأخذ وسيط `profileKey` هي: `create_profile`، و`list_profiles`، و`explain_error`، و`validate_media`، و`generate_post`، و`recommend_hashtags`. جميع الأدوات الأخرى تقبل `profileKey`؛ و`generate_jwt_social_linking_url` **يتطلبه**. ملاحظة: `recommend_hashtags` لا يأخذ وسيط `profileKey` لكنه يقرأ رأس `Profile-Key` الخاص بالاتصال لاختيار حساب TikTok المرتبط الذي يعتمد عليه، لذا فإن نتائجه خاصة بالملف الشخصي.

عند وجود كل من وسيط `profileKey` لكل استدعاء ورأس `Profile-Key`، يفوز الوسيط. راجع [الاتصال والإعداد](/additional/mcp-action-connect#precedence-argument-wins-over-header) لمعرفة قواعد الأسبقية.

## المنشورات

| الأداة          | النطاق  | الغرض                                             |
| --------------- | ------- | ------------------------------------------------- |
| `create_post`   | Profile | النشر على منصة واحدة أو أكثر من المنصات المرتبطة. |
| `validate_post` | Profile | تحقق تجريبي، بنفس مدخلات `create_post`.           |
| `get_post`      | Profile | جلب منشور بواسطة معرّف المنشور في Ayrshare.       |
| `update_post`   | Profile | تحديث منشور مجدول أو بانتظار الموافقة.            |
| `retry_post`    | Profile | إعادة إرسال منشور فاشل.                           |

## السجل

| الأداة                 | النطاق  | الغرض                                                                                                                                                                                                                                |
| ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `get_post_history`     | Profile | المنشورات المُرسلة عبر Ayrshare.                                                                                                                                                                                                     |
| `get_platform_history` | Profile | المنشورات والتحليلات مباشرةً من الشبكة، بما في ذلك المنشورات غير الصادرة عبر Ayrshare. للبحث عن `userId`/`userName` في X/Twitter، استخدم مفتاح API للحساب فقط؛ فإن تمرير وسيط `profileKey` أو رأس `Profile-Key` هناك يعيد الخطأ 400. |

## التحليلات

| الأداة                            | النطاق  | الغرض                                                                                                                                                                                                   |
| --------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_post_analytics`              | Profile | مقاييس لكل منشور بواسطة معرّف المنشور في Ayrshare.                                                                                                                                                      |
| `get_post_analytics_by_social_id` | Profile | مقاييس لكل منشور بواسطة معرّف المنشور الاجتماعي الأصلي.                                                                                                                                                 |
| `get_social_network_analytics`    | Profile | تحليلات وديموغرافيات على مستوى الحساب لحساب اجتماعي متصل. للبحث عن `userId`/`userName` في X/Twitter، استخدم مفتاح API للحساب فقط؛ فإن تمرير وسيط `profileKey` أو رأس `Profile-Key` هناك يعيد الخطأ 400. |

## التعليقات

| الأداة          | النطاق  | الغرض                      |
| --------------- | ------- | -------------------------- |
| `get_comments`  | Profile | قراءة التعليقات على منشور. |
| `add_comment`   | Profile | تعليق من المستوى الأعلى.   |
| `reply_comment` | Profile | الرد على تعليق.            |

## الرسائل / DMs

| الأداة              | النطاق  | الغرض                                             |
| ------------------- | ------- | ------------------------------------------------- |
| `get_messages`      | Profile | جلب الرسائل المباشرة لمنصة.                       |
| `send_message`      | Profile | إرسال رسالة مباشرة.                               |
| `get_auto_response` | Profile | قراءة إعدادات الرد التلقائي على الرسائل المباشرة. |
| `set_auto_response` | Profile | تكوين الرد التلقائي على الرسائل المباشرة.         |

## الملفات الشخصية

| الأداة                            | النطاق  | الغرض                                            |
| --------------------------------- | ------- | ------------------------------------------------ |
| `list_profiles`                   | Account | سرد الملفات الشخصية الفرعية.                     |
| `create_profile`                  | Account | إنشاء ملف شخصي فرعي.                             |
| `generate_jwt_social_linking_url` | Profile | إصدار رابط ربط اجتماعي JWT (يتطلب `profileKey`). |

## الوسائط

| الأداة           | النطاق  | الغرض                                                                        |
| ---------------- | ------- | ---------------------------------------------------------------------------- |
| `validate_media` | Account | فحص HEAD للتأكد من إمكانية الوصول إلى عنوان URL للوسائط؛ يعيد `contentType`. |

## التوليد

| الأداة               | النطاق  | الغرض                                                                                                                                                            |
| -------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `generate_post`      | Account | صياغة نص منشور بالذكاء الاصطناعي.                                                                                                                                |
| `recommend_hashtags` | Account | اقتراحات الوسوم من بيانات عدد المشاهدات على TikTok. يستخدم حساب TikTok المرتبط بالملف الشخصي المحدد بواسطة رأس `Profile-Key`؛ ولا يأخذ `profileKey` لكل استدعاء. |

## Webhooks

| الأداة               | النطاق  | الغرض                 |
| -------------------- | ------- | --------------------- |
| `register_webhook`   | Profile | تسجيل webhook.        |
| `unregister_webhook` | Profile | إلغاء تسجيل webhook.  |
| `list_webhooks`      | Profile | سرد webhooks المسجلة. |

## الأخطاء

| الأداة          | النطاق  | الغرض                                                  |
| --------------- | ------- | ------------------------------------------------------ |
| `explain_error` | Account | فك ترميز رمز خطأ Ayrshare إلى السبب والتصنيف والإصلاح. |

<Info>
  تم التحقق من هذا الكتالوج مقابل `tools/list` الخاص بالخادم المباشر. يُخطط لإضافة المزيد من الأدوات (مثل أدوات Links). في حالة الشك، استعلم `tools/list` للحصول على المجموعة المعتمدة. يتم صيانة الكتالوج بواسطة فريق MCP server.
</Info>