n8n

n8n वह जगह है जहाँ आप अपने टूल्स को एक साथ जोड़ते हैं। Ayrshare वह एक API है जो एक ही कॉल में Facebook, Instagram, LinkedIn, YouTube, TikTok, Pinterest, Reddit, Threads, Bluesky, Telegram, Google Business Profile, Snapchat, और X पर प्रकाशित करता है। उन्हें Ayrshare MCP Server के साथ कनेक्ट करें और आपका n8n AI Agent पूरा लूप स्वयं चला सकता है: एक पोस्ट का draft तैयार करना, प्रत्येक नेटवर्क के नियमों के विरुद्ध इसे validate करना, इसे प्रकाशित या शेड्यूल करना, फिर वापस analytics पढ़ना।

The n8n starter workflow on the canvas: a chat trigger into an AI Agent, with an Anthropic chat model and the Ayrshare MCP tool node attached below, plus setup and usage sticky notes.

चूँकि MCP Server एक hosted Streamable HTTP endpoint है, आप इसे n8n के built-in MCP Client Tool node के साथ कनेक्ट करते हैं। कुछ भी host करने की, कोई कस्टम कोड, और कोई community node install करने की आवश्यकता नहीं है। आप एक node को एक URL पर point करते हैं और आपके agent को सभी 27 social tools मिल जाते हैं।

n8n starter workflow डाउनलोड करें

ऊपर दिखाया गया 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 है।

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 देखें। पूर्ण tool list के लिए, Tool Catalog देखें।

पूर्वापेक्षाएँ

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 शुरू करें।
Ayrshare में कम से कम एक social खाता linked। Agent केवल वहीं प्रकाशित कर सकता है जहाँ आपने कनेक्ट किया है।
AI Agent node के लिए एक chat model credential (Anthropic, OpenAI, आदि)।
(वैकल्पिक) एक Business या Enterprise plan यदि आप sub-profiles के माध्यम से एकाधिक clients का प्रबंधन करेंगे।

MCP Client Tool node सेट करें

एक AI Agent node जोड़ें

एक workflow खोलें या बनाएँ और एक AI Agent node जोड़ें (Advanced AI nodes के अंतर्गत)।

MCP Client Tool node अटैच करें

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`)

अपनी Ayrshare key को Bearer credential के रूप में जोड़ें

Credential के लिए, एक नया Bearer Auth credential बनाएँ और अपनी Ayrshare API key को token के रूप में paste करें। n8n इसे Authorization: Bearer YOUR_API_KEY के रूप में भेजता है। जब आप save करते हैं, तो n8n कनेक्ट होता है और 27 tools को list करता है।

chat model और system prompt को wire करें

एक 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 से पुष्टि करें।

एक trigger जोड़ें

परीक्षण के लिए, 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 देखें। सुरक्षा के लिए दो अलग हैं: 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 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 जीतता है। तब अच्छा जब एक 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 देखें।

लूप में एक इंसान रखें

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

{
  "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 लौटा सकता है, इसलिए हमेशा api.ayrshare.com का उपयोग करें।) समान pattern अन्य REST endpoints के लिए काम करता है। यह सही टूल है जब 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 कर सके।

अगले चरण

Connect & Setup

Endpoint, transport, authentication, profile targeting, और BYO credentials।

Tool Catalog

domain द्वारा समूहित 27 tools, scope और उद्देश्य के साथ।

MCP Server

MCP Server क्या है और यह Ayrshare API से कैसे map होता है।

Claude Code Plugin

समान server, Claude Code के लिए packaged।

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

n8n starter workflow डाउनलोड करें

API कॉल्स लिखने के बजाय MCP क्यों

यह कैसे कनेक्ट होता है

पूर्वापेक्षाएँ

MCP Client Tool node सेट करें

Tool surface

उदाहरण 1: chat message से draft, validate, और publish करें

उदाहरण 2: अपने channels में नई सामग्री auto-publish करें

उदाहरण 3: साप्ताहिक analytics digest

Clients की ओर से कार्य करना (multi-tenant)

X/Twitter पर पोस्ट करना

लूप में एक इंसान रखें

REST fallback (कोई agent नहीं)

समस्या निवारण

अगले चरण

Connect & Setup

Tool Catalog

MCP Server

Claude Code Plugin

n8n starter workflow डाउनलोड करें

​API कॉल्स लिखने के बजाय MCP क्यों

​यह कैसे कनेक्ट होता है

​पूर्वापेक्षाएँ

​MCP Client Tool node सेट करें

​Tool surface

​उदाहरण 1: chat message से draft, validate, और publish करें

​उदाहरण 2: अपने channels में नई सामग्री auto-publish करें

​उदाहरण 3: साप्ताहिक analytics digest

​Clients की ओर से कार्य करना (multi-tenant)

​X/Twitter पर पोस्ट करना

​लूप में एक इंसान रखें

​REST fallback (कोई agent नहीं)

​समस्या निवारण

​अगले चरण

Connect & Setup

Tool Catalog

MCP Server

Claude Code Plugin

API कॉल्स लिखने के बजाय MCP क्यों

यह कैसे कनेक्ट होता है

पूर्वापेक्षाएँ

MCP Client Tool node सेट करें

Tool surface

उदाहरण 1: chat message से draft, validate, और publish करें

उदाहरण 2: अपने channels में नई सामग्री auto-publish करें

उदाहरण 3: साप्ताहिक analytics digest

Clients की ओर से कार्य करना (multi-tenant)

X/Twitter पर पोस्ट करना

लूप में एक इंसान रखें

REST fallback (कोई agent नहीं)

समस्या निवारण

अगले चरण