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. Codex llega a todo ello a través de una sola conexión. Esta página cubre una parte: lo que Codex puede hacer de verdad en Instagram, y lo que Instagram no le permite hacer.
Conecta Hermoso a Codex
- Un solo comando, y sin clave.
Codex lee el archivo del marketplace en el repositorio público de Hermoso e instala sus cinco habilidades (research, ad-from-brand, generate, product-photoshoot y marketing). Las habilidades ejecutan el comandocodex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermosohermosoa través denpx, así que no se carga ninguna lista de herramientas en tus sesiones y nada consume contexto hasta que se ejecuta un comando. - Inicia sesión una vez.
Se abre un inicio de sesión en el navegador y se guarda una credencial solo accesible para ti ennpx -y hermoso auth login~/.hermoso/config.json. ¿No hay navegador en esa máquina, por ejemplo en un CI o un contenedor? Crea una clave en MCP & CLI → Terminal y claves de API y ejecutanpx -y hermoso auth login --token hmk_…. Una clave tiene autoridad real para gastar, así que trátala como una contraseña. - Opcional: el servidor de MCP también.
Eso escribe el servidor encodex mcp add hermoso -- npx -y hermoso mcp~/.codex/config.tomly usa la misma credencial guardada, así que no va ninguna clave en el archivo. ¿Prefieres el endpoint alojado?codex mcp add hermoso --url https://app.hermoso.ai/mcp, y luegocodex mcp login hermosopara el inicio de sesión OAuth. Las habilidades llegan a todas las herramientas sin necesidad de ninguna de las dos cosas. - Pídele algo a Codex. «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.
Codex guarda los servidores de MCP en ~/.codex/config.toml, o en .codex/config.toml de un proyecto de confianza, y ese archivo es TOML, no JSON: un bloque mcpServers copiado no se cargará, y una entrada escrita a mano es [mcp_servers.hermoso] con command = "npx" y args = ["-y", "hermoso", "mcp"]. El mcp final es imprescindible: npx -y hermoso sin subcomando muestra la ayuda y termina. Codex lee los marketplaces de plugins en el mismo formato .claude-plugin que usa Claude Code, por eso un solo repositorio se instala en ambos.
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 Codex
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 Codex
Pídelo con lenguaje normal. Son frases sencillas, no un DSL:
“No interactivo: crea un carrusel de 4 diapositivas con las fotos de producto de hoy, publícalo en Instagram con un pie de menos de 2.200 caracteres y termina con el enlace permanente.”
Eso recorre search_instagram → plan_ad → render_ad → post_to_meta (target: "instagram"). De forma interactiva, Codex muestra la llamada antes de ejecutarla. De forma no interactiva no hay nadie a quien preguntar, lo que conviene tener en cuenta en cualquier paso que publique o gaste.
Codex en Instagram: la parte que muerde
En un flujo de Instagram sin supervisión hace falta un paso humano: un pie publicado nunca se puede editar a través de la API. Si Codex se ejecuta con un temporizador, pon la revisión antes de la publicación: genera y retén, y publica cuando se apruebe. Borrar es el único deshacer. manage_meta_post elimina publicaciones normales, historias, reels y álbumes de carrusel completos, pero al borrar se pierden también los me gusta y los comentarios.
En las ejecuciones sin supervisión, es preferible la CLI hermoso con --json en lugar del manifiesto completo de herramientas. Ocupa mucho menos contexto y es más fácil de verificar.
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 Codex 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 Codex, publica en: Facebook · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. O consulta todo lo que Codex puede publicar.
Publica en Instagram desde: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Anuncios desde la línea de comandos
Preguntas frecuentes
¿Puede Codex publicar en Instagram?
Sí, con el plugin de Codex de Hermoso. Ejecuta codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala las habilidades de Hermoso, y luego inicia sesión una vez con npx -y hermoso auth login. El inicio de sesión abre el navegador y guarda la credencial por sí mismo, así que no hay ninguna clave que crear ni pegar. Para el servidor de MCP también, ejecuta codex mcp add hermoso -- npx -y hermoso mcp. Codex tiene entonces 922+ herramientas, incluidas las que publican en Instagram y las que investigan los anuncios que ya se ven en tu mercado y crean el creativo desde cero.
¿Cómo conecto Instagram a Codex?
Dos pasos, una vez cada uno. Ejecuta codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala las habilidades de Hermoso, y luego inicia sesión una vez con npx -y hermoso auth login. El inicio de sesión abre el navegador y guarda la credencial por sí mismo, así que no hay ninguna clave que crear ni pegar. Para el servidor de MCP también, ejecuta codex mcp add hermoso -- npx -y hermoso mcp. Luego conecta Instagram dentro de Hermoso en Ajustes → Conectores, que es una pantalla de consentimiento OAuth en el navegador. A partir de ahí, Codex publica en Instagram como una llamada normal a una herramienta.
¿Puede Codex 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. Codex 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 Codex?
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.
¿Codex necesita mi contraseña de Instagram?
No. Conectas Instagram a Hermoso una vez mediante una pantalla de consentimiento OAuth en el navegador, y Codex 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 Codex 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.
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