Claude Code Plugin

Le plugin Ayrshare pour Claude Code regroupe la configuration du MCP 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.

Installation

Ajouter la marketplace (une seule fois)

claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin

Installer le plugin

claude plugin install ayrshare@ayrshare

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.

La CLI de Claude Code appelle la portée globale --scope user.

Identifiants

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

Exécutez /ayrshare:setup pour configurer ou faire tourner la clé.
Définissez la variable d’environnement AYRSHARE_API_KEY.

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.

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

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). 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 :

"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).

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.

Ce qu’il inclut

Commande

/ayrshare:setup — configure ou fait tourner l’API Key Ayrshare.

Agents

social-manager : publie, planifie et analyse du contenu sur toutes les plateformes.
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.
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.

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 :

create_post
update_post
retry_post
add_comment
reply_comment
send_message
set_auto_response

FAQ

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.

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.

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.

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.

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.

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 ci-dessus.

Installation

Portées d’installation

Identifiants

Identifiants X/Twitter BYO

Ce qu’il inclut

Commande

Agents

Compétences

Hook de confirmation

FAQ

Étapes suivantes

Connect & Setup

Tool Catalog

​Installation

​Portées d’installation

​Identifiants

​Identifiants X/Twitter BYO

​Ce qu’il inclut

​Commande

​Agents

​Compétences

​Hook de confirmation

​FAQ

​Étapes suivantes

Connect & Setup

Tool Catalog

Installation

Portées d’installation

Identifiants

Identifiants X/Twitter BYO

Ce qu’il inclut

Commande

Agents

Compétences

Hook de confirmation

FAQ

Étapes suivantes