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

# n8n

> ادمج API الوسائط الاجتماعية Ayrshare في سير عمل n8n الخاص بك للنشر والجدولة وتحليل حسابات وسائط التواصل الاجتماعي لمستخدميك.

export const XByoNotice = () => <Info>
  <strong>Targeting X/Twitter?</strong> Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:
  <br /><br />
  <code>X-Twitter-OAuth1-Api-Key</code> — Your API Key (Consumer Key)<br />
  <code>X-Twitter-OAuth1-Api-Secret</code> — Your API Key Secret (Consumer Secret)
  <br /><br />
  <strong>One-time setup per Ayrshare account.</strong> You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do <em>not</em> create a new app per customer.
  <br /><br />
  Not linked yet? See the <a href="/docs/dashboard/connect-social-accounts/x-twitter-byo-keys">full setup guide</a> to connect your X account.
  <br /><br />
  Your keys are never logged or stored by Ayrshare.
</Info>;

## نظرة عامة

[n8n](https://n8n.io) هي منصة أتمتة سير العمل التي تتيح لك ربط التطبيقات وتنسيق العمليات، بما في ذلك عملاء الذكاء الاصطناعي، على السحابة أو مستضافة ذاتيًا.

يمكن دمج API الوسائط الاجتماعية Ayrshare في سير عمل n8n الخاص بك لإدارة حسابات وسائط التواصل الاجتماعي لمستخدميك. استدعاء API واحد ينشر على Facebook وInstagram وLinkedIn وYouTube وTikTok وPinterest وReddit وThreads وBluesky وTelegram وGoogle Business Profile وSnapchat وX، لذلك لا تكتب أو تحافظ على كود API لكل منصة.

هناك طريقتان للاتصال:

<ul class="custom-bullets">
  <li>**MCP Server (يقوده الوكيل).** أرفق [Ayrshare MCP Server](/docs/additional/mcp-action-server) بعقدة MCP Client Tool المدمجة في n8n، ويمكن لوكيل الذكاء الاصطناعي الخاص بك تشغيل الحلقة بأكملها بمفرده: صياغة منشور، والتحقق منه مقابل قواعد كل شبكة، ونشره أو جدولته، ثم قراءة التحليلات مرة أخرى. لا يوجد شيء لاستضافته ولا عقدة مجتمعية لتثبيتها.</li>
  <li>**REST API (سير عمل ثابت).** لسير العمل الحتمي غير المستند إلى الوكيل، اتصل بـ [Ayrshare REST API](/docs/apis/overview) مباشرةً من عقدة HTTP Request.</li>
</ul>

تتطلب إدارة الحسابات الاجتماعية لمستخدميك [Business plan](/docs/multiple-users/business-plan-overview)، ولكن يمكنك بالمثل إدارة حساباتك الاجتماعية الخاصة باستخدام Premium plan فقط باستخدام [API Key](/docs/apis/overview#authorization) في رأس الطلب.

## كيف يتصل

مع مسار MCP، تكون عقدة **AI Agent** هي الدماغ. تُرفق عقدة **MCP Client Tool** الفرعية بها، وتتصل بـ Ayrshare MCP Server، وتكتشف الأدوات المتاحة، وتعرضها للوكيل. عندما يتصرف الوكيل، ترسل العقدة الاستدعاء إلى Ayrshare، الذي ينشر على الشبكات.

```
Trigger  ->  AI Agent (+ Chat Model)  ->  MCP Client Tool  ->  Ayrshare MCP Server  ->  social networks
```

<Note>
  استخدم نقل **HTTP Streamable**، وليس SSE. يغطي [دليل n8n](/docs/additional/mcp-n8n) النقل والمصادقة والإعداد بالتفصيل.
</Note>

## الدليل

يغطي دليل n8n الكامل مسار MCP-first من البداية إلى النهاية: المتطلبات المسبقة، وإعداد عقدة MCP Client Tool، وموجه النظام "التحقق أولاً"، والأمثلة العملية (صياغة ونشر من رسالة دردشة، والنشر التلقائي للمحتوى الجديد، وملخص تحليلات أسبوعي)، والعمل نيابة عن العملاء بملفات شخصية فرعية، وإبقاء الإنسان في الحلقة، واحتياطي REST، واستكشاف الأخطاء وإصلاحها.

<Card title="دليل n8n + Ayrshare MCP" icon="book-open" href="/docs/additional/mcp-n8n" horizontal>
  قم بتوصيل AI Agent الخاص بـ n8n بـ Ayrshare MCP Server للنشر والجدولة والتحليل عبر شبكاتك الاجتماعية، دون كود API لكل منصة.
</Card>

<Card title="نزّل سير عمل n8n المبدئي" icon="download" href="/docs/files/ayrshare-n8n-mcp-workflow.json" horizontal>
  سير عمل جاهز للاستيراد: Chat Trigger، وAI Agent، ونموذج دردشة Anthropic، وعقدة Ayrshare MCP موصولة مسبقًا مع موجه النظام "التحقق أولاً".
</Card>

## النشر على X (المعروف سابقًا بـ Twitter)

<XByoNotice />

في n8n، بدّل **Authentication** لعقدة MCP Client Tool إلى **Multiple Headers** وأضف رأسي `X-Twitter-OAuth1-*` جنبًا إلى جنب مع `Authorization`. راجع [Connect & Setup → X/Twitter BYO credentials](/docs/additional/mcp-action-connect#xtwitter-byo-credentials).

## تعرف على المزيد

<ul class="custom-bullets">
  <li>تعرّف على المزيد حول [n8n](https://n8n.io) وعقدتي [AI Agent](https://docs.n8n.io/advanced-ai/) و[MCP Client Tool](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/).</li>
  <li>راجع [نظرة عامة على MCP Server](/docs/additional/mcp-action-server) لما هو الخادم وكيف يرتبط بـ Ayrshare API.</li>
  <li>تصفح [كتالوج الأدوات](/docs/additional/mcp-action-tools) للأدوات التي يمكن لوكيلك استدعاؤها، مجمعة حسب المجال.</li>
  <li>اقرأ [Connect & Setup](/docs/additional/mcp-action-connect) للحصول على تفاصيل نقطة النهاية والنقل والمصادقة واستهداف الملف الشخصي.</li>
</ul>