Passer au contenu principal
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

1

Ajouter la marketplace (une seule fois)

2

Installer le plugin

Portées d’installation

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

Identifiants

Saisissez votre API Key Ayrshare dans les paramètres du plugin. Dans Claude Code, exécutez :
Claude Code masque chaque valeur pendant la saisie et la conserve dans le stockage sécurisé des identifiants de votre système. claude plugin install exécuté depuis un terminal n’affiche pas cette boîte de dialogue : ouvrez-la donc depuis une session Claude Code. /ayrshare:setup vous guide à travers chaque champ. Pour cibler plutôt un sous-profil pour un seul appel, passez un argument d’outil profileKey. Il remplace le paramètre Profile-Key pour cet appel.
La version 0.2.3 du plugin nécessite Claude Code 2.1.119 ou version ultérieure et ne lit plus les variables d’environnement AYRSHARE_API_KEY, AYRSHARE_PROFILE_KEY, X_TWITTER_OAUTH1_API_KEY ni X_TWITTER_OAUTH1_API_SECRET. Si vous avez configuré une version antérieure, exécutez /plugin configure ayrshare@ayrshare après la mise à jour et saisissez les mêmes valeurs. Tant que vous ne l’avez pas fait, les outils Ayrshare ne se chargent pas.

Identifiants X/Twitter BYO

Tout appel X/Twitter (publication, analytics, messages) nécessite vos propres identifiants X Developer App (mandat BYO-key X, effectif au 31 mars 2026 ; voir la présentation de l’API). Saisissez votre API Key (Consumer Key) et votre API Secret (Consumer Secret) X dans les paramètres du plugin avec /plugin configure ayrshare@ayrshare. Le plugin les envoie dans les en-têtes X-Twitter-OAuth1-Api-Key et X-Twitter-OAuth1-Api-Secret. 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 : vous guide pour saisir ou modifier votre API Key et vos paramètres facultatifs.

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

Hook de confirmation

Un hook PreToolUse demande une confirmation avant toute action ayant un effet réel. Si vous refusez, l’outil ne s’exécute pas et rien n’est envoyé à Ayrshare. Il couvre exactement ces 12 outils :
  • create_post
  • update_post
  • retry_post
  • add_comment
  • reply_comment
  • send_message
  • set_auto_response
  • create_profile : crée un profil client, ce qui consomme du quota de profils.
  • update_ad : met en pause, reprend, supprime ou archive une publicité sponsorisée, ce qui modifie les dépenses publicitaires réelles. Le même statut est également appliqué à l’ensemble de publicités et à la campagne de la publicité, donc les autres publicités qui s’y trouvent changent aussi.
  • boost_post : sponsorise une publication déjà publiée sous forme de publicité payante, ce qui dépense de l’argent réel du compte publicitaire.
  • register_webhook et unregister_webhook : modifient la destination à laquelle Ayrshare envoie les événements de votre compte, y compris le contenu des messages et des commentaires.
Cette confirmation nécessite la version 0.2.2 du plugin ou une version ultérieure. Les versions antérieures du plugin ne l’affichaient pas. Pour mettre à jour, exécutez claude plugin marketplace update ayrshare, puis claude plugin update ayrshare@ayrshare, et redémarrez Claude Code.

FAQ

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.
Oui. Un hook de confirmation PreToolUse vous invite à approuver avant toute action ayant un effet réel : create_post, update_post, retry_post, add_comment, reply_comment, send_message, set_auto_response, create_profile, update_ad, boost_post, register_webhook et unregister_webhook. Il nécessite la version 0.2.2 du plugin ou une version ultérieure.
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.
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.
Une API Key Ayrshare (une clé Business Plan pour les profils et sous-profils) et Claude Code. Saisissez la clé avec /plugin configure ayrshare@ayrshare dans Claude Code.
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.

Étapes suivantes

Connect & Setup

Authentification, ciblage de profil et identifiants BYO.

Tool Catalog

Les 33 outils regroupés par domaine, avec leur portée et leur objectif.