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 Pinterest, y lo que Pinterest 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 Pinterest 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 Pinterest que obtiene Codex
list_pinterest_boards: los tableros de la cuenta, incluidos los secretos, con sus ids.create_pinterest_board: crea un tablero nuevo.post_to_pinterest: crea un Pin de imagen o de video en un tablero que indiques, con título, descripción, enlace de destino y texto alternativo.schedule_post: pone en cola el Pin, conboardId.list_pinterest_ads_campaigns / pinterest_ads_report: leen el lado de pago.
El límite que necesitas conocer antes de planificar un flujo de trabajo en Pinterest: esta aplicación tiene acceso Trial, y Pinterest rechaza crear Pins en producción con ese acceso. Sus palabras, detectadas con el primer Pin real: «Las aplicaciones con acceso Trial no pueden crear Pins en producción.» Los tableros y las lecturas sí funcionan con Trial (listar tableros, crear tableros, leer Pins), y el error de Hermoso nombra el nivel de acceso en lugar de pedirte que reconectes, porque reconectar no puede arreglarlo. Una actualización al acceso Standard es lo que desbloquea la creación de Pins, y está pendiente de revisión. El mismo nivel limita el lado de pago: con Trial, Pinterest no expone ninguna cuenta publicitaria.
Límites de Pinterest que conviene conocer antes de automatizar nada
| Texto | Una descripción de Pin tiene un límite de 800 caracteres, y un título de 100. Se aplica al crear o poner en cola la publicación, así que una publicación demasiado larga se rechaza mientras sigues ahí para corregirla, en lugar de recortarse en silencio al salir. |
|---|---|
| Visibilidad | Público, y el control es el tablero, no el Pin. Un Pin hereda el estado público o secreto de su tablero, así que «publicarlo en algún sitio privado» se expresa eligiendo un tablero secreto. Por eso el tablero es un argumento obligatorio y no un valor por defecto. |
| Carrusel | De 2 a 5 imágenes, solo imágenes. Ambos límites vienen directamente de la especificación OpenAPI v5 de Pinterest (minItems: 2, maxItems: 5), que es la única fuente legible por máquina que publica Pinterest (su sitio para desarrolladores es una aplicación que se genera en el cliente y no devuelve nada a una petición). No hay una fuente de varios videos, así que una diapositiva de video se rechaza en lugar de descartarse. |
| Qué cuenta | boardId, y es el único campo de identidad que se rechaza al poner en cola en lugar de al publicar. Si se omite, no se programa nada, porque «un Pin en el tablero equivocado es un error público, así que nunca elegimos uno por ti». |
Pruébalo en Codex
Pídelo con lenguaje normal. Son frases sencillas, no un DSL:
“No interactivo: para cada producto nuevo del feed, genera una imagen vertical de Pin, un título y una descripción, y prepara todo el lote como JSON.”
Eso recorre list_pinterest_boards → plan_ad → generate_image → post_to_pinterest. 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 Pinterest: la parte que muerde
Prepara, no publiques. Un trabajo sin supervisión que intente crear Pins en producción con acceso de prueba fallará en cada elemento, y ninguna política de reintentos arregla un nivel de acceso. Los tableros se leen y escriben, así que la estructura se puede construir de verdad, y boardId se rechaza al encolar en lugar de al ejecutarse. En una ejecución programada, eso marca la diferencia entre un fallo limpio ahora y uno silencioso más tarde.
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 Pinterest antes de publicar
No hay biblioteca de anuncios de Pinterest, así que Hermoso no afirma investigar a la competencia en Pinterest. El creativo que usarías allí está bien cubierto por el resto del estudio: make_template_ad y los modelos de imagen producen las imágenes fijas verticales y con mucho texto que premia esta plataforma.
La mitad de pago
Existen herramientas de anuncios de Pinterest para una campaña, un grupo de anuncios y un anuncio que promociona un Pin existente, con archivado en lugar de borrado, porque la API de anuncios de Pinterest no tiene verbo de borrado (los Pins y tableros orgánicos sí se borran, con delete_pinterest_pin y delete_pinterest_board; los objetos de pago solo se pueden archivar). Pero el mismo nivel Trial que bloquea la creación de Pins no expone cuentas publicitarias, así que las escrituras de anuncios no se pueden usar hasta que llegue el acceso Standard. Ese es el estado real, y es mejor decirlo en una frase aquí que descubrirlo con un plazo encima.
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 · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram. O consulta todo lo que Codex puede publicar.
Publica en Pinterest 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 Pinterest?
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 Pinterest y las que investigan los anuncios que ya se ven en tu mercado y crean el creativo desde cero.
¿Cómo conecto Pinterest 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 Pinterest dentro de Hermoso en Ajustes → Conectores, que es una pantalla de consentimiento OAuth en el navegador. A partir de ahí, Codex publica en Pinterest como una llamada normal a una herramienta.
¿Codex necesita mi contraseña de Pinterest?
No. Conectas Pinterest 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.
¿Cuánto cuesta publicar en Pinterest desde Codex?
Pinterest no cobra nada por llamada a la API, así que publicar no cuesta créditos. Los créditos se gastan en generar el creativo del Pin. 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.
¿Puede Codex publicar un carrusel en Pinterest?
Sí en principio: de 2 a 5 imágenes, solo imágenes, según la especificación OpenAPI v5 de Pinterest. En la práctica, la creación de Pins está bloqueada en producción mientras esta aplicación tenga acceso Trial. 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 incluido.
¿Puede Codex programar una publicación de Pinterest 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. Pinterest 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