Publicar en X desde Claude Code

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. Claude Code accede a todo ello con una sola conexión. Esta página cubre una parte: qué puede hacer Claude Code realmente en X, y qué no le deja hacer X.

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

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

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

“Convierte ./notes/launch.md en un hilo de X de no más de cinco publicaciones, deja el enlace solo en la última y dime el costo antes de publicar.”

Eso recorre get_brand → generate_text → post_to_x → x_post_insights_historical. 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 X: lo que duele

Pon el enlace en una sola publicación, no en las cinco. Una publicación con enlace cuesta unas 13 veces más que una sin él, así que un hilo en el que cada publicación lleva enlace es la forma cara, y la detección de enlaces tiende a suponer que hay uno. El texto que supera el límite se rechaza en lugar de recortarse, y se cuenta el exceso. En un script, eso significa un fallo limpio que puedes gestionar, en lugar de una publicación enviada a medias.

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

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

Sí, con el plugin de Claude Code de Hermoso. 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 tienes que crear ni pegar ninguna clave. Después Claude Code tiene más de 922 herramientas, incluidas las que publican en X y las que investigan los anuncios que ya se ven en tu mercado y crean el creativo desde cero.

¿Cómo conecto X 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. Luego conecta X dentro de Hermoso en Ajustes → Conectores, que es una pantalla de consentimiento OAuth en el navegador. A partir de ahí, Claude Code publica en X como una llamada normal a una herramienta.

¿Claude Code necesita mi contraseña de X?

No. Conectas X a Hermoso una vez, mediante una pantalla de consentimiento OAuth en el navegador, y Claude Code después lo usa como llamada de herramienta. Vincular la cuenta es el único paso que no es sin interfaz; nada de lo que viene después necesita contraseña, y nunca se entrega ninguna credencial al modelo.

¿Puede Claude Code programar una publicación en X para más tarde?

Sí. schedule_post la pone en cola en un calendario compartido con todos los demás canales, con un texto distinto por canal si el copy debe variar, y list_scheduled y cancel_scheduled la consultan y la retiran. X es uno de los once canales que usan esa cola.

¿Puede Claude Code publicar un carrusel en X?

No. La API de X adjunta hasta cuatro medios a una publicación y se muestran como una cuadrícula, con todas las imágenes visibles a la vez y nada que deslizar, así que un carrusel de diapositivas numeradas no se puede publicar ahí tal como está pensado. 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 X desde Claude Code?

X es el único conector que cobra créditos por llamada, porque X nos cobra por cada solicitud a su API: unos $0.015 por una publicación y $0.200 por una publicación con enlace, unas 13 veces más. Tu agente ve el precio antes de publicar. 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.