Publier sur X depuis Gemini CLI

X est le seul canal qui facture à chaque requête, et un agent de terminal en boucle peut dépenser sans que personne ne s'en aperçoive. Hermoso affiche le prix avant chaque publication.

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. Gemini CLI accède à l’ensemble par une seule connexion. Cette page couvre une partie de l’offre : ce que Gemini CLI peut réellement faire sur X, et ce que X ne permet pas.

Connecter Hermoso à Gemini CLI

  1. Installe l'extension.
    gemini extensions install https://github.com/hermoso-ai/hermoso
    Elle installe la dernière version du dépôt public d'Hermoso : cinq skills (research, ad-from-brand, generate, product-photoshoot et marketing) plus un fichier de contexte GEMINI.md. Les skills lancent la commande hermoso via npx, donc rien n'est ajouté à la liste d'outils de Gemini CLI, et rien ne coûte de contexte tant qu'une commande ne tourne pas. gemini extensions list les affiche sous Agent skills.
  2. Connecte-toi une fois.
    npx -y hermoso auth login
    Cela ouvre une connexion dans le navigateur et stocke un identifiant accessible au seul propriétaire dans ~/.hermoso/config.json. Gemini CLI peut l'exécuter pour toi la première fois qu'il a besoin d'Hermoso. Pas de navigateur sur cette machine ? Crée une clé sous MCP & CLI → Terminal & clés API et exécute npx -y hermoso auth login --token hmk_….
  3. Facultatif : le serveur MCP aussi.
    gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp
    Gemini CLI trouve le serveur d'autorisation d'Hermoso lorsque la première connexion répond 401, et s'enregistre lui-même : aucune clé n'apparaît donc dans settings.json. /mcp auth hermoso dans une session lance la connexion. Les skills atteignent tous les outils sans cela.
  4. Demandez quelque chose à Gemini CLI. « 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.

Nous avons lancé l'installation ci-dessus le 2026-09-23 avec Gemini CLI 0.60.0 dans un répertoire personnel vierge : elle a récupéré la dernière version de hermoso-ai/hermoso, et gemini extensions list a affiché les cinq skills et le fichier de contexte. L'extension ne transporte aucun serveur MCP, et c'est délibéré : une liste d'outils est chargée à chaque session, alors que les skills ne coûtent rien tant qu'ils ne tournent pas. Hermoso n'est pas affilié à Google et n'est pas approuvé par Google, et ne prétend pas l'être.

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 Gemini CLI

  • 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

TexteLa longueur dépend du compte qui publie : 280 caractères en général, jusqu’à 25 000 avec X Premium. Hermoso lit l’abonnement auprès de X, donc une publication longue part en entier. Rien n’est jamais tronqué. La limite est appliquée à la création ou à la mise en file d’attente : une publication trop longue est refusée pendant que vous êtes encore là pour la corriger, au lieu d’être coupée en silence au moment de la publication.
VisibilitéPublic uniquement. Une publication sur X est publique dès qu’elle existe. L’API n’a ni brouillon ni publication non répertoriée. Les comptes protégés existent, mais c’est un réglage à l’échelle du compte que Hermoso ne lit ni ne contrôle, et non un choix par publication.
CarrouselRefusé, nommément, pour une raison précise. « X n’a pas de carrousel à faire défiler. » Son API attache jusqu’à 4 médias à une publication, et ils s’affichent en grille, chaque image visible en même temps sans rien à faire défiler, si bien qu’une présentation numérotée « 1/6 · SWIPE » ne peut pas y être publiée comme prévu. Le refus indique quoi faire : « Publiez la diapositive la plus forte sur X, ou retirez X de cette publication. » Un diaporama qui demande au lecteur de faire défiler, publié sous forme de grille, est pire que pas de publication du tout.
Quel compteAucun. X publie sur le compte connecté.

Essayez-le dans Gemini CLI

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

« Transforme ./notes/launch.md en une seule publication X, ou en un court fil si elle ne tient pas, avec le lien seulement dans la dernière publication, et dis-moi d'abord le coût. »

Cela enchaîne get_brand → generate_text → post_to_x → x_post_insights_historical. Gemini CLI demande confirmation avant d'exécuter une commande shell, et les skills agissent par la commande hermoso : une publication apparaît donc comme une ligne que tu peux lire avant de dire oui. Pour les outils MCP, il propose une fois, toujours pour cet outil, ou toujours pour le serveur.

Gemini CLI sur X : le point délicat

Si tu ajoutes le serveur MCP d'Hermoso à Gemini CLI et qu'il doit publier sur X, n'utilise jamais --trust. Cet indicateur saute toutes les confirmations du serveur, et sur X chaque publication, lecture et suppression est un appel facturé, une publication contenant un lien coûtant environ 13 fois une publication simple. Sur un compte Premium, une longue publication est un seul appel facturé, là où un fil de cinq parties en fait cinq.

Deux détails de Gemini CLI déterminent le niveau de sécurité. gemini mcp add écrit dans .gemini/settings.json du projet, sauf si tu passes --scope user, ce qui est utile quand un dépôt doit toujours travailler pour une seule marque. Et n'ajoute jamais Hermoso avec --trust : cela saute toutes les confirmations du serveur, y compris celles qui précèdent une publication. Les outils MCP arrivent préfixés par mcp_hermoso_ suivi du nom de l'outil, et --exclude-tools permet d'en écarter complètement.

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 Gemini CLI 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 Gemini CLI, publier sur : Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram. Ou voir tout ce que Gemini CLI peut publier.

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

Questions fréquentes

Gemini CLI peut-il publier sur X ?

Oui, avec l'extension Gemini CLI d'Hermoso. Exécute gemini extensions install https://github.com/hermoso-ai/hermoso, qui ajoute cinq skills Hermoso pilotant la commande hermoso, puis connecte-toi une fois avec npx -y hermoso auth login. La connexion ouvre un navigateur et stocke elle-même l'identifiant : il n'y a donc aucune clé à créer ni à coller. Si tu veux aussi les outils d'Hermoso dans la liste propre de Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp ajoute le serveur hébergé, qui se connecte avec OAuth. Gemini CLI dispose alors de plus de 922 outils, dont ceux qui publient sur X, et de ceux qui recherchent les publicités déjà diffusées sur ton marché et génèrent le visuel.

Comment connecter X à Gemini CLI ?

Deux étapes, à faire une seule fois chacune. Exécute gemini extensions install https://github.com/hermoso-ai/hermoso, qui ajoute cinq skills Hermoso pilotant la commande hermoso, puis connecte-toi une fois avec npx -y hermoso auth login. La connexion ouvre un navigateur et stocke elle-même l'identifiant : il n'y a donc aucune clé à créer ni à coller. Si tu veux aussi les outils d'Hermoso dans la liste propre de Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp ajoute le serveur hébergé, qui se connecte avec OAuth. Connecte ensuite X dans Hermoso sous Paramètres → Connecteurs, ce qui ouvre un écran de consentement OAuth dans le navigateur. Après cela, Gemini CLI publie sur X comme un simple appel d'outil.

Gemini CLI peut-il publier en privé ou en brouillon sur X ?

Non. Une publication sur X est publique dès qu’elle existe ; l’API n’a ni brouillon ni publication non répertoriée. Hermoso refuse une visibilité que X ne peut pas honorer au moment où vous la demandez, plutôt que de publier discrètement quelque chose de moins visible.

Gemini CLI peut-il rechercher sur X avant de publier ?

Pas via une bibliothèque publicitaire, car X n’en publie aucune. Ce qu’Hermoso lit sur X, c’est votre propre compte : statistiques des publications, chiffres d’annonceurs sur n’importe quelle période et mentions de la marque.

Quelle est la limite de caractères pour une publication X depuis Gemini CLI ?

Cela dépend du compte, et Hermoso vérifie au lieu de deviner. Un compte X ordinaire est limité à 280 caractères ; un compte avec X Premium peut aller jusqu’à 25 000. Hermoso lit l’abonnement auprès de X et envoie la publication, donc une publication longue part en entier, et rien n’est jamais tronqué. Sur un compte Premium, une longue publication se lit souvent mieux qu’un fil et coûte moins cher, car c’est un seul appel X facturé, alors que cinq parties en font cinq. Premium débloque aussi les articles longs, rédigés en Markdown, et la modification d’une publication déjà publiée dans l’heure autorisée par X. Hermoso l’applique à la création ou à la mise en file d’attente, si bien que Gemini CLI le sait immédiatement au lieu d’échouer plus tard, quand personne ne regarde.

Gemini CLI peut-il aussi gérer des publicités X, en plus de publier ?

Oui, depuis août 2026. Les publicités X fonctionnent sur un hôte distinct avec leur propre signature OAuth 1.0a, et Hermoso construit toute l’arborescence dessus : campagne, ligne de commande, publication sponsorisée, ciblage, budgets, statut et reporting. 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 d’Hermoso à votre compte publicitaire sur business.x.com → Accès au compte.

Commencez gratuitement avec 30 crédits à l'inscription et 250+ à gagner. Toutes les fonctionnalités sont incluses dans tous les plans.

Commencer gratuitement →   Voir les tarifs