Publier sur X depuis Claude Code

Hermoso est un serveur MCP marketing : plus de 922 outils derrière un seul point d’accès protégé par OAuth, qui permettent à un agent de rechercher les publicités déjà diffusées sur un marché, de générer des publicités image et vidéo finies, de les publier et de construire les campagnes payantes qui les accompagnent. Claude Code accède à l’ensemble par une seule connexion. Cette page couvre une partie de l’offre : ce que Claude Code peut réellement faire sur X, et ce que X ne permet pas.

Connecter Hermoso à Claude Code

1. Une seule commande, et aucune clé.

   claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

   Déjà dans une session ? Tapez /plugin marketplace add hermoso-ai/hermoso, puis /plugin install hermoso@hermoso. Il installe cinq compétences Hermoso (research, ad-from-brand, generate, product-photoshoot et marketing) qui exécutent la commande hermoso via npx, si bien qu’aucune liste d’outils n’est chargée dans vos sessions et que rien ne coûte de contexte tant qu’il ne tourne pas.
2. Connectez-vous une fois.

   npx -y hermoso auth login

   Cela ouvre une connexion dans le navigateur, sur loopback, comme le fait gh, et stocke un identifiant accessible au seul propriétaire dans ~/.hermoso/config.json. Claude Code le lance pour vous la première fois qu’il a besoin d’Hermoso. Pas de navigateur sur cette machine, par exemple en CI, sur un serveur distant ou dans un conteneur ? Créez une clé sous MCP & CLI → Clés Terminal et API et lancez npx -y hermoso auth login --token hmk_…. Une clé donne un vrai pouvoir de dépense : traitez-la comme un mot de passe.
3. Facultatif : le serveur MCP aussi. Si vous voulez aussi les outils Hermoso dans la liste d’outils propre à Claude Code, lancez claude mcp add hermoso -- npx -y hermoso mcp après vous être connecté. Il lit le même identifiant enregistré, si bien qu’aucune clé n’est écrite dans .claude.json. Les compétences atteignent tous les outils sans lui.
4. Demandez quelque chose à Claude Code. « Récupère les publicités les plus anciennes de mes trois principaux concurrents et réutilise la meilleure accroche dans une vidéo 9:16 », ou « publie ce rendu sur la chaîne ». L'agent choisit les outils ; vous approuvez les dépenses.

Le plug-in et le serveur MCP facultatif accèdent aux mêmes outils et au même compte. La différence tient au contexte : une liste d’outils est chargée dans chaque session avant que vous ne tapiez quoi que ce soit, alors que les compétences ne coûtent rien tant qu’une commande ne tourne pas.

Connectez ensuite X lui-même, une fois, sous Paramètres → Connecteurs dans Hermoso. C’est un écran de consentement OAuth, donc la seule étape qui nécessite un navigateur. Tout le reste est un appel d’outil.

Les outils X que reçoit Claude Code

• post_to_x : publie du texte, une image ou une vidéo avec texte alternatif, un fil complet, une réponse, une publication citée ou un sondage, et peut restreindre qui est autorisé à répondre.
• post_x_article : publie un article long format. Rédigez-le en Markdown : les titres, listes, citations, liens, blocs de code et tableaux sont conservés.
• edit_x_post : réécrit une publication déjà publiée, dans l’heure autorisée par X.
• schedule_post : la met en file d’attente dans le calendrier partagé.
• x_post_metrics : les compteurs publics d’une publication.
• x_post_insights : des chiffres de niveau annonceur pour les 28 dernières heures seulement : impressions, clics sur le lien, visites de profil, vues vidéo et quartiles de visionnage.
• x_post_insights_historical : les mêmes chiffres sur n’importe quelle période, jusqu’à 25 publications à la fois. C’est l’outil pour « comment s’est passé le mois dernier ».
• x_mentions : qui parle de la marque.
• delete_x_post : supprime une publication.

