Publicar no Telegram a partir do Gemini CLI

Hermoso é um servidor MCP de marketing: 922+ ferramentas em um endpoint único com OAuth, que permitem a um agente pesquisar os anúncios que já rodam em um mercado, gerar anúncios finalizados em imagem e vídeo, publicá-los e montar as campanhas pagas por trás deles. O Gemini CLI acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Gemini CLI consegue fazer de fato no Telegram, e o que o Telegram não deixa que ele faça.

Conectar o Hermoso ao Gemini CLI

1. Instale a extensão.

   gemini extensions install https://github.com/hermoso-ai/hermoso

   Ela instala a versão mais recente do repositório público do Hermoso: cinco skills (research, ad-from-brand, generate, product-photoshoot e marketing) mais um arquivo de contexto GEMINI.md. As skills executam o comando hermoso pelo npx, então nada é adicionado à lista de ferramentas do Gemini CLI, e nada custa contexto até que um comando rode. gemini extensions list mostra-as em Agent skills.
2. Faça login uma vez.

   npx -y hermoso auth login

   Ele abre um login pelo navegador e guarda uma credencial de acesso restrito ao dono em ~/.hermoso/config.json. O Gemini CLI pode executá-lo por você na primeira vez que precisar do Hermoso. Sem navegador nessa máquina? Crie uma chave em MCP & CLI → Terminal & chaves de API e execute npx -y hermoso auth login --token hmk_….
3. Opcional: também o servidor MCP.

   gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp

   O Gemini CLI encontra o servidor de autorização do Hermoso quando a primeira conexão responde 401 e se registra sozinho, então nenhuma chave vai em settings.json; /mcp auth hermoso dentro de uma sessão executa o login. As skills alcançam todas as ferramentas sem isso.
4. Peça algo ao Gemini CLI. “Puxe os anúncios mais duradouros dos meus três concorrentes mais próximos e refaça o melhor gancho em um vídeo 9:16”, ou “publique este render no canal”. O agente escolhe as ferramentas; você aprova o gasto.

Rodamos a instalação acima em 2026-09-23 contra o Gemini CLI 0.60.0, em um diretório home limpo: ela puxou a versão atual de hermoso-ai/hermoso, e gemini extensions list mostrou as cinco skills e o arquivo de contexto. A extensão não traz servidor MCP próprio, e isso é intencional: uma lista de ferramentas é carregada em cada sessão, e as skills não custam nada até rodarem. O Hermoso não é afiliado nem endossado pelo Google.

Depois conecte o próprio Telegram, uma vez, em Configurações → Conectores na Hermoso, colando um token de bot do @BotFather, e adicione esse bot ao seu canal como administrador. Não há tela de consentimento: o token é a credencial, e o bot é quem publica.

As ferramentas do Telegram que o Gemini CLI recebe

• post_to_telegram: envia uma mensagem como o seu bot para o chat que você indicar: texto de até 4.096 caracteres, ou uma foto, um vídeo, ou um álbum de 2 a 10 com fotos e vídeos misturados.
• schedule_post: coloca na fila com o seu chatId, no mesmo calendário de todos os outros canais.
• list_telegram_chats: os chats que enviaram mensagem ao bot nas últimas 24 horas. Ajuda a encontrar um ID, e não é uma lista de todos os chats em que o bot está.
• edit_telegram_message / pin_telegram_message: corrige o texto ou a legenda de uma mensagem sem perder as visualizações, e fixa ou desafixa a chamada para ação.
• create_telegram_invite_link: um link de convite nomeado por campanha, com validade, limite de membros ou aprovação de entrada opcionais, para você ver quem entrou e por onde.
• telegram_account: a contagem de assinantes ou membros do chat, o título, a descrição e o link de convite.
• list_telegram_dms: o que as pessoas enviaram ao bot nas últimas 24 horas, da mais recente para a mais antiga, para responder com post_to_telegram.
• delete_telegram_message: remove uma mensagem que o bot enviou, dentro da janela de 48 horas do Telegram, depois de uma etapa de confirmação.

O Telegram conecta com um token de bot, e não com uma tela de login. Crie um bot com o @BotFather no Telegram, cole o token em Configurações → Conectores e depois adicione o bot ao seu canal como administrador com a permissão Publicar mensagens, ou a um grupo como membro que pode publicar. A Hermoso publica como esse bot, nunca como você. Dois limites são do próprio Telegram e vale planejar em torno deles: um bot não recebe visualizações por publicação nem histórico de publicações, então a contagem de assinantes e os links de convite nomeados são os números que você tem; e as mensagens enviadas ao bot são guardadas por 24 horas e depois somem. Publicar não consome créditos.

Limites do Telegram que vale conhecer antes de automatizar qualquer coisa

Experimente no Gemini CLI

Peça em linguagem comum. São frases simples, não uma DSL:

“Publique ./renders/teaser.mp4 no nosso canal do Telegram @ourbrand com legenda de até 1.024 caracteres, e fixe sem notificar os membros.”

Esse fluxo percorre render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. O Gemini CLI pede confirmação antes de executar um comando de shell, e as skills agem pelo comando hermoso, então uma publicação aparece como uma linha que você pode ler antes de dizer sim. Para ferramentas MCP, ele oferece uma vez, sempre para essa ferramenta ou sempre para o servidor.

Gemini CLI no Telegram: a parte que pega

Confira o tamanho do arquivo antes da chamada. O Telegram limita um vídeo enviado a 50MB, mesmo quando o Hermoso manda os bytes em vez de um link (um link teria limite de 20MB), e uma renderização mais longa pode precisar de uma codificação mais leve. O bot precisa já ser administrador do canal com a permissão Publicar mensagens, além da de fixar mensagens para fixar, e a recusa do Telegram diz qual está faltando.

Dois detalhes do Gemini CLI decidem o quão seguro isso é. gemini mcp add grava em .gemini/settings.json do projeto, a não ser que você passe --scope user, o que é útil quando um repositório deve sempre rodar contra uma mesma marca. E nunca adicione o Hermoso com --trust: ele pula todas as confirmações do servidor, inclusive as que aparecem antes de uma publicação. Ferramentas MCP chegam com o nome mcp_hermoso_ mais o nome da ferramenta, e --exclude-tools mantém qualquer uma delas fora por completo.

Pesquise o Telegram antes de publicar

Não existe biblioteca de anúncios do Telegram nem busca de canais na Hermoso, então ela não afirma fazer pesquisa de concorrentes no Telegram. Pesquise o criativo onde ele é público (as bibliotecas de anúncios da Meta, do Google e do LinkedIn, além do TikTok, Instagram, YouTube, Reddit e Threads orgânicos) e publique o anúncio pronto aqui.

A metade paga

Não há anúncios do Telegram na Hermoso, e não damos a entender que haja. Aqui o Telegram é um canal que você possui e administra pelo seu bot: publicar, fixar, editar, contar assinantes e acompanhar convites. As ferramentas pagas cobrem Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads.

O que o Gemini CLI não consegue fazer sozinho

Um agente com orçamento só é útil se o raio de impacto for limitado, então a cerca fica no servidor, e não em um prompt. Toda campanha, conjunto de anúncios, grupo de anúncios e anúncio é criado pausado, e as trocas de status que ativam dinheiro real se recusam a rodar sem uma flag de confirmação explícita. Cada render é cotado antes (hermoso_capabilities publica o custo exato em créditos de cada modelo antes de qualquer gasto). Os créditos são reservados antes da primeira chamada ao provedor e acertados pelo custo exato depois, então uma falha no envio devolve o valor em vez de deixar você cobrado por nada. As exclusões também exigem confirmação, e cada árvore de campanha é relida da plataforma de anúncios antes que o seu agente diga o que construiu.

Um passo fica propositalmente com você: criar o bot com o @BotFather e adicioná-lo ao seu canal. Tudo depois disso é uma chamada de ferramenta.

O resto da matriz

No Gemini CLI, publique em: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Ou veja tudo onde o Gemini CLI pode publicar.

Publique no Telegram a partir de: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip

Perguntas frequentes

O Gemini CLI consegue publicar no Telegram?

Sim, com a extensão do Gemini CLI do Hermoso. Execute gemini extensions install https://github.com/hermoso-ai/hermoso, que adiciona cinco skills do Hermoso que acionam o comando hermoso, e depois faça login uma vez com npx -y hermoso auth login. O login abre um navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Se você também quiser as ferramentas do Hermoso na própria lista do Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp adiciona o servidor hospedado, que faz login com OAuth. O Gemini CLI passa a ter 922+ ferramentas, incluindo as que publicam no Telegram, e também as que pesquisam os anúncios que já rodam no seu mercado e renderizam o criativo do zero.

Como conecto o Telegram ao Gemini CLI?

Dois passos, uma vez cada. Rode gemini extensions install https://github.com/hermoso-ai/hermoso, que adiciona cinco skills do Hermoso que acionam o comando hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Se você também quiser as ferramentas do Hermoso na lista do próprio Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp adiciona o servidor hospedado, que entra com OAuth. Depois crie um bot com @BotFather no Telegram, cole o token em Configurações → Connectors no Hermoso e adicione o bot ao seu canal como administrador com a permissão Publicar mensagens. A partir daí o Gemini CLI publica no Telegram como uma chamada de ferramenta comum, nomeando o chat a cada vez.

O Gemini CLI consegue publicar no Telegram de forma privada ou como rascunho?

A API de Bots não tem rascunho nem mensagem privada. A privacidade no Telegram pertence ao chat: publique em um grupo ou canal privado e só os membros verão. A Hermoso recusa uma visibilidade que o Telegram não consegue cumprir no momento em que você pede, em vez de publicar discretamente algo mais fraco.

O Gemini CLI consegue pesquisar o Telegram antes de publicar?

Não. A Hermoso não tem biblioteca de anúncios nem busca de canais do Telegram. Ela pesquisa o criativo nas bibliotecas públicas de anúncios e nas plataformas orgânicas, e o Telegram é onde você publica o resultado.

Qual é o limite de legenda do Telegram ao publicar a partir do Gemini CLI?

Uma mensagem de texto no Telegram vai até 4.096 caracteres; quando há uma foto ou um vídeo anexado, o texto vira legenda e o limite é de 1.024. A Hermoso diz qual limite se aplicou. Ela aplica o limite quando a publicação é criada ou colocada na fila, então o Gemini CLI é avisado na hora, em vez de falhar depois, quando ninguém está acompanhando.

O Gemini CLI consegue rodar anúncios no Telegram, além de publicar?

Não. Não há anúncios do Telegram na Hermoso. Aqui o Telegram é um canal que você administra pelo seu próprio bot: publicações, fixações, edições, links de convite e a contagem de assinantes.