Publica en Telegram desde Gemini CLI

Gemini CLI puede publicar en Telegram como tu bot. Tú indicas el chat, Hermoso sube los archivos y el id del mensaje vuelve por si luego quieres editarlo.

Hermoso es un servidor MCP de marketing: 922+ herramientas a través de un único endpoint con OAuth que permiten a un agente investigar los anuncios que ya se publican en un mercado, generar anuncios terminados de imagen y vídeo, publicarlos y construir las campañas de pago que hay detrás. Gemini CLI llega a todo ello a través de una sola conexión. Esta página cubre una parte: lo que Gemini CLI puede hacer de verdad en Telegram, y lo que Telegram no le permite hacer.

Conecta Hermoso a Gemini CLI

  1. Instala la extensión.
    gemini extensions install https://github.com/hermoso-ai/hermoso
    Instala la última versión del repositorio público de Hermoso: cinco habilidades (research, ad-from-brand, generate, product-photoshoot y marketing) más un archivo de contexto GEMINI.md. Las habilidades ejecutan el comando hermoso a través de npx, así que no se añade nada a la lista de herramientas de Gemini CLI y no cuesta contexto hasta que se ejecuta un comando. gemini extensions list las muestra en Agent skills.
  2. Inicia sesión una vez.
    npx -y hermoso auth login
    Abre un inicio de sesión en el navegador y guarda una credencial de uso exclusivo del propietario en ~/.hermoso/config.json. Gemini CLI puede ejecutarlo por ti la primera vez que necesite Hermoso. ¿No hay navegador en esa máquina? Crea una clave en MCP & CLI → Terminal & API keys y ejecuta npx -y hermoso auth login --token hmk_….
  3. Opcional: también el servidor MCP.
    gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp
    Gemini CLI encuentra el servidor de autorización de Hermoso cuando la primera conexión responde 401 y se registra por sí mismo, así que no va ninguna clave en settings.json; /mcp auth hermoso dentro de una sesión ejecuta el inicio de sesión. Las habilidades llegan a todas las herramientas sin él.
  4. Pídele algo a Gemini CLI. «Saca los anuncios de más larga duración de mis tres competidores más cercanos y remezcla el mejor gancho en un vídeo 9:16», o «publica este render en el canal». El agente elige las herramientas; tú apruebas el gasto.

Ejecutamos la instalación de arriba el 2026-09-23 con Gemini CLI 0.60.0 en un directorio personal limpio: descargó la versión actual de hermoso-ai/hermoso, y gemini extensions list mostró las cinco habilidades y el archivo de contexto. La extensión no lleva un servidor MCP propio, y es deliberado: una lista de herramientas se carga en cada sesión, y las habilidades no cuestan nada hasta que se ejecutan. Hermoso no está afiliado ni respaldado por Google.

Después conecta Telegram tú mismo, una vez, en Ajustes → Conectores de Hermoso pegando un token de bot de @BotFather, y añade ese bot a tu canal como administrador. No hay pantalla de consentimiento: el token es la credencial, y el bot es quien publica.

Las herramientas de Telegram que obtiene Gemini CLI

  • post_to_telegram: envía un mensaje como tu bot al chat que indiques: texto de hasta 4,096 caracteres, o una foto, un video, o un álbum de 2 a 10 con fotos y videos mezclados.
  • schedule_post: la pone en cola con su chatId en el mismo calendario que los demás canales.
  • list_telegram_chats: los chats que escribieron al bot en las últimas 24 horas. Sirve para encontrar un id, y no es una lista de todos los chats en los que está el bot.
  • edit_telegram_message / pin_telegram_message: corrige el texto o el pie de un mensaje sin perder sus visualizaciones, y fija o desfija la llamada a la acción.
  • create_telegram_invite_link: un enlace de invitación con nombre por campaña, con caducidad opcional, límite de miembros o aprobación de entrada, para que veas quién se unió y desde dónde.
  • telegram_account: el número de suscriptores o miembros del chat, su título, su descripción y su enlace de invitación.
  • list_telegram_dms: lo que la gente envió al bot en las últimas 24 horas, del más reciente al más antiguo, para responder con post_to_telegram.
  • delete_telegram_message: elimina un mensaje que envió el bot, dentro de la ventana de 48 horas de Telegram, tras un paso de confirmación.

Telegram se conecta con un token de bot, no con una pantalla de inicio de sesión. Crea un bot con @BotFather en Telegram, pega su token en Ajustes → Conectores, y luego añade el bot a tu canal como administrador con permiso para publicar mensajes, o a un grupo como miembro que pueda escribir. Hermoso publica como ese bot, nunca como tú. Hay dos límites de Telegram que conviene tener en cuenta al planificar: un bot no obtiene visualizaciones por publicación ni historial de publicaciones, así que el número de suscriptores y los enlaces de invitación con nombre son las cifras que tienes; y los mensajes enviados al bot se guardan 24 horas y luego desaparecen. Publicar no cuesta créditos.

Límites de Telegram que conviene conocer antes de automatizar nada

TextoUn mensaje de Telegram admite 4,096 caracteres, pero solo 1,024 cuando se adjunta una foto o un video, porque el texto pasa a ser un pie. Se aplica al crear o poner en cola la publicación, así que una publicación demasiado larga se rechaza mientras sigues ahí para corregirla, en lugar de recortarse en silencio al salir.
VisibilidadEnviado o no enviado, sin forma de borrador, no listada ni privada. Quién lo ve lo decide el chat: «publica en un grupo o canal privado y solo lo verán sus miembros». silent lo entrega sin sonido de notificación, y no cambia nada sobre quién puede ver el mensaje.
CarruselDe 2 a 10 elementos como álbum, y se pueden mezclar fotos y videos. Ambos límites son de Telegram, de sendMediaGroup en la API de Bot («debe incluir de 2 a 10 elementos»), y lo mismo la mezcla. El álbum muestra un solo texto, en su primer elemento. Hermoso sube los archivos en lugar de pasar enlaces, lo que eleva los límites de Telegram a 10 MB por foto y 50 MB por video.
Qué cuentachatId, obligatorio en cada publicación: el @nombre de un canal público o el id numérico (un supergrupo o canal empieza por -100). La API de Bot no tiene método para listar los chats en los que está un bot, así que Hermoso no puede conocerlos y nunca adivina.

Pruébalo en Gemini CLI

Pídelo con lenguaje normal. Son frases sencillas, no un DSL:

“Publica ./renders/teaser.mp4 en nuestro canal de Telegram @ourbrand con un pie de menos de 1.024 caracteres, y fíjalo sin notificar a los miembros.”

Así se recorre render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Gemini CLI pide permiso antes de ejecutar un comando de shell, y las skills actúan a través del comando hermoso, así que una publicación aparece como una línea que puedes leer antes de decir que sí. Para las herramientas MCP ofrece una vez, siempre para esa herramienta o siempre para el servidor.

Gemini CLI en Telegram: la parte que muerde

Comprueba el tamaño del archivo antes de la llamada. Telegram limita un video subido a 50MB, aunque Hermoso envíe los bytes en lugar de un enlace (un enlace tendría un límite de 20MB), y un render más largo puede necesitar una codificación más ligera. El bot debe ser ya administrador con el permiso Publicar mensajes en el canal, además del permiso de fijar para poder fijar, y el rechazo de Telegram indica cuál falta.

Dos detalles de Gemini CLI deciden lo segura que es esta configuración. gemini mcp add escribe en .gemini/settings.json del proyecto a menos que pases --scope user, lo cual es útil cuando un repositorio siempre debe trabajar con una misma marca. Y nunca añadas Hermoso con --trust: salta todas las confirmaciones del servidor, incluidas las que aparecen antes de una publicación. Las herramientas MCP llegan con el nombre mcp_hermoso_ más el nombre de la herramienta, y --exclude-tools mantiene fuera cualquiera de ellas.

Investiga Telegram antes de publicar

No hay biblioteca de anuncios de Telegram ni búsqueda de canales en Hermoso, así que no afirma investigar a la competencia en Telegram. Investiga el creativo donde sea público (las bibliotecas de anuncios de Meta, Google y LinkedIn, además de TikTok, Instagram, YouTube, Reddit y Threads orgánicos) y publica aquí el anuncio terminado.

La mitad de pago

No hay anuncios de Telegram en Hermoso, y no damos a entender que los haya. Telegram aquí es un canal que tú tienes y diriges a través de tu bot: publicar, fijar, editar, contar suscriptores y medir invitaciones. Las herramientas de pago cubren Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads y AppLovin Ads.

Lo que Gemini CLI no puede hacer por sí solo

Un agente con presupuesto solo es útil si el radio de impacto está acotado, así que la valla está en el servidor y no en un prompt. Cada campaña de anuncios, conjunto de anuncios, grupo de anuncios y anuncio se crea en pausa, y los cambios de estado que activan dinero real se niegan a ejecutarse sin una marca de confirmación explícita. Cada render se cotiza primero (hermoso_capabilities publica el coste exacto en créditos de cada modelo antes de que se gaste nada). Los créditos se reservan antes de la primera llamada al proveedor y se liquidan al coste exacto después, así que un envío fallido se reembolsa en lugar de dejarte cobrado por nada. Los borrados también requieren confirmación, y cada estructura de campaña se lee de nuevo desde la plataforma publicitaria antes de que tu agente te diga qué ha construido.

Un paso queda deliberadamente en tus manos: crear el bot con @BotFather y añadirlo a tu canal. Todo lo demás después es una llamada de herramienta.

El resto de la matriz

Desde Gemini CLI, publica en: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. O consulta todo lo que Gemini CLI puede publicar.

Publicar en Telegram desde: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip

Preguntas frecuentes

¿Puede Gemini CLI publicar en Telegram?

Sí, con la extensión de Gemini CLI de Hermoso. Ejecuta gemini extensions install https://github.com/hermoso-ai/hermoso, que añade cinco habilidades de Hermoso que manejan el comando hermoso, y luego inicia sesión una vez con npx -y hermoso auth login. El inicio de sesión abre un navegador y guarda la credencial por sí mismo, así que no hay ninguna clave que crear ni que pegar. Si además quieres que las herramientas de Hermoso aparezcan en la lista propia de Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp añade el servidor alojado, que inicia sesión con OAuth. Gemini CLI tendrá entonces más de 922+ herramientas, incluidas las que publican en Telegram, y las que investigan los anuncios que ya circulan en tu mercado y renderizan el creativo desde el principio.

¿Cómo conecto Telegram a Gemini CLI?

Dos pasos, una vez cada uno. Ejecuta gemini extensions install https://github.com/hermoso-ai/hermoso, que añade cinco skills de Hermoso que controlan el comando hermoso, y luego inicia sesión una vez con npx -y hermoso auth login. El inicio de sesión abre un navegador y guarda la credencial por sí mismo, así que no hay clave que crear ni que pegar. Si también quieres las herramientas de Hermoso en la lista de herramientas de Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp añade el servidor alojado, que inicia sesión con OAuth. Después crea un bot con @BotFather en Telegram, pega su token en Ajustes → Conectores de Hermoso y añade el bot a tu canal como administrador con el permiso Publicar mensajes. Desde ahí, Gemini CLI publica en Telegram como una llamada de herramienta normal, indicando el chat cada vez.

¿Puede Gemini CLI publicar en privado o como borrador en Telegram?

La API de Bot no tiene borrador ni mensaje privado. La privacidad en Telegram pertenece al chat: publica en un grupo o canal privado y solo lo verán sus miembros. Hermoso rechaza una visibilidad que Telegram no puede cumplir en el momento en que la pides, en lugar de publicar en silencio algo más débil.

¿Puede Gemini CLI investigar Telegram antes de publicar?

No. Hermoso no tiene biblioteca de anuncios de Telegram ni búsqueda de canales. Investiga el creativo en las bibliotecas de anuncios públicas y en las plataformas orgánicas, y Telegram es donde publicas el resultado.

¿Cuál es el límite de texto de Telegram al publicar desde Gemini CLI?

Un mensaje de Telegram solo de texto admite 4,096 caracteres; en cuanto se adjunta una foto o un video, el texto es un pie y el límite es de 1,024. Hermoso indica qué presupuesto se aplicó. Lo aplica al crear o poner en cola la publicación, así que Gemini CLI se entera de inmediato en lugar de fallar más tarde, cuando nadie está mirando.

¿Puede Gemini CLI lanzar anuncios de Telegram además de publicar?

No. No hay anuncios de Telegram en Hermoso. Telegram aquí es un canal que diriges con tu propio bot: publicaciones, fijados, ediciones, enlaces de invitación y el número de suscriptores.

Empieza gratis con 30 créditos al registrarte y consigue 250+ más. Todas las funciones están en todos los planes.

Empieza gratis →   Ver precios