Publicar en X desde Gemini CLI

Hermoso es un servidor MCP de marketing: más de 922 herramientas a través de un único endpoint con OAuth que permiten a un agente investigar los anuncios que ya se emiten en un mercado, generar anuncios terminados de imagen y video, publicarlos y crear las campañas de pago que hay detrás. Gemini CLI accede a todo ello con una sola conexión. Esta página cubre una parte: qué puede hacer Gemini CLI realmente en X, y qué no le deja hacer X.

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 X tú mismo, una vez, en Ajustes → Conectores de Hermoso. Es una pantalla de consentimiento OAuth, así que es el único paso que necesita navegador. Todo lo demás después es una llamada de herramienta.

Las herramientas de X que obtiene Gemini CLI

• post_to_x: publica texto, una imagen o un video con texto alternativo, un hilo completo, una respuesta, una cita o una encuesta, y puede restringir quién puede responder.
• post_x_article: publica un artículo de formato largo. Escríbelo en Markdown y los encabezados, listas, citas, enlaces, bloques de código y tablas se mantienen.
• edit_x_post: reescribe una publicación que ya has publicado, dentro de la hora que permite X.
• schedule_post: la pone en cola en el calendario compartido.
• x_post_metrics: los recuentos públicos de una publicación.
• x_post_insights: cifras de nivel anunciante solo de las últimas 28 horas: impresiones, clics en enlaces, visitas al perfil, reproducciones de video y cuartiles de visualización completa.
• x_post_insights_historical: las mismas cifras en cualquier intervalo de fechas, hasta 25 publicaciones a la vez. Es la herramienta para «cómo fue el mes pasado».
• x_mentions: quién habla de la marca.
• delete_x_post: elimina una publicación.

X es el único conector que cuesta dinero por llamada, y las cifras se publican en lugar de ocultarse. Meta, TikTok, LinkedIn, YouTube, Threads y Drive no cobran nada por solicitud; X nos cobra a nosotros, así que esas llamadas consumen unos pocos créditos cada una. Una publicación normal cuesta $0.015 por solicitud y una publicación con enlace, $0.200, unas 13 veces más. Los borrados, las lecturas y la escritura del texto alternativo tienen cada uno su propio precio, y las cifras se cobran por cada publicación devuelta. La detección de enlaces prefiere asumir que hay un enlace, porque equivocarse en sentido contrario nos cuesta 13 veces más. En la práctica: en X, una buena publicación vale más que cinco, y tu agente ve el precio antes de publicar. La longitud depende de la cuenta que publica, no de un límite fijo de 280. Hermoso lee la suscripción de X de esa cuenta y envía hasta 25,000 caracteres allí donde Premium lo permite, así que una publicación larga sale completa en lugar de volver rechazada, y nunca se recorta nada. Eso también es lo más barato: una publicación larga es una sola llamada facturada a X, mientras que las mismas palabras repartidas en cinco publicaciones son cinco. X Premium también desbloquea dos cosas que Hermoso publica por ti: un Artículo de formato largo, escrito en Markdown con sus encabezados, listas, citas, bloques de código y tablas intactos, y una edición de una publicación que ya has publicado, dentro de la hora que permite X.

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

Pruébalo en Gemini CLI

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

“Convierte ./notes/launch.md en una publicación de X, o en un hilo corto si no cabe, con el enlace solo en la última publicación, y dime primero el coste.”

Ese flujo pasa por get_brand → generate_text → post_to_x → x_post_insights_historical. Gemini CLI pide permiso antes de ejecutar un comando de shell, y las habilidades 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 X: lo que duele

Si añades el servidor MCP de Hermoso a Gemini CLI y va a publicar en X, nunca lo añadas con --trust. Esa marca salta todas las confirmaciones del servidor, y en X cada publicación, lectura y borrado es una llamada facturada, con una publicación que lleva enlace cobrada unas 13 veces más que una sencilla. En una cuenta Premium, una publicación larga es una llamada facturada, mientras que un hilo de cinco partes son cinco.

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 X antes de publicar