X est le seul connecteur qui coûte de l’argent à chaque appel, et les chiffres sont publiés plutôt que cachés. Meta, TikTok, LinkedIn, YouTube, Threads et Drive ne coûtent rien par requête ; X nous facture, donc ces appels consomment quelques crédits chacun. Une publication simple coûte $0.015 par requête, et une publication contenant un lien $0.200, soit environ 13× plus. Les suppressions, les lectures et l’écriture des métadonnées de texte alternatif ont chacune leur propre prix, et les statistiques sont facturées par publication renvoyée. La détection des liens penche volontairement vers l’hypothèse qu’un lien est présent, car se tromper dans l’autre sens nous coûte 13×. Conséquence pratique : sur X, une bonne publication vaut mieux que cinq, et votre agent connaît le prix avant de publier. La longueur dépend du compte qui publie, et non d’un maximum fixe de 280. Hermoso lit l’abonnement X du compte et envoie jusqu’à 25 000 caractères là où Premium le permet, de sorte qu’une publication longue part en entier au lieu d’être refusée, et rien n’est jamais tronqué. C’est aussi la forme la moins chère : une longue publication est un seul appel X facturé, alors que les mêmes mots répartis en cinq publications en font cinq. X Premium débloque aussi deux fonctions que Hermoso publie pour vous : un article long format, rédigé en Markdown avec titres, listes, citations, blocs de code et tableaux intacts, et une modification d’une publication déjà publiée, dans l’heure autorisée par X.

Limites de X à connaître avant d’automatiser quoi que ce soit

Essayez-le dans Claude Code

Demandez-le en langage courant. Ce sont des phrases simples, pas un langage de commande :

« Transformez ./notes/launch.md en fil X de cinq publications maximum, gardez le lien uniquement dans la dernière, et indiquez-moi le coût avant de publier. »

Cela enchaîne get_brand → generate_text → post_to_x → x_post_insights_historical. Claude Code demande confirmation avant d'exécuter un outil, et la transcription est affichée dans le terminal : une étape de publication est une ligne que vous pouvez lire avant d'appuyer sur y.

Claude Code sur X : le point délicat

Mettez le lien dans une seule publication, pas dans cinq. Une publication qui contient un lien coûte environ 13 fois plus qu'une publication simple : un fil où chaque message contient un lien est donc la forme la plus chère, et la détection des liens penche volontairement vers la présence d'un lien. Un texte trop long est refusé plutôt que tronqué, et le dépassement est compté. Dans un script, cela produit un échec propre que vous pouvez gérer, au lieu d'une publication envoyée à moitié.

Le plug-in ne porte aucun manifeste d’outils, ce qui compte surtout pour une longue exécution sans surveillance : l’agent appelle la commande hermoso à chaque étape, et --json sur n’importe quelle commande lui donne une sortie machine à vérifier.

Rechercher sur X avant de publier

Il n’existe pas de bibliothèque publicitaire X à consulter. La recherche sur X ici porte sur votre propre compte : mentions, statistiques des publications et chiffres historiques des annonceurs. Le reste de la recherche n’est pas touché : les bibliothèques publicitaires Meta, Google et LinkedIn, et TikTok, Instagram, YouTube, Reddit et Threads organiques.

La partie payante

Les publicités X sont arrivées en août 2026, donc X est désormais les deux. L’API des publicités X est un produit distinct, sur un hôte distinct et avec sa propre signature OAuth 1.0a, ce qui explique son arrivée après le reste. Hermoso construit désormais toute l’arborescence des publications sponsorisées dessus : campagne, ligne de commande (le nom que X donne à un groupe d’annonces), publication sponsorisée, ciblage, budgets, statut et reporting. Une publicité X fait la promotion d’une publication, donc le visuel est une publication, la même que Hermoso publie en organique. Le commutateur qui active les vraies dépenses refuse de fonctionner sans confirmation explicite, comme sur les onze autres plateformes. Un point à connaître avant de prévoir un budget : X accorde l’accès à l’API Ads par compte publicitaire et non par application, il n’y a donc pas de bouton OAuth. Vous ajoutez l’utilisateur X de Hermoso à votre compte publicitaire sur business.x.com → Accès au compte, et il apparaît dans list_x_ads_accounts avec le niveau d’autorisation accordé par X.

Ce que Claude Code ne peut pas faire seul

Un agent doté d'un budget n'est utile que si son rayon d'action est borné, donc le garde-fou se trouve dans le serveur et non dans une consigne. Chaque campagne, chaque ensemble d'annonces, chaque groupe d'annonces et chaque annonce publicitaire est créé en pause, et les changements de statut qui activent de l'argent réel refusent de s'exécuter sans un indicateur de confirmation explicite. Chaque rendu est d'abord chiffré (hermoso_capabilities publie le coût exact en crédits de chaque modèle avant toute dépense). Les crédits sont réservés avant le premier appel au fournisseur, puis imputés au coût exact après coup : un envoi qui échoue est remboursé plutôt que de vous facturer pour rien. Les suppressions sont aussi soumises à confirmation, et chaque arborescence de campagne est relue depuis la plateforme publicitaire avant que votre agent ne vous dise ce qu'il a construit.

Une étape n'est volontairement pas automatisée : relier un compte passe par un écran de consentement OAuth, donc vous connectez le canal une fois dans un navigateur. Tout le reste est un appel d'outil.

Le reste de la matrice

Depuis Claude Code, publiez sur : Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram. Ou voir tout ce sur quoi Claude Code peut publier.

Publier sur X depuis : Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code marketing

Questions fréquentes

Claude Code peut-il publier sur X ?

Oui, avec le plugin Claude Code d'Hermoso. Une seule commande : claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dans une session, /plugin marketplace add hermoso-ai/hermoso puis /plugin install hermoso@hermoso. Il installe cinq compétences Hermoso qui pilotent la commande hermoso, donc aucune liste d'outils n'est chargée dans vos sessions. Connectez-vous une fois avec npx -y hermoso auth login : cela ouvre un navigateur et enregistre l'identifiant lui-même, il n'y a donc ni clé à créer ni clé à coller. Claude Code dispose ensuite de plus de 922 outils, dont ceux qui publient sur X, ainsi que ceux qui recherchent les publicités déjà diffusées sur votre marché et créent les visuels.

Comment connecter X à Claude Code ?

Deux étapes, une fois chacune. Une commande : claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dans une session, /plugin marketplace add hermoso-ai/hermoso puis /plugin install hermoso@hermoso. Il installe cinq compétences Hermoso qui pilotent la commande hermoso, donc aucune liste d'outils n'est chargée dans vos sessions. Connectez-vous une fois avec npx -y hermoso auth login : cela ouvre un navigateur et enregistre l'identifiant lui-même, il n'y a donc ni clé à créer ni clé à coller. Puis connectez X dans Hermoso sous Paramètres → Connecteurs : c'est un écran de consentement OAuth dans le navigateur. Ensuite, Claude Code publie sur X comme un simple appel d'outil.

Claude Code a-t-il besoin de mon mot de passe X ?

Non. Vous connectez X à Hermoso une seule fois, par un écran de consentement OAuth dans le navigateur, puis Claude Code y accède comme à un appel d’outil. La liaison du compte est la seule étape qui n’est pas faite sans navigateur ; rien après ne demande de mot de passe, et aucun identifiant n’est jamais transmis au modèle.

Claude Code peut-il programmer une publication X pour plus tard ?

Oui. schedule_post la met en file d’attente sur un calendrier commun à tous les autres canaux, avec une légende propre à chaque canal si le texte doit différer, et list_scheduled et cancel_scheduled la consultent ou l’annulent. X fait partie des onze canaux de cette file.

Claude Code peut-il publier un carrousel sur X ?

Non. L’API de X attache jusqu’à quatre médias à une publication, et ils s’affichent en grille, chaque image visible en même temps sans rien à faire défiler : une présentation numérotée ne peut donc pas y être publiée comme prévu. Claude Code appelle le même outil de publication dans les deux cas, et un canal qui ne peut pas porter un carrousel est refusé, avec la vraie raison indiquée.

Combien coûte une publication sur X depuis Claude Code ?

X est le seul connecteur facturé en crédits à chaque appel, parce que X facture chaque requête API : environ $0.015 pour une publication et $0.200 pour une publication contenant un lien, soit environ 13 fois plus. Votre agent connaît le prix avant de publier. Les formules coûtent $29, $69 et $149 par mois pour 1 200, 3 000 et 7 000 crédits, et toutes les fonctionnalités sont incluses dans chaque formule, y compris la formule Gratuite. La seule exception est le SSO entreprise.