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

> Installez le plugin Ayrshare pour Claude Code afin de publier, planifier et analyser des publications sociales depuis votre éditeur — avec validation avant publication, une invite de confirmation avant publication, une rédaction dans la voix de la marque et une lecture des statistiques.

Le plugin Ayrshare pour Claude Code regroupe la configuration du [MCP Server](/additional/mcp-action-server), une commande de configuration, des agents, des compétences et un hook de sécurité. Une fois installé, vous pouvez publier des publications, récupérer l'historique et les statistiques, gérer les profils, et bien plus — directement depuis Claude Code. Avant que quoi que ce soit ne soit mis en ligne, l'agent valide chaque publication par rapport aux règles du réseau ciblé et vous demande de confirmer, ce qui permet d'éviter en amont les rejets évitables. L'historique des publications est disponible pour reproduire la voix d'une marque, et les statistiques peuvent être relues pour orienter la publication suivante.

Le plugin est open source. Consultez le dépôt pour les internes : [ayrshare/ayrshare-social-media-api-claude-plugin](https://github.com/ayrshare/ayrshare-social-media-api-claude-plugin).

## Installation

<Steps>
  <Step title="Ajouter la marketplace (une seule fois)">
    ```bash theme={"system"}
    claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin
    ```
  </Step>

  <Step title="Installer le plugin">
    ```bash theme={"system"}
    claude plugin install ayrshare@ayrshare
    ```
  </Step>
</Steps>

### Portées d'installation

| Portée              | Où elle s'applique                                   |
| ------------------- | ---------------------------------------------------- |
| Global (par défaut) | Chaque projet sur cette machine.                     |
| `--scope local`     | Projet actuel, non commité dans git.                 |
| `--scope project`   | Projet actuel, commité et partagé avec votre équipe. |

<Note>
  La CLI de Claude Code appelle la portée globale `--scope user`.
</Note>

## Identifiants

Fournissez votre API Key Ayrshare de l'une des manières suivantes :

<ul class="custom-bullets">
  <li>Exécutez `/ayrshare:setup` pour configurer ou faire tourner la clé.</li>
  <li>Définissez la variable d'environnement `AYRSHARE_API_KEY`.</li>
</ul>

Le fichier `.mcp.json` fourni avec le plugin déclare déjà l'en-tête `Authorization` ainsi que les en-têtes optionnels `Profile-Key` et X BYOK, chacun avec une valeur par défaut vide (`${VAR:-}`), de sorte que vous activez un en-tête simplement en définissant sa variable d'environnement (Claude Code substitue les valeurs au démarrage). Pour cibler un sous-profil sur chaque appel, définissez `AYRSHARE_PROFILE_KEY` (via `/ayrshare:setup` ou le bloc `env` de votre `settings.json`) et redémarrez Claude Code ; l'en-tête `Profile-Key` intégré la transmet, et reste vide (traité comme non fourni) lorsqu'elle n'est pas définie. Pour cibler plutôt un sous-profil pour un seul appel, passez un argument d'outil `profileKey` (aucune modification de configuration nécessaire). Vous n'avez pas besoin de modifier le `.mcp.json` intégré, et vous ne devriez pas le faire, car `claude plugin update` l'écrase.

<Warning>
  Le serveur MCP s'initialise au démarrage de la session. **Redémarrez Claude Code** après avoir installé le plugin ou modifié votre clé.
</Warning>

### Identifiants X/Twitter BYO

Publier sur X/Twitter nécessite vos propres identifiants X Developer App (mandat BYO-key X, effectif au 31 mars 2026 ; voir la [présentation de l'API](/apis/overview#xtwitter-byo-credentials)). Le `.mcp.json` intégré déclare déjà les deux en-têtes X BYOK avec des valeurs par défaut vides, aux côtés de `Authorization` et `Profile-Key` :

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

Vous n'avez donc qu'à définir les variables d'environnement correspondantes (`X_TWITTER_OAUTH1_API_KEY`, `X_TWITTER_OAUTH1_API_SECRET`) via `/ayrshare:setup` ou le bloc `env` de votre `settings.json`, puis à **redémarrer Claude Code** ; vous ne modifiez pas le `.mcp.json` intégré (il est écrasé lors de `claude plugin update`). Définissez **les deux** ou aucun : sans aucune des deux définies, un appel X/Twitter renvoie l'erreur `419` (`x_credentials_required`) ; avec une seule définie, il renvoie l'erreur `400`. Il s'agit d'une paire de clés par compte Ayrshare, envoyée sur chaque requête ciblant X (la même paire pour tous les sous-profils).

<Note>
  Vous préférez une connexion brute au plugin ? Les mêmes en-têtes BYO peuvent être transmis via `claude mcp add --header` — voir [Connect & Setup → Identifiants X/Twitter BYO](/additional/mcp-action-connect#xtwitter-byo-credentials).
</Note>

## Ce qu'il inclut

### Commande

<ul class="custom-bullets">
  <li>`/ayrshare:setup` — configure ou fait tourner l'API Key Ayrshare.</li>
</ul>

### Agents

<ul class="custom-bullets">
  <li>`social-manager` : publie, planifie et analyse du contenu sur toutes les plateformes.</li>
  <li>`profile-manager` : crée et liste les profils et génère des URL d'association sociale JWT pour les profils clients sous un compte Business.</li>
  <li>`insights-analyst` : reporting en lecture seule. Récupère les métriques et l'historique des publications et résume les performances ; ne publie, ne commente, n'envoie de messages ni ne modifie jamais rien.</li>
</ul>

### Compétences

| Compétence                   | Objectif                                                                      |
| ---------------------------- | ----------------------------------------------------------------------------- |
| `getting-started`            | S'orienter et se connecter pour une première utilisation.                     |
| `post`                       | Créer, valider, mettre à jour et réessayer des publications.                  |
| `history`                    | Récupérer l'historique des publications et de la plateforme.                  |
| `analytics`                  | Récupérer les statistiques par publication et au niveau du compte.            |
| `comments`                   | Lire, ajouter et répondre à des commentaires.                                 |
| `messages`                   | Lire et envoyer des messages directs et configurer les réponses automatiques. |
| `profiles`                   | Créer et lister des sous-profils.                                             |
| `media`                      | Vérifier que les URL de médias sont accessibles.                              |
| `generate`                   | Rédiger des brouillons de publications par IA et recommander des hashtags.    |
| `webhooks`                   | Enregistrer, désenregistrer et lister les webhooks.                           |
| `errors`                     | Décoder les codes d'erreur Ayrshare.                                          |
| `draft-in-brand-voice`       | Rédiger des publications dans une voix de marque cohérente.                   |
| `plan-and-schedule-campaign` | Planifier et programmer une campagne multi-publications.                      |

### Hook de confirmation

Un hook `PreToolUse` demande une confirmation avant toute action de publication ou d'envoi. Il couvre exactement ces 7 outils :

<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="Le plugin valide-t-il les publications avant publication ?">
    Oui. Le plugin exécute `validate_post` pour tester votre contenu à blanc par rapport aux règles de chaque réseau — longueur, format et exigences relatives aux médias — avant publication, afin que vous détectiez les rejets évitables en amont.
  </Accordion>

  <Accordion title="Demande-t-il avant de publier sur mes comptes en direct ?">
    Oui. Un hook de confirmation `PreToolUse` vous invite à approuver avant toute action de publication ou d'envoi : `create_post`, `update_post`, `retry_post`, `add_comment`, `reply_comment`, `send_message` et `set_auto_response`.
  </Accordion>

  <Accordion title="Le plugin peut-il reproduire la voix de ma marque ?">
    Oui. La compétence `draft-in-brand-voice` lit votre historique de publications pour rédiger de nouveaux contenus dans une voix de marque cohérente. Elle ne produit que des brouillons — rien n'est publié sans votre confirmation.
  </Accordion>

  <Accordion title="Puis-je lire les statistiques pour orienter la publication suivante ?">
    Oui. Les outils de statistiques renvoient des métriques par publication et au niveau du compte, ce qui vous permet de relire les résultats et de les laisser guider votre publication suivante.
  </Accordion>

  <Accordion title="De quoi ai-je besoin pour utiliser le plugin ?">
    Une API Key Ayrshare (une clé Business Plan pour les profils et sous-profils) et Claude Code. Configurez la clé avec `/ayrshare:setup` ou la variable d'environnement `AYRSHARE_API_KEY`, puis redémarrez Claude Code.
  </Accordion>

  <Accordion title="Publier sur X/Twitter nécessite-t-il une configuration supplémentaire ?">
    Oui. X/Twitter nécessite vos propres identifiants OAuth 1.0a, ajoutés en tant que deux en-têtes de connexion (`X-Twitter-OAuth1-Api-Key` et `X-Twitter-OAuth1-Api-Secret`). Consultez [Identifiants X/Twitter BYO](#xtwitter-byo-credentials) ci-dessus.
  </Accordion>
</AccordionGroup>

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Connect & Setup" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Authentification, ciblage de profil et identifiants BYO.
  </Card>

  <Card title="Tool Catalog" icon="list" href="/additional/mcp-action-tools" horizontal>
    Les 27 outils regroupés par domaine, avec leur portée et leur objectif.
  </Card>
</CardGroup>