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 Instagram, y lo que Instagram no le permite hacer.
Conecta Hermoso a Claude Code
- Un comando, y ninguna clave.
¿Ya estás dentro de una sesión? Escribeclaude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso/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 comandohermosoa través denpx, así que no se carga ninguna lista de herramientas en tus sesiones, y nada cuesta contexto hasta que se ejecuta. - Inicia sesión una vez.
Abre un inicio de sesión en el navegador a través de loopback, como lo hacenpx -y hermoso auth logingh, 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 ejecutanpx -y hermoso auth login --token hmk_…. Una clave lleva autoridad de gasto real, así que trátala como una contraseña. - 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 mcpdespué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. - 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.
Luego conecta Instagram tú mismo, una vez, en Ajustes → Conectores de Hermoso. Es una pantalla de consentimiento OAuth, así que es el único paso que necesita un navegador. Todo lo que viene después es una llamada a una herramienta.
Las herramientas de Instagram que obtiene Claude Code
post_to_meta: publica en Instagram contarget: "instagram". Instagram es un canal visual y la API lo confirma: una publicación necesita una imagen o un vídeo.schedule_post: la encola en el calendario compartido, con un texto por canal si el copy debe ser distinto de tu versión de Facebook o de LinkedIn.list_meta_comments / reply_to_meta_comment / moderate_meta_comment: leer, responder y moderar bajo una publicación.meta_page_insights / meta_post_insights: alcance, impresiones, guardados e interacción, por cuenta y por publicación.search_instagram: búsqueda por palabra clave en Reels públicos de Instagram, para investigar en lugar de publicar.
Dos datos de Instagram que conviene conocer antes de automatizar nada. No hay programación nativa de Instagram en la API de Meta, así que una programación es la cola de Hermoso y no la de Instagram, y pasar el scheduleAt de Facebook para Instagram se rechaza en lugar de publicar en silencio ya. Y un texto de Instagram no se puede editar una vez publicado: lo único que Meta deja cambiar en una publicación activa es si se permiten comentarios. Borrar sí está soportado: manage_meta_post elimina publicaciones normales, Stories, Reels y álbumes de carrusel completos, aunque nunca una sola tarjeta de un álbum.
Límites de Instagram que conviene conocer antes de automatizar nada
| Texto | Un texto de Instagram tiene un límite de 2.200 caracteres. Se aplica al crear o encolar la publicación, así que una publicación demasiado larga se rechaza mientras sigues ahí para corregirla, en lugar de cortarse en silencio por el camino. |
|---|---|
| Visibilidad | Solo público. La API de publicación de contenido de Meta publica de inmediato o no publica, e Instagram «no tiene publicaciones no listadas, privadas ni borradores». Si quieres un paso de revisión en Instagram, tiene que ocurrir antes de la llamada, no después. |
| Carrusel | De 2 a 10 diapositivas, y se pueden mezclar imágenes y vídeo. Ese límite superior es el de la propia Meta, citado en la tabla de capacidades que aplica: «Los carruseles se limitan a 10 imágenes, vídeos o una mezcla de ambos». El mínimo de 2 es nuestro, porque una diapositiva no es un carrusel en ninguna plataforma. Una petición de una sola diapositiva se publica como una publicación normal en lugar de rechazarse. |
| Qué cuenta | pageId. Instagram publica a través de la Página de Facebook conectada, así que el mismo campo de identidad lo selecciona. |
Pruébalo en Claude Code
Pídelo con lenguaje normal. Son frases sencillas, no un DSL:
“Crea un carrusel de 5 diapositivas a partir de ./assets/slides, comprueba que cada una cumple los límites de Instagram, publícalo, y guarda el enlace permanente en las notas de la versión.”
Eso ejecuta search_instagram → plan_ad → render_ad → post_to_meta (target: "instagram"). Claude Code pide permiso antes de ejecutar una herramienta, y la transcripción queda ahí mismo en la terminal, así que un paso de publicación es una línea que puedes leer antes de pulsar «y».
Claude Code en Instagram: la parte que muerde
Un pie de Instagram no se puede editar una vez publicado, así que incorpora la comprobación en el script en lugar de en la disculpa: haz que Claude Code te muestre el orden de las diapositivas y el texto, y solo entonces llama a la herramienta de publicación. Si un render resulta mal, manage_meta_post borra la publicación entera, incluidos los álbumes. El orden importa más de lo que la gente espera. La diapositiva 2 debe seguir a la 1, y Hermoso conserva exactamente el orden que le pasas.
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 Instagram antes de publicar
search_meta_ads cubre las ubicaciones de Instagram además de las de Facebook, porque es una sola biblioteca. Para lo orgánico, search_instagram busca Reels públicos por palabra clave, que es la superficie donde el formato realmente se mueve; las consultas de perfil y de hashtag pasan por fetch_social_data y search_instagram_hashtag.
La mitad de pago
Las ubicaciones de Instagram se compran a través de la misma estructura de campañas de Meta que Facebook: create_meta_campaign → create_meta_adset → create_meta_ad, con ubicaciones seleccionables por plataforma y posición. preview_meta_ad muestra el anuncio renderizado real por ubicación antes de gastar, y meta_insights desglosa los resultados por edad, género, ubicación y país. Ese desglose es lo que da forma a la siguiente creatividad.
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 · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. O mira todo a lo que Claude Code puede publicar.
Publicar en Instagram desde: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Marketing con Claude Code
Preguntas frecuentes
¿Puede Claude Code publicar en Instagram?
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 Instagram, además de las que investigan los anuncios que ya se emiten en tu mercado y generan el creativo desde cero.
¿Cómo conecto Instagram a Claude Code?
Dos pasos, una vez cada uno. 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. Después conecta Instagram dentro de Hermoso en Ajustes → Conectores, que es una pantalla de consentimiento OAuth en el navegador. A partir de ahí, Claude Code publica en Instagram como una llamada de herramienta normal.
¿Claude Code necesita mi contraseña de Instagram?
No. Conectas Instagram a Hermoso una vez mediante una pantalla de consentimiento OAuth en el navegador, y Claude Code lo alcanza después como una llamada a una herramienta. Vincular una cuenta es el único paso que no es sin cabeza; nada de lo que viene después necesita una contraseña, y nunca se entrega ninguna credencial al modelo.
¿Puede Claude Code programar una publicación de Instagram 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. Instagram es uno de los once canales que se encolan.
¿Puede Claude Code publicar un carrusel en Instagram?
Sí, de 2 a 10 diapositivas, y se pueden mezclar imágenes y vídeo. Diez es el límite publicado por la propia Meta, no uno que Hermoso haya inventado. 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 adjunto.
¿Cuánto cuesta publicar en Instagram desde Claude Code?
Publicar en Instagram no cuesta créditos; Meta no cobra nada por llamada a la API. Los créditos van en el render en sí. 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 el gratuito. La única excepción es el SSO empresarial.
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