Hermoso est un serveur MCP de marketing : plus de 922 outils sur un point d'accès OAuth unique, qui permettent à un agent de rechercher les publicités déjà diffusées sur un marché, de générer des publicités finies en image et en vidéo, de les publier et de construire les campagnes payantes qui les accompagnent. Gemini CLI accède à l'ensemble via une seule connexion. Cette page couvre une partie : ce que Gemini CLI peut réellement faire sur Telegram, et ce que Telegram ne lui permettra pas de faire.
Connecter Hermoso à Gemini CLI
- Installe l'extension.
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 contextegemini extensions install https://github.com/hermoso-ai/hermosoGEMINI.md. Les skills lancent la commandehermosovianpx, 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 listles affiche sous Agent skills. - Connecte-toi une fois.
Cela ouvre une connexion dans le navigateur et stocke un identifiant accessible au seul propriétaire dansnpx -y hermoso auth login~/.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écutenpx -y hermoso auth login --token hmk_…. - Facultatif : le serveur MCP aussi.
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 dansgemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcpsettings.json./mcp auth hermosodans une session lance la connexion. Les skills atteignent tous les outils sans cela. - 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 Telegram lui-même, une fois, sous Paramètres → Connecteurs dans Hermoso, en collant un jeton de bot obtenu auprès de @BotFather, puis ajoutez ce bot à votre chaîne comme administrateur. Il n’y a pas d’écran de consentement : le jeton est l’identifiant, et le bot est celui qui publie.
Les outils Telegram dont dispose Gemini CLI
post_to_telegram: envoie un message en tant que votre bot dans le chat que vous nommez : du texte jusqu’à 4 096 caractères, ou une photo, une vidéo, ou un album de 2 à 10 éléments avec photos et vidéos mélangées.schedule_post: la met en file d’attente avec sonchatId, sur le même calendrier que tous les autres canaux.list_telegram_chats: les chats qui ont écrit au bot au cours des dernières 24 heures. Il aide à trouver un identifiant, et ce n’est pas une liste de tous les chats auxquels le bot appartient.edit_telegram_message / pin_telegram_message: corrigent le texte ou la légende d’un message sans perdre ses vues, et épinglent ou désépinglent l’appel à l’action.create_telegram_invite_link: un lien d’invitation nommé par campagne, avec expiration facultative, plafond de membres ou approbation d’adhésion, pour savoir qui a rejoint et d’où.telegram_account: le nombre d’abonnés ou de membres du chat, son titre, sa description et son lien d’invitation.list_telegram_dms: ce que les gens ont envoyé au bot au cours des dernières 24 heures, du plus récent au plus ancien, pour répondre avecpost_to_telegram.delete_telegram_message: supprime un message envoyé par le bot, dans la fenêtre de 48 heures de Telegram, après une étape de confirmation.
Telegram se connecte avec un jeton de bot, et non avec un écran de connexion. Créez un bot avec @BotFather dans Telegram, collez son jeton sous Paramètres → Connecteurs, puis ajoutez le bot à votre chaîne comme administrateur avec l’autorisation Publier des messages, ou à un groupe comme membre autorisé à écrire. Hermoso publie en tant que ce bot, jamais en tant que vous. Deux limites viennent de Telegram et méritent d’être prévues : un bot n’obtient ni vues par publication ni historique des publications, donc le nombre d’abonnés et les liens d’invitation nommés sont les seuls chiffres disponibles ; et les messages envoyés au bot sont conservés 24 heures, puis disparaissent. La publication ne coûte aucun crédit.
Limites de Telegram à connaître avant d'automatiser quoi que ce soit
| Texte | Un message Telegram peut aller jusqu’à 4 096 caractères, mais seulement 1 024 dès qu’une photo ou une vidéo est jointe, car le texte devient une légende. Cette 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é | Envoyé ou non envoyé, sans forme brouillon, non répertoriée ni privée. Qui la voit est décidé par le chat : « publiez dans un groupe ou une chaîne privés, et seuls ses membres la voient ». silent envoie sans son de notification et ne change rien à qui peut voir le message. |
| Carrousel | De 2 à 10 éléments en album, et photos et vidéos peuvent être mélangées. Les deux bornes viennent de Telegram elle-même, de sendMediaGroup de l’API Bot (« doit contenir de 2 à 10 éléments »), et le mélange aussi. L’album n’affiche qu’une légende, sur son premier élément. Hermoso téléverse les fichiers au lieu de transmettre des liens, ce qui porte les plafonds de Telegram à 10 Mo par photo et 50 Mo par vidéo. |
| Quel compte | chatId, obligatoire à chaque publication : le @username d’une chaîne publique ou son identifiant numérique (un supergroupe ou une chaîne commence par -100). L’API Bot n’a aucune méthode qui liste les chats dont un bot fait partie, donc Hermoso ne peut pas les connaître et ne devine jamais. |
Essayez-le dans Gemini CLI
Demandez-le en langage courant. Ce sont des phrases simples, pas un langage de commande :
« Publiez ./renders/teaser.mp4 sur notre chaîne Telegram @ourbrand avec une légende de moins de 1 024 caractères, et épinglez-la sans notifier les membres. »
Cela enchaîne render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Gemini CLI demande confirmation avant d'exécuter une commande shell, et les skills agissent via la commande hermoso, donc une publication apparaît sous forme de ligne que vous pouvez 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 Telegram : le point délicat
Vérifiez la taille du fichier avant l'appel. Telegram limite une vidéo envoyée à 50 Mo, même lorsque Hermoso transmet les données au lieu d'un lien (un lien serait limité à 20 Mo), et un rendu plus long peut nécessiter un encodage plus léger. Le bot doit déjà être administrateur de la chaîne avec l'autorisation Publier des messages, plus le droit d'épingler pour épingler un message. Le refus de Telegram indique celle qui manque.
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 Telegram avant de publier
Il n’existe pas de bibliothèque publicitaire Telegram ni de recherche de chaînes dans Hermoso, donc aucune recherche concurrentielle sur Telegram n’est revendiquée. Faites la recherche créative là où elle est publique (les bibliothèques publicitaires Meta, Google et LinkedIn, plus TikTok, Instagram, YouTube, Reddit et Threads organiques) et publiez l’annonce finie ici.
La partie payante
Il n’existe pas de publicités Telegram dans Hermoso, et nous n’en suggérons aucune. Telegram ici est une chaîne que vous possédez et gérez via votre bot : publier, épingler, modifier, compter les abonnés et suivre les invitations. Les outils payants couvrent Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads et AppLovin Ads.
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 vous revient délibérément : créer le bot avec @BotFather et l’ajouter à votre chaîne. Tout le reste est un appel d’outil.
Le reste de la matrice
Depuis Gemini CLI, publiez sur : Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Ou voir tout ce que Gemini CLI peut publier.
Publier sur Telegram 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 Telegram ?
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 Telegram, et de ceux qui recherchent les publicités déjà diffusées sur ton marché et génèrent le visuel.
Comment connecter Telegram à Gemini CLI ?
Deux étapes, une fois chacune. Lancez gemini extensions install https://github.com/hermoso-ai/hermoso, qui ajoute cinq skills Hermoso pilotant la commande hermoso, puis connectez-vous une fois avec npx -y hermoso auth login. La connexion ouvre un navigateur et enregistre l'identifiant elle-même : il n'y a donc aucune clé à créer ni à coller. Si vous voulez aussi les outils de 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 par OAuth. Créez ensuite un bot avec @BotFather dans Telegram, collez son jeton sous Paramètres → Connecteurs dans Hermoso, et ajoutez le bot à votre chaîne en tant qu'administrateur avec l'autorisation Publier des messages. Ensuite, Gemini CLI publie sur Telegram comme un appel d'outil ordinaire, en nommant la discussion à chaque fois.
Gemini CLI peut-il publier en privé ou en brouillon sur Telegram ?
Il n’existe ni brouillon ni message privé dans l’API Bot. La confidentialité sur Telegram appartient au chat : publiez dans un groupe ou une chaîne privés, et seuls ses membres la voient. Hermoso refuse une visibilité que Telegram 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 Telegram avant de publier ?
Non. Hermoso n’a ni bibliothèque publicitaire Telegram ni recherche de chaînes. Il fait la recherche créative dans les bibliothèques publicitaires publiques et sur les plateformes organiques, et Telegram est l’endroit où vous publiez le résultat.
Quelle est la limite de légende Telegram lorsqu'on publie depuis Gemini CLI ?
Un message Telegram en texte seul peut aller jusqu’à 4 096 caractères ; une fois une photo ou une vidéo jointe, le texte devient une légende et la limite passe à 1 024. Hermoso indique quelle limite s’est appliquée. 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 gérer des publicités Telegram en plus de publier ?
Non. Il n’existe aucune publicité Telegram dans Hermoso. Telegram ici est une chaîne que vous gérez via votre propre bot : publications, épingles, modifications, liens d’invitation et nombre d’abonnés.
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