> ## 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
> n8n के AI Agent को Ayrshare MCP Server से कनेक्ट करें ताकि 13 social networks पर बिना प्रति-प्लेटफ़ॉर्म API कोड के प्रकाशित, शेड्यूल और विश्लेषण किया जा सके।
export const XByoNotice = () =>
Targeting X/Twitter? Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:
X-Twitter-OAuth1-Api-Key — Your API Key (Consumer Key)
X-Twitter-OAuth1-Api-Secret — Your API Key Secret (Consumer Secret)
One-time setup per Ayrshare account. You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do not create a new app per customer.
Not linked yet? See the full setup guide to connect your X account.
Your keys are never logged or stored by Ayrshare.
;
n8n वह जगह है जहाँ आप अपने टूल्स को एक साथ जोड़ते हैं। Ayrshare वह एक API है जो एक ही कॉल में Facebook, Instagram, LinkedIn, YouTube, TikTok, Pinterest, Reddit, Threads, Bluesky, Telegram, Google Business Profile, Snapchat, और X पर प्रकाशित करता है। उन्हें [Ayrshare MCP Server](/docs/additional/mcp-action-server) के साथ कनेक्ट करें और आपका n8n AI Agent पूरा लूप स्वयं चला सकता है: एक पोस्ट का draft तैयार करना, प्रत्येक नेटवर्क के नियमों के विरुद्ध इसे validate करना, इसे प्रकाशित या शेड्यूल करना, फिर वापस analytics पढ़ना।
चूँकि MCP Server एक hosted Streamable HTTP endpoint है, आप इसे n8n के built-in **MCP Client Tool** node के साथ कनेक्ट करते हैं। कुछ भी host करने की, कोई कस्टम कोड, और कोई community node install करने की आवश्यकता नहीं है। आप एक node को एक URL पर point करते हैं और आपके agent को सभी 27 social tools मिल जाते हैं।
ऊपर दिखाया गया workflow, import करने के लिए तैयार: Chat Trigger, AI Agent, एक Anthropic chat model, और Ayrshare MCP node validate-first system prompt के साथ पूर्व-वायर्ड।
इसका उपयोग करने के लिए: n8n में, **Workflows → Import from file**, JSON चुनें, फिर इसके अपेक्षित दो credentials बनाएँ (एक **Bearer Auth** credential जिसमें आपकी Ayrshare key हो, और एक **Anthropic API** credential)। credentials अटैच होते ही दो चेतावनी badges साफ़ हो जाते हैं। Self-hosted instances को `api.ayrshare.com` और आपके model provider के लिए outbound access चाहिए।
यह गाइड MCP-first path को अंत तक कवर करता है। यदि आप एक fixed, non-agent workflow बनाना चाहेंगे, तो अंत में एक संक्षिप्त [REST fallback](#rest-fallback-no-agent) है।
## API कॉल्स लिखने के बजाय MCP क्यों
आप एक HTTP Request node से सीधे Ayrshare के REST API को कॉल कर सकते हैं, जो fixed, अनुमानित workflows के लिए ठीक है। MCP Server अपना स्थान तब अर्जित करता है जब लूप में एक LLM हो:
- **Agent टूल चुनता है।** लक्ष्य का वर्णन करें ("इसे हमारे business channels पर प्रकाशित करें और follow-up को Tuesday के लिए शेड्यूल करें") और agent स्वयं `validate_post`, `create_post`, और सही parameters चुनता है।
- **कुछ भी लाइव होने से पहले Validation।** `validate_post` आपकी सामग्री को प्रत्येक प्लेटफ़ॉर्म की लंबाई, format, और मीडिया नियमों के विरुद्ध dry-run करता है, इसलिए agent ऐसा पोस्ट नहीं भेजता जिसे नेटवर्क अस्वीकार कर देगा।
- **एक कॉल, कई नेटवर्क।** एक `create_post` प्रत्येक linked प्लेटफ़ॉर्म पर fan out करता है।
- **Platform परिवर्तन Ayrshare की समस्या है।** जब कोई नेटवर्क अपना API बदलता है, तो Ayrshare integration बनाए रखता है और आपका workflow काम करता रहता है।
- **REST API के समान नियम।** प्रत्येक MCP tool कॉल उसी Ayrshare API chain के माध्यम से in-process चलती है: समान auth, rate limits, quota, और validation। सीखने के लिए कोई अलग व्यवहार नहीं है।
## यह कैसे कनेक्ट होता है
**AI Agent** node मस्तिष्क है। **MCP Client Tool** sub-node इसमें अटैच होता है, `https://api.ayrshare.com/mcp` पर Ayrshare MCP Server से कनेक्ट होता है, उपलब्ध tools को discover करता है, और उन्हें agent के सामने उजागर करता है। जब agent कार्य करता है, तो node कॉल को Ayrshare को dispatch करता है, जो नेटवर्क पर प्रकाशित करता है।
```
Trigger -> AI Agent (+ Chat Model) -> MCP Client Tool -> Ayrshare MCP Server -> 13 networks
```
Endpoint, transport, और authentication विवरण के लिए, [Connect & Setup](/docs/additional/mcp-action-connect) देखें। पूर्ण tool list के लिए, [Tool Catalog](/docs/additional/mcp-action-tools) देखें।
## पूर्वापेक्षाएँ
- AI Agent और MCP Client Tool nodes के साथ हाल के संस्करण पर एक **n8n instance** (Cloud या self-hosted)। MCP Client Tool node built in है। आपको community node की आवश्यकता नहीं है, क्योंकि Ayrshare server Streamable HTTP बोलता है।
- एक **Ayrshare खाता और API key** (Dashboard → Settings → API Key), या एक [निःशुल्क trial](https://billing.ayrshare.com/b/9B6bJ15Oidr9fz615u1Nu0h) शुरू करें।
- Ayrshare में **कम से कम एक social खाता linked**। Agent केवल वहीं प्रकाशित कर सकता है जहाँ आपने कनेक्ट किया है।
- AI Agent node के लिए एक **chat model credential** (Anthropic, OpenAI, आदि)।
- *(वैकल्पिक)* एक **Business या Enterprise plan** यदि आप sub-profiles के माध्यम से एकाधिक clients का प्रबंधन करेंगे।
## MCP Client Tool node सेट करें
एक workflow खोलें या बनाएँ और एक **AI Agent** node जोड़ें (*Advanced AI* nodes के अंतर्गत)।
AI Agent node पर, **Tool** connector पर क्लिक करें और एक **MCP Client Tool** node जोड़ें। इसे कॉन्फ़िगर करें:
| Field | Value |
| -------------------- | ------------------------------------------------------------- |
| **Endpoint** | `https://api.ayrshare.com/mcp` |
| **Server Transport** | `HTTP Streamable` |
| **Authentication** | `Bearer Auth` |
| **Tools to Include** | `All` (या केवल विशिष्ट tools को उजागर करने के लिए `Selected`) |
**Credential** के लिए, एक नया **Bearer Auth** credential बनाएँ और अपनी Ayrshare API key को token के रूप में paste करें। n8n इसे `Authorization: Bearer YOUR_API_KEY` के रूप में भेजता है। जब आप save करते हैं, तो n8n कनेक्ट होता है और 27 tools को list करता है।
एक **Chat Model** sub-node अटैच करें और अपना model credential चुनें। agent को एक system prompt दें जो नियम सेट करता है, उदाहरण के लिए:
> आप एक social media assistant हैं जिसकी Ayrshare tools तक पहुँच है। कुछ भी प्रकाशित करने से पहले, हमेशा पहले `validate_post` को कॉल करें और किसी भी समस्या की रिपोर्ट करें। validation पास होने के बाद ही `create_post` को कॉल करें। default रूप से user द्वारा नामित प्लेटफ़ॉर्म पर जाएँ; यदि कोई नामित नहीं है, तो पूछें। कभी भी मीडिया URLs का आविष्कार न करें; केवल user द्वारा प्रदान किए गए URLs का उपयोग करें, और संदेह होने पर उन्हें `validate_media` से पुष्टि करें।
परीक्षण के लिए, **Manual Trigger** या **Chat Trigger** सबसे आसान है। Production के लिए, जो भी workflow शुरू करता है उसका उपयोग करें (schedule, webhook, form, sheet में नई row)।
**HTTP Streamable का उपयोग करें, SSE का नहीं।** Ayrshare MCP Server आधुनिक Streamable HTTP transport का उपयोग करता है और stateless है। n8n का SSE विकल्प deprecated है, और server SSE stream को अस्वीकार करता है। हमेशा **HTTP Streamable** चुनें।
## Tool surface
आपका agent एक MCP node के माध्यम से सभी 27 tools देखता है। आप शायद ही उन्हें नाम से कॉल करते हैं; आप intent का वर्णन करते हैं और agent चुनता है। domains Posts, History, Analytics, Comments, Messages, Profiles, Media, Generate, Webhooks, और Errors हैं। प्रत्येक tool के उद्देश्य और scope के साथ पूरी सूची के लिए, [Tool Catalog](/docs/additional/mcp-action-tools) देखें।
सुरक्षा के लिए दो अलग हैं: **`validate_post`** एक पोस्ट को `create_post` के समान input के साथ dry-run करता है लेकिन कुछ भी प्रकाशित नहीं करता, और **`explain_error`** किसी भी Ayrshare error code को एक स्पष्ट English कारण और समाधान में बदल देता है, ताकि agent स्वयं-diagnose कर सके।
## उदाहरण 1: chat message से draft, validate, और publish करें
इस integration का "hello world"। एक chat message या form के साथ workflow को trigger करें, और agent को बाकी करने दें।
- **Trigger:** Chat Trigger (या "हमें क्या पोस्ट करना चाहिए?" फ़ील्ड के साथ Form Trigger)।
- **Agent को Prompt:** *"हमारे नए analytics dashboard के लिए एक मैत्रीपूर्ण launch announcement लिखें और इसे LinkedIn, Facebook, और Instagram पर प्रकाशित करें। पहले validate करें।"*
Agent स्वयं क्या करता है: यह आपकी कॉपी और तीन प्लेटफ़ॉर्म के साथ `validate_post` कॉल करता है; यदि Instagram एक missing छवि को फ़्लैग करता है तो यह विफल होने के बजाय आपको बताता है; एक बार validation पास होने पर यह `create_post` कॉल करता है और लाइव पोस्ट URLs लौटाता है। चूँकि validation पहले चलता है, आपको कुछ भी सार्वजनिक होने से पहले किसी समस्या के बारे में पता चल जाता है।
## उदाहरण 2: अपने channels में नई सामग्री auto-publish करें
बिना छुए एक सामग्री स्रोत को multi-network posts में बदलें।
- **Trigger:** आपके ब्लॉग फ़ीड पर RSS Read node, आपके CMS से webhook, या Google Sheets या Airtable में नई row।
- **AI Agent step:** *"इस लेख को 2 से 3 relevant hashtags के साथ एक छोटी social पोस्ट में summarize करें, फिर validate करें और LinkedIn, Facebook, और Threads पर प्रकाशित करें।"*
- वैकल्पिक रूप से `create_post` चरण से पहले [human-in-the-loop](#keep-a-human-in-the-loop) approval जोड़ें ताकि कोई व्यक्ति sign off करे।
आप data-driven tags के लिए `recommend_hashtags` पर भरोसा कर सकते हैं और `generate_post` यदि आप चाहते हैं कि Ayrshare आपके chat model के बजाय कॉपी का draft तैयार करे।
## उदाहरण 3: साप्ताहिक analytics digest
लूप को उल्टा चलाएँ: performance पढ़ें और इसकी रिपोर्ट करें।
- **Trigger:** Schedule node, उदाहरण के लिए हर Monday सुबह 8 बजे।
- **AI Agent step:** *"LinkedIn, Instagram, और Facebook के लिए पिछले सप्ताह के account analytics खींचें, और engagement के अनुसार top 3 posts को summarize करें।"*
- Agent account-स्तर की संख्याओं के लिए `get_social_network_analytics` का उपयोग करता है और व्यक्तिगत posts के लिए `get_post_analytics`, फिर आप इसका सारांश एक **Slack**, **Gmail**, या **Notion** node पर pipe करते हैं।
cadence पर एक नोट: अधिकांश posts को अपना अधिकांश engagement पहले 24 घंटों में मिलता है, और metrics हर सेकंड अपडेट नहीं होते। एक daily या weekly schedule बहुत है। analytics को हर कुछ मिनटों में poll न करें अन्यथा आप बिना नए डेटा के rate limits से टकराएँगे।
## Clients की ओर से कार्य करना (multi-tenant)
यदि आप एकाधिक clients के लिए social प्रबंधित करते हैं, तो Ayrshare के profiles एक खाते को linked खातों के कई अलग-अलग sets पर पोस्ट करने देते हैं। Business या Enterprise plan पर आपके पास n8n से एक client को target करने के दो तरीके हैं:
- **प्रति connection:** MCP Client Tool node पर एक `Profile-Key` header जोड़ें (**Multiple Headers** auth का उपयोग करें ताकि आप `Authorization` और `Profile-Key` दोनों भेज सकें)। उस node पर हर कॉल फिर उस client के रूप में कार्य करती है। तब अच्छा जब एक workflow एक client की सेवा करता है।
- **प्रति कॉल:** कई tools एक `profileKey` argument स्वीकार करते हैं, जिसे agent प्रति-कार्य सेट कर सकता है। जब दोनों मौजूद होते हैं, तो [प्रति-कॉल argument जीतता है](/docs/additional/mcp-action-connect#precedence-argument-wins-over-header)। तब अच्छा जब एक workflow clients के बीच route करता है।
एक नए client को onboard करने के लिए, agent `create_profile` और फिर `generate_jwt_social_linking_url` कॉल कर सकता है ताकि एक hosted पेज तैयार हो जहाँ client अपने खुद के खाते link करे। कोई credentials आपके workflow से नहीं गुज़रते।
## X/Twitter पर पोस्ट करना
n8n में, MCP Client Tool node के **Authentication** को **Multiple Headers** पर स्विच करें और `Authorization` के साथ दो `X-Twitter-OAuth1-*` headers जोड़ें। यह प्रति Ayrshare खाते के लिए एक-बार setup है, और समान key जोड़ी प्रत्येक profile पर लागू होती है। बाकी सब कुछ (Facebook, Instagram, LinkedIn, YouTube, TikTok, और शेष) के लिए कोई अतिरिक्त headers की आवश्यकता नहीं है। [Connect & Setup → X/Twitter BYO credentials](/docs/additional/mcp-action-connect#xtwitter-byo-credentials) देखें।
## लूप में एक इंसान रखें
MCP tools एक agent के लिए प्रकाशित करना trivial बनाते हैं, यही कारण है कि आपको इसे gate करना चाहिए। दो सस्ते सुरक्षा उपाय:
- **हमेशा पहले validate करें।** system prompt में "`create_post` से पहले `validate_post` कॉल करें" bake करें। Validation कुछ भी प्रकाशित नहीं करता और प्लेटफ़ॉर्म-नियम उल्लंघनों को जल्दी पकड़ता है।
- **एक approval चरण जोड़ें।** draft और publish action के बीच n8n का **Send and Wait for Response** (Slack या email) node डालें ताकि कोई व्यक्ति कुछ भी लाइव होने से पहले approve करे। शेड्यूल की गई सामग्री के लिए, agent एक awaiting-approval पोस्ट को संशोधित करने के लिए `update_post` का उपयोग कर सकता है।
## REST fallback (कोई agent नहीं)
यदि आप बिना LLM के एक fixed, deterministic workflow चाहते हैं, तो MCP को छोड़ें और एक **HTTP Request** node के साथ REST API को कॉल करें:
- **Method:** `POST`
- **URL:** `https://api.ayrshare.com/api/post`
- **Authentication:** Header Auth, `Authorization: Bearer YOUR_API_KEY`
```json theme={"system"}
{
"post": "Excited to announce our new feature!",
"platforms": ["facebook", "linkedin", "instagram"],
"mediaUrls": ["https://example.com/image.jpg"],
"scheduleDate": "2026-07-01T10:00:00Z"
}
```
API host `api.ayrshare.com` का उपयोग करें, dashboard host `app.ayrshare.com` का नहीं। (`app.ayrshare.com` API कॉल स्वीकार करेगा, लेकिन यह documented endpoint नहीं है और आंतरायिक [502/504 gateway errors](/docs/help-center/technical-support/response_bad_gateway_502_or_504_error) लौटा सकता है, इसलिए हमेशा `api.ayrshare.com` का उपयोग करें।) समान pattern अन्य [REST endpoints](/docs/apis/overview) के लिए काम करता है। यह सही टूल है जब workflow पूरी तरह से अनुमानित है और आपको कुछ भी तय करने वाले agent की आवश्यकता नहीं है।
## समस्या निवारण
| लक्षण | संभावित कारण | समाधान |
| ------------------------------------------------------------------ | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Tool कॉल `403` / code `102` लौटाती है, "API Key not valid" | खराब या missing API key | जाँचें कि Bearer Auth credential आपकी सटीक Ayrshare key धारण करता है। इसे बदलने के बाद node को re-save करें। |
| n8n MCP server से कनेक्ट नहीं हो सकता | गलत transport या endpoint | Endpoint `https://api.ayrshare.com/mcp` होना चाहिए; transport **HTTP Streamable** होना चाहिए, SSE नहीं। |
| X/Twitter पोस्ट error `419` के साथ विफल | Missing X BYO credentials | Multiple Headers auth के माध्यम से दो `X-Twitter-OAuth1-*` headers जोड़ें। |
| केवल एक प्लेटफ़ॉर्म के लिए पोस्ट विफल | वह नेटवर्क linked नहीं है, या एक आवश्यक फ़ील्ड missing है | इसे dashboard में link करें; YouTube के लिए `title`, Reddit के लिए `title` + `subreddit`, Instagram के लिए `mediaUrls` जोड़ें। |
| Instagram पोस्ट अस्वीकृत | कोई मीडिया नहीं | Instagram को अधिकांश पोस्ट प्रकारों के लिए `mediaUrls` की आवश्यकता होती है। agent से `validate_media` से पुष्टि करवाएँ। |
| एक फ़ाइल या binary के रूप में अटैच किया गया मीडिया दिखाई नहीं देता | MCP केवल JSON है | Public `mediaUrls` URL द्वारा मीडिया का संदर्भ लें; MCP path फ़ाइल अपलोड स्वीकार नहीं करता। `validate_media` से URL की पुष्टि करें। |
| कॉल्स काम करती हैं, लेकिन गलत client पर कार्य करती हैं | Profile targeting | एक `Profile-Key` header (प्रति connection) या `profileKey` argument (प्रति कॉल) सेट करें; यदि दोनों सेट हैं तो argument जीतता है। |
| `429 Too Many Requests` | बहुत बार polling | analytics और comment polling आवृत्ति कम करें; metrics हर सेकंड अपडेट नहीं होते। |
| Config परिवर्तन प्रभावी नहीं हुआ | MCP कनेक्शन session शुरू पर initialize होता है | Key या headers बदलने के बाद node को re-save करें या workflow को restart करें। |
आप agent को `explain_error` tool भी उजागर कर सकते हैं ताकि यह किसी भी Ayrshare error code को स्वयं एक कारण और समाधान में decode कर सके।
## अगले चरण
Endpoint, transport, authentication, profile targeting, और BYO credentials।
domain द्वारा समूहित 27 tools, scope और उद्देश्य के साथ।
MCP Server क्या है और यह Ayrshare API से कैसे map होता है।
समान server, Claude Code के लिए packaged।