Publica en Telegram desde Claude Code

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. Claude Code llega a todo ello a través de una sola conexión. Esta página cubre una parte: lo que Claude Code puede hacer de verdad en Telegram, y lo que Telegram no le permite hacer.

Conecta Hermoso a Claude Code

1. Un comando, y ninguna clave.

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

   ¿Ya estás dentro de una sesión? Escribe /plugin marketplace add hermoso-ai/hermoso, y luego /plugin install hermoso@hermoso. Instala cinco habilidades de Hermoso (research, ad-from-brand, generate, product-photoshoot y marketing) que ejecutan el comando hermoso a través de npx, así que no se carga ninguna lista de herramientas en tus sesiones, y nada cuesta contexto hasta que se ejecuta.
2. Inicia sesión una vez.

   npx -y hermoso auth login

   Abre un inicio de sesión en el navegador a través de loopback, como lo hace gh, y guarda una credencial de uso exclusivo del propietario en ~/.hermoso/config.json. Claude Code lo ejecuta por ti la primera vez que necesita Hermoso. ¿Sin navegador en esa máquina, por ejemplo en CI, un equipo remoto o un contenedor? Crea una clave en MCP & CLI → Terminal & API keys y ejecuta npx -y hermoso auth login --token hmk_…. Una clave lleva autoridad de gasto real, así que trátala como una contraseña.
3. Opcional: el servidor MCP también. Si además quieres las herramientas de Hermoso en la lista de herramientas de Claude Code, ejecuta claude mcp add hermoso -- npx -y hermoso mcp después de iniciar sesión. Lee la misma credencial guardada, así que ninguna clave va a .claude.json. Las habilidades llegan a todas las herramientas sin él.
4. Pídele algo a Claude Code. «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.

El plugin y el servidor MCP opcional llegan a las mismas herramientas y a la misma cuenta. La diferencia está en el contexto: una lista de herramientas se carga en cada sesión antes de que escribas nada, mientras que las habilidades no cuestan nada hasta que se ejecuta un comando.

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 Claude Code

• 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

Pruébalo en Claude Code

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

“Envía las cuatro imágenes de ./out/launch como un álbum de Telegram al chat -1001234567890 con el pie de ./copy/tg.txt, y registra el id del mensaje.”

Eso recorre render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Claude Code te pide permiso antes de ejecutar una herramienta, y la transcripción queda a la vista en la terminal, así que un paso de publicación es una línea que puedes leer antes de pulsar y.

Claude Code en Telegram: la parte que muerde

Se aplican dos límites de texto, y el más estricto gana en cuanto hay medios adjuntos: 4.096 caracteres para un mensaje solo de texto, 1.024 para un pie de foto, y un álbum muestra un solo pie, en su primer elemento. Hermoso sube los archivos en lugar de pasarle a Telegram un enlace, lo que eleva los límites a 10 MB por foto y 50 MB por vídeo. Guarda el id del mensaje: lo necesitas para editar y borrar, y Telegram no le da a un bot ninguna forma de consultarlo después.

El plugin no lleva ningún manifiesto de herramientas, lo que importa sobre todo en una ejecución larga y desatendida: el agente llama al comando hermoso en cada paso, y --json en cualquier comando le da una salida de máquina que puede comprobar.

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 Claude Code 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 Claude Code, publica en: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. O mira todo lo que Claude Code puede publicar.

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

Preguntas frecuentes

¿Puede Claude Code publicar en Telegram?

Sí, con el plugin de Claude Code de Hermoso. Un comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, o dentro de una sesión /plugin marketplace add hermoso-ai/hermoso y luego /plugin install hermoso@hermoso. Instala cinco habilidades de Hermoso que manejan la CLI de hermoso, así que no se carga ninguna lista de herramientas en tus sesiones. Inicia sesión una vez con npx -y hermoso auth login, que abre un navegador y guarda la credencial, así que no hay ninguna clave que crear ni que pegar. Claude Code tiene entonces más de 922 herramientas, incluidas las que publican en Telegram, además de las que investigan los anuncios que ya se emiten en tu mercado y generan el creativo desde cero.

¿Cómo conecto Telegram a Claude Code?

Dos pasos, una vez cada uno. Un solo comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, o dentro de una sesión /plugin marketplace add hermoso-ai/hermoso y luego /plugin install hermoso@hermoso. Instala cinco habilidades de Hermoso que usan la CLI de hermoso, así que no se carga ninguna lista de herramientas en tus sesiones. Inicia sesión una vez con npx -y hermoso auth login, que abre el navegador y guarda la credencial, así que no hay ninguna clave que crear ni pegar. 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 de Publicar mensajes. A partir de ahí, Claude Code publica en Telegram como una llamada normal a una herramienta, indicando cada vez el chat.

¿Claude Code necesita mi contraseña de Telegram?

No. Telegram se conecta a través de un bot que creas con @BotFather, y Hermoso solo guarda el token de ese bot, así que Claude Code publica como el bot y nunca como tu cuenta personal de Telegram. El token se puede revocar en @BotFather cuando quieras, y nunca se entrega al modelo.

¿Puede Claude Code programar una publicación de Telegram para más tarde?

Sí. schedule_post la encola en un calendario compartido con todos los demás canales, con un texto por canal si el copy debe ser distinto, y list_scheduled y cancel_scheduled la leen y la retiran. Telegram es uno de los once canales que se encolan.

¿Puede Claude Code publicar un carrusel en Telegram?

Sí, como álbum de 2 a 10 elementos con fotos y videos mezclados, que es la regla propia de Telegram para sendMediaGroup. El álbum lleva un solo texto, en su primer elemento. Claude Code llama a la misma herramienta de publicación en cualquier caso, y un canal que no puede llevar un carrusel se rechaza con el motivo real incluido.

¿Cuánto cuesta publicar en Telegram desde Claude Code?

Publicar en Telegram no cuesta créditos, porque Telegram no cobra nada por llamada. Los créditos se gastan en generar el creativo. Los planes cuestan $29, $69 y $149 al mes por 1,200, 3,000 y 7,000 créditos, y todas las funciones están en todos los planes, incluido Free. La única excepción es el SSO para empresas.