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 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.
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 hookPreToolUse 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_postupdate_postretry_postadd_commentreply_commentsend_messageset_auto_responsecreate_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_webhooketunregister_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
Le plugin valide-t-il les publications avant publication ?
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 ?
Demande-t-il avant de publier sur mes comptes en direct ?
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.Le plugin peut-il reproduire la voix de ma marque ?
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 ?
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 ?
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. Saisissez la clé avec
/plugin configure ayrshare@ayrshare dans Claude Code.Publier sur X/Twitter nécessite-t-il une configuration supplémentaire ?
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.É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.