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 Pinterest, y lo que Pinterest 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 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 Claude Code
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 Claude Code
Pídelo con lenguaje normal. Son frases sencillas, no un DSL:
“Crea un tablero por línea de producto, genera cinco Pins verticales para cada uno con títulos y descripciones, y escribe todo el plan en ./out/pinterest.json listo para publicar.”
Eso recorre list_pinterest_boards → plan_ad → generate_image → post_to_pinterest. 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 Pinterest: la parte que muerde
Un script que lo prepara todo y se detiene antes del Pin es, por ahora, la forma adecuada. Los tableros se leen y escriben con acceso de prueba; Pinterest rechaza la creación de Pins en producción. Ten en cuenta también que boardId es el único campo de identidad que Hermoso rechaza al encolar en lugar de al publicar, porque «un Pin en el tablero equivocado es un error público, así que nunca elegimos uno por ti».
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 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 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 · X · LinkedIn · Bluesky · Telegram. O mira todo lo que Claude Code puede publicar.
Publica en Pinterest 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 Pinterest?
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 Pinterest, además de las que investigan los anuncios que ya se emiten en tu mercado y generan el creativo desde cero.
¿Cómo conecto Pinterest 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 Pinterest dentro de Hermoso en Ajustes → Conectores, que es una pantalla de consentimiento OAuth en el navegador. A partir de ahí, Claude Code publica en Pinterest como una llamada de herramienta normal.
¿Puede Claude Code 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. 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.
¿Puede Claude Code 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.
¿Claude Code necesita mi contraseña de Pinterest?
No. Conectas Pinterest 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.
¿Cuánto cuesta publicar en Pinterest desde Claude Code?
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.
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