No hay biblioteca de anuncios de X que buscar. La investigación de X aquí se basa en tu propia cuenta: menciones, métricas de publicaciones y las cifras históricas de anunciantes. Lo demás de la superficie de investigación no cambia: las bibliotecas de anuncios de Meta, Google y LinkedIn, y TikTok, Instagram, YouTube, Reddit y Threads orgánicos.

La mitad de pago

Los anuncios de X llegaron en agosto de 2026, así que X ya cubre las dos mitades. La API de anuncios de X es un producto aparte, en un host distinto y con su propia firma OAuth 1.0a, por eso llegó después del resto. Hermoso ahora construye sobre ella todo el árbol de publicaciones promocionadas: campaña, line item (el nombre que X da a un grupo de anuncios), publicación promocionada, segmentación, presupuestos, estado e informes. Un anuncio de X promociona una publicación, así que el creativo es una publicación, la misma que Hermoso publica de forma orgánica. El interruptor que activa dinero real no funciona sin una confirmación explícita, igual que en las otras once plataformas. Algo que conviene saber antes de planificar un presupuesto: X concede el acceso a la API de anuncios por cuenta publicitaria y no por aplicación, así que no hay botón OAuth para ello. Añades el usuario de X de Hermoso a tu cuenta publicitaria en business.x.com → Acceso a la cuenta, y aparece en list_x_ads_accounts con el nivel de permiso que X le haya dado.

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 no es deliberadamente sin cabeza: vincular una cuenta es una pantalla de consentimiento OAuth, así que conectas el canal una vez en un navegador. Todo lo que viene después es una llamada a una herramienta.

El resto de la matriz

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

Publicar en X 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 X?

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 X, y las que investigan los anuncios que ya circulan en tu mercado y renderizan el creativo desde el principio.

¿Cómo conecto X a Gemini CLI?

Dos pasos, una vez cada uno. 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. Después conecta X dentro de Hermoso en Ajustes → Conectores, lo que abre una pantalla de consentimiento OAuth en el navegador. Desde entonces Gemini CLI publica en X como una llamada a herramienta más.

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

No. Una publicación en X es pública en el momento en que existe; la API no tiene borrador ni publicación no listada. Hermoso rechaza una visibilidad que X 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 X antes de publicar?

No a través de una biblioteca de anuncios, porque X no publica ninguna. Lo que Hermoso lee en X es tu propia cuenta: métricas de publicaciones, cifras de nivel anunciante en cualquier intervalo de fechas y menciones de la marca.

¿Cuál es el límite de caracteres de X al publicar desde Gemini CLI?

Depende de la cuenta, y Hermoso lo comprueba en lugar de adivinarlo. Una cuenta normal de X tiene un límite de 280 caracteres; con X Premium llega a 25,000. Hermoso lee la suscripción en X y envía la publicación, así que una publicación larga sale completa, y nunca se recorta nada. En una cuenta Premium, una sola publicación larga suele leerse mejor que un hilo y cuesta menos, porque es una sola llamada facturada a X, mientras que cinco partes son cinco. Premium también desbloquea los Artículos de formato largo, escritos en Markdown, y la edición de una publicación ya publicada dentro de la hora que permite X. Hermoso 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 X además de publicar?

Sí, desde agosto de 2026. Los anuncios de X funcionan en un host aparte con su propia firma OAuth 1.0a, y Hermoso construye todo el árbol sobre ellos: campaña, line item, publicación promocionada, segmentación, presupuestos, estado e informes. X concede el acceso a la API de anuncios por cuenta publicitaria y no por aplicación, así que no hay botón OAuth para ello: añades el usuario de X de Hermoso a tu cuenta publicitaria en business.x.com → Acceso a la cuenta.