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

> Claude Code के लिए Ayrshare plugin स्थापित करें ताकि आप अपने editor से सोशल पोस्ट्स को publish, schedule और analyze कर सकें — प्री-पब्लिश वैलिडेशन, कन्फ़र्म-बिफोर-पब्लिश prompt, ब्रांड-वॉइस ड्राफ्टिंग और एनालिटिक्स रीड-बैक के साथ।

Claude Code के लिए Ayrshare plugin [MCP Server](/additional/mcp-action-server) कॉन्फ़िगरेशन, एक setup कमांड, agents, skills और एक सुरक्षा hook को बंडल करता है। इसके स्थापित होने पर, आप Claude Code से सीधे पोस्ट publish कर सकते हैं, history और analytics प्राप्त कर सकते हैं, profiles प्रबंधित कर सकते हैं, और भी बहुत कुछ। कुछ भी लाइव होने से पहले, agent प्रत्येक पोस्ट को लक्षित नेटवर्क के नियमों के विरुद्ध वैलिडेट करता है और आपसे पुष्टि माँगता है, जिससे टाले जा सकने वाले reject पहले ही पकड़े जाते हैं। ब्रांड की वॉइस मिलाने के लिए पोस्ट history उपलब्ध है, और analytics को अगले पोस्ट को सूचित करने के लिए वापस पढ़ा जा सकता है।

यह plugin ओपन सोर्स है। आंतरिक विवरण के लिए रिपॉजिटरी देखें: [ayrshare/ayrshare-social-media-api-claude-plugin](https://github.com/ayrshare/ayrshare-social-media-api-claude-plugin)।

## स्थापित करें

<Steps>
  <Step title="marketplace जोड़ें (एक बार)">
    ```bash theme={"system"}
    claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin
    ```
  </Step>

  <Step title="plugin स्थापित करें">
    ```bash theme={"system"}
    claude plugin install ayrshare@ayrshare
    ```
  </Step>
</Steps>

### इंस्टॉल scopes

| Scope             | यह कहाँ लागू होता है                                               |
| ----------------- | ------------------------------------------------------------------ |
| Global (डिफ़ॉल्ट) | इस मशीन पर हर प्रोजेक्ट।                                           |
| `--scope local`   | वर्तमान प्रोजेक्ट, git में कमिट नहीं होता।                         |
| `--scope project` | वर्तमान प्रोजेक्ट, कमिट किया गया और आपकी टीम के साथ साझा किया गया। |

<Note>
  Claude Code का CLI global scope को `--scope user` कहता है।
</Note>

## Credentials

अपनी Ayrshare API Key इनमें से किसी भी तरीके से प्रदान करें:

<ul class="custom-bullets">
  <li>Key कॉन्फ़िगर करने या रोटेट करने के लिए `/ayrshare:setup` चलाएँ।</li>
  <li>`AYRSHARE_API_KEY` environment variable सेट करें।</li>
</ul>

Plugin की बंडल की गई `.mcp.json` पहले से ही `Authorization` header के साथ-साथ वैकल्पिक `Profile-Key` और X BYOK headers घोषित करती है, जिनमें से प्रत्येक का खाली डिफ़ॉल्ट (`${VAR:-}`) होता है, इसलिए आप किसी header को केवल उसके environment variable को सेट करके सक्षम करते हैं (Claude Code शुरू होने पर मानों को प्रतिस्थापित करता है)। हर कॉल पर एक sub-profile को लक्षित करने के लिए, `AYRSHARE_PROFILE_KEY` सेट करें (`/ayrshare:setup` के माध्यम से या अपने `settings.json` `env` ब्लॉक में) और Claude Code को पुनः प्रारंभ करें; बंडल किया गया `Profile-Key` header इसे ले जाता है, और जब सेट नहीं होता तो खाली रहता है (प्रदान नहीं किया गया माना जाता है)। इसके बजाय किसी एकल कॉल के लिए sub-profile को लक्षित करने के लिए, एक `profileKey` tool argument पास करें (कोई कॉन्फ़िग बदलाव आवश्यक नहीं)। आपको बंडल की गई `.mcp.json` को संपादित करने की आवश्यकता नहीं है, और आपको ऐसा नहीं करना चाहिए, क्योंकि `claude plugin update` इसे अधिलेखित कर देता है।

<Warning>
  MCP server session शुरू होने पर initialize होता है। plugin स्थापित करने या अपनी key बदलने के बाद **Claude Code को पुनः प्रारंभ करें**।
</Warning>

### X/Twitter BYO credentials

X/Twitter पर पोस्ट करने के लिए आपकी अपनी X Developer App credentials की आवश्यकता होती है (X BYO-key mandate, 31 मार्च 2026 से प्रभावी; देखें [API Overview](/apis/overview#xtwitter-byo-credentials))। बंडल की गई `.mcp.json` पहले से ही `Authorization` और `Profile-Key` के साथ, दोनों X BYOK headers को खाली डिफ़ॉल्ट के साथ घोषित करती है:

```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:-}"
}
```

तो आप केवल संबंधित environment variables (`X_TWITTER_OAUTH1_API_KEY`, `X_TWITTER_OAUTH1_API_SECRET`) को `/ayrshare:setup` या अपने `settings.json` `env` के माध्यम से सेट करते हैं, फिर **Claude Code को पुनः प्रारंभ करें**; आप बंडल की गई `.mcp.json` को संपादित नहीं करते (यह `claude plugin update` पर अधिलेखित हो जाती है)। **दोनों** सेट करें या कोई भी नहीं: दोनों सेट न होने पर X/Twitter कॉल error `419` (`x_credentials_required`) लौटाती है; केवल एक सेट होने पर यह error `400` लौटाती है। यह प्रति Ayrshare खाते एक key pair है, जो हर X-लक्षित request पर भेजा जाता है (सभी sub-profiles के लिए वही pair)।

<Note>
  plugin के बजाय raw कनेक्शन पसंद करते हैं? वही BYO headers `claude mcp add --header` के माध्यम से पास किए जा सकते हैं — देखें [Connect & Setup → X/Twitter BYO credentials](/additional/mcp-action-connect#xtwitter-byo-credentials)।
</Note>

## इसमें क्या शामिल है

### Command

<ul class="custom-bullets">
  <li>`/ayrshare:setup` — Ayrshare API Key कॉन्फ़िगर करें या रोटेट करें।</li>
</ul>

### Agents

<ul class="custom-bullets">
  <li>`social-manager`: सभी platforms पर content publish, schedule और analyze करता है।</li>
  <li>`profile-manager`: profiles बनाता और सूचीबद्ध करता है और Business खाते के तहत क्लाइंट profiles के लिए JWT social-linking URLs बनाता है।</li>
  <li>`insights-analyst`: केवल-पढ़ने के लिए reporting। metrics और post history प्राप्त करता है और प्रदर्शन का सारांश देता है; कभी भी publish, comment, message नहीं करता, और न ही कुछ भी संशोधित करता है।</li>
</ul>

### Skills

| Skill                        | उद्देश्य                                                              |
| ---------------------------- | --------------------------------------------------------------------- |
| `getting-started`            | पहली बार उपयोग के लिए ओरिएंट और कनेक्ट करें।                          |
| `post`                       | पोस्ट्स बनाएँ, वैलिडेट करें, अपडेट करें और पुनः प्रयास करें।          |
| `history`                    | पोस्ट और platform history प्राप्त करें।                               |
| `analytics`                  | प्रति-पोस्ट और खाता-स्तरीय analytics प्राप्त करें।                    |
| `comments`                   | comments पढ़ें, जोड़ें और उत्तर दें।                                  |
| `messages`                   | डायरेक्ट messages पढ़ें और भेजें और ऑटो-प्रतिक्रियाएँ कॉन्फ़िगर करें। |
| `profiles`                   | sub-profiles बनाएँ और सूचीबद्ध करें।                                  |
| `media`                      | वैलिडेट करें कि मीडिया URL पहुँच योग्य हैं।                           |
| `generate`                   | पोस्ट कॉपी AI-ड्राफ्ट करें और hashtags की सिफ़ारिश करें।              |
| `webhooks`                   | webhooks रजिस्टर, अनरजिस्टर और सूचीबद्ध करें।                         |
| `errors`                     | Ayrshare error codes डिकोड करें।                                      |
| `draft-in-brand-voice`       | पोस्ट कॉपी को एक सुसंगत ब्रांड वॉइस में ड्राफ्ट करें।                 |
| `plan-and-schedule-campaign` | बहु-पोस्ट अभियान की योजना बनाएँ और शेड्यूल करें।                      |

### पुष्टिकरण hook

एक `PreToolUse` hook किसी भी publish या send कार्रवाई से पहले पुष्टि माँगता है। यह ठीक इन 7 tools को कवर करता है:

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

## FAQ

<AccordionGroup>
  <Accordion title="क्या plugin पोस्ट्स को publish करने से पहले वैलिडेट करता है?">
    हाँ। plugin `validate_post` चलाकर आपके content को publish होने से पहले प्रत्येक नेटवर्क के नियमों — लंबाई, प्रारूप और मीडिया आवश्यकताओं — के विरुद्ध dry-run करता है, ताकि आप टाले जा सकने वाले reject को पहले ही पकड़ लें।
  </Accordion>

  <Accordion title="क्या यह मेरे लाइव खातों पर पोस्ट करने से पहले पूछता है?">
    हाँ। एक `PreToolUse` पुष्टिकरण hook किसी भी publish या send कार्रवाई से पहले आपसे अनुमोदन के लिए प्रॉम्प्ट करता है: `create_post`, `update_post`, `retry_post`, `add_comment`, `reply_comment`, `send_message`, और `set_auto_response`।
  </Accordion>

  <Accordion title="क्या plugin मेरे ब्रांड की वॉइस से मेल खा सकता है?">
    हाँ। `draft-in-brand-voice` skill एक सुसंगत ब्रांड वॉइस में नई कॉपी ड्राफ्ट करने के लिए आपकी पोस्ट history पढ़ता है। यह केवल ड्राफ्ट तैयार करता है — आपकी पुष्टि के बिना कुछ भी publish नहीं होता।
  </Accordion>

  <Accordion title="क्या मैं अगले पोस्ट को सूचित करने के लिए analytics पढ़ सकता हूँ?">
    हाँ। analytics tools प्रति-पोस्ट और खाता-स्तरीय metrics लौटाते हैं, ताकि आप परिणाम वापस पढ़ सकें और उन्हें अपने अगले पोस्ट का मार्गदर्शन करने दें।
  </Accordion>

  <Accordion title="plugin का उपयोग करने के लिए मुझे क्या चाहिए?">
    एक Ayrshare API Key (profiles और sub-profiles के लिए Business Plan key) और Claude Code। key को `/ayrshare:setup` या `AYRSHARE_API_KEY` environment variable के साथ कॉन्फ़िगर करें, फिर Claude Code को पुनः प्रारंभ करें।
  </Accordion>

  <Accordion title="क्या X/Twitter पर पोस्ट करने के लिए अतिरिक्त सेटअप की आवश्यकता है?">
    हाँ। X/Twitter के लिए आपकी अपनी OAuth 1.0a credentials की आवश्यकता होती है, जो दो कनेक्शन headers (`X-Twitter-OAuth1-Api-Key` और `X-Twitter-OAuth1-Api-Secret`) के रूप में जोड़ी जाती हैं। ऊपर [X/Twitter BYO credentials](#xtwitter-byo-credentials) देखें।
  </Accordion>
</AccordionGroup>

## अगले चरण

<CardGroup cols={2}>
  <Card title="Connect & Setup" icon="plug" href="/additional/mcp-action-connect" horizontal>
    प्रमाणीकरण, profile targeting और BYO credentials।
  </Card>

  <Card title="Tool Catalog" icon="list" href="/additional/mcp-action-tools" horizontal>
    27 tools domain के अनुसार समूहित, scope और उद्देश्य के साथ।
  </Card>
</CardGroup>