Hermoso é um servidor MCP de marketing: 922+ ferramentas em um endpoint único com OAuth, que permitem a um agente pesquisar os anúncios que já rodam em um mercado, gerar anúncios finalizados em imagem e vídeo, publicá-los e montar as campanhas pagas por trás deles. O Claude Code acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Claude Code consegue fazer de fato no Pinterest, e o que o Pinterest não deixa que ele faça.
Conectar o Hermoso ao Claude Code
- Um comando, e sem chave.
Já está dentro de uma sessão? Digiteclaude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso/plugin marketplace add hermoso-ai/hermoso, depois/plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso (research, ad-from-brand, generate, product-photoshoot e marketing) que rodam o comandohermosopelonpx, então nenhuma lista de ferramentas é carregada nas suas sessões, e nada custa contexto até ser executado. - Entre uma vez.
Ele abre um login pelo navegador em loopback, do mesmo jeito que onpx -y hermoso auth loginghfaz, e guarda uma credencial de acesso exclusivo do dono em~/.hermoso/config.json. O Claude Code roda isso por você na primeira vez que precisar da Hermoso. Sem navegador nessa máquina, por exemplo em CI, num servidor remoto ou num contêiner? Crie uma chave em MCP & CLI → Terminal & API keys e rodenpx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real para gastar, então trate-a como uma senha. - Opcional: o servidor MCP também. Se você quiser também as ferramentas da Hermoso na lista de ferramentas do próprio Claude Code, rode
claude mcp add hermoso -- npx -y hermoso mcpdepois de entrar. Ele lê a mesma credencial guardada, então nenhuma chave vai para o.claude.json. As skills alcançam todas as ferramentas sem ele. - Peça algo ao Claude Code. “Puxe os anúncios mais duradouros dos meus três concorrentes mais próximos e refaça o melhor gancho em um vídeo 9:16”, ou “publique este render no canal”. O agente escolhe as ferramentas; você aprova o gasto.
O plugin e o servidor MCP opcional acessam as mesmas ferramentas e a mesma conta. A diferença é o contexto: uma lista de ferramentas é carregada em cada sessão antes de você digitar qualquer coisa, enquanto as skills não custam nada até que um comando seja executado.
Depois conecte o próprio Pinterest, uma vez, em Configurações → Conectores no Hermoso. Isso é uma tela de consentimento OAuth, então é a única etapa que precisa de navegador. Tudo depois disso é uma chamada de ferramenta.
As ferramentas do Pinterest que o Claude Code recebe
list_pinterest_boards: os quadros da conta, incluindo os secretos, com os seus IDs.create_pinterest_board: cria um novo quadro.post_to_pinterest: cria um Pin de imagem ou vídeo em um quadro que você indicar, com título, descrição, link de destino e texto alternativo.schedule_post: coloca o Pin na fila, levandoboardId.list_pinterest_ads_campaigns / pinterest_ads_report: leem o lado pago.
O limite que você precisa conhecer antes de planejar um fluxo no Pinterest: este app tem acesso de teste, e o Pinterest recusa a criação de Pins em produção no acesso de teste. Nas palavras deles, identificadas no primeiro Pin real: “Apps com acesso de teste não podem criar Pins em produção.” Quadros e leituras funcionam no teste (listar quadros, criar quadros, ler Pins), e o erro da Hermoso nomeia o nível de acesso em vez de mandar reconectar, porque reconectar não resolve. Um upgrade para o acesso Standard é o que libera a criação de Pins, e ele está em análise. O mesmo nível limita o lado pago: no teste, o Pinterest não expõe nenhuma conta de anúncios.
Limites do Pinterest que vale conhecer antes de automatizar qualquer coisa
| Texto | A descrição de um Pin tem limite de 800 caracteres, e o título, 100. O limite é aplicado quando a publicação é criada ou colocada na fila, então uma publicação acima do limite é recusada enquanto você ainda está ali para corrigir, em vez de ser cortada silenciosamente no caminho. |
|---|---|
| Visibilidade | Público, e o controle é o quadro, não o Pin. Um Pin herda o estado público ou secreto do seu quadro, então “publique em algum lugar privado” se expressa escolhendo um quadro secreto. Por isso o quadro é um argumento obrigatório, e não um padrão. |
| Carrossel | 2 a 5 imagens, só imagens. Ambos os limites vêm direto da especificação OpenAPI v5 do próprio Pinterest (minItems: 2, maxItems: 5), que é a única fonte legível por máquina que o Pinterest publica (o site de desenvolvedores é um app renderizado no cliente que não devolve nada a uma requisição). Não há fonte de múltiplos vídeos, então um slide de vídeo é recusado em vez de descartado. |
| Qual conta | boardId é o único campo de identidade recusado na hora de enfileirar, e não na hora de publicar. Sem ele, nada é agendado, porque “um Pin no quadro errado é um erro público, então nunca escolhemos um por você”. |
Experimente no Claude Code
Peça em linguagem comum. São frases simples, não uma DSL:
“Crie um painel por linha de produto, gere cinco Pins verticais para cada um com títulos e descrições, e grave o plano inteiro em ./out/pinterest.json pronto para publicar.”
Isso percorre list_pinterest_boards → plan_ad → generate_image → post_to_pinterest. O Claude Code pede confirmação antes de rodar uma ferramenta, e a transcrição fica ali no terminal, então cada etapa de publicação é uma linha que você lê antes de apertar y.
Claude Code no Pinterest: a parte que pega
Um script que prepara tudo e para antes do Pin é o formato certo por enquanto. Painéis são lidos e criados no acesso Trial; a criação de Pins é recusada em produção pelo próprio Pinterest. Observe também que boardId é o único campo de identificação que a Hermoso recusa na entrada da fila, e não na hora da publicação, porque “um Pin no painel errado é um erro público, por isso nunca escolhemos um no seu lugar”.
O plugin não traz manifesto de ferramentas, o que importa mais em uma execução longa e sem supervisão: o agente chama o comando hermoso a cada etapa, e --json em qualquer comando lhe dá uma saída de máquina para validar.
Pesquise o Pinterest antes de publicar
Não há biblioteca de anúncios do Pinterest, então a pesquisa de concorrentes no Pinterest não é algo que a Hermoso afirma fazer. O criativo que você rodaria ali é bem coberto pelo resto do estúdio: make_template_ad e os modelos de imagem produzem as imagens paradas verticais e com texto em destaque que a plataforma valoriza.
A metade paga
Existem ferramentas de Anúncios do Pinterest para uma campanha, um grupo de anúncios e um anúncio que promove um Pin existente, com arquivamento em vez de exclusão, porque a API de Anúncios do Pinterest não tem verbo de exclusão (Pins e quadros orgânicos podem ser excluídos, por delete_pinterest_pin e delete_pinterest_board; são os objetos pagos que só podem ser arquivados). Mas o mesmo nível de acesso de teste que bloqueia a criação de Pins não expõe contas de anúncios, então as gravações de anúncios não são utilizáveis até o acesso Standard ser liberado. Esse é o estado real, e é melhor dizê-lo numa frase aqui do que descobri-lo com um prazo apertado.
O que o Claude Code não consegue fazer sozinho
Um agente com orçamento só é útil se o raio de impacto for limitado, então a cerca fica no servidor, e não em um prompt. Toda campanha, conjunto de anúncios, grupo de anúncios e anúncio é criado pausado, e as trocas de status que ativam dinheiro real se recusam a rodar sem uma flag de confirmação explícita. Cada render é cotado antes (hermoso_capabilities publica o custo exato em créditos de cada modelo antes de qualquer gasto). Os créditos são reservados antes da primeira chamada ao provedor e acertados pelo custo exato depois, então uma falha no envio devolve o valor em vez de deixar você cobrado por nada. As exclusões também exigem confirmação, e cada árvore de campanha é relida da plataforma de anúncios antes que o seu agente diga o que construiu.
Uma etapa deliberadamente não é feita sem interface: vincular uma conta é uma tela de consentimento OAuth, então você conecta o canal uma vez em um navegador. Tudo depois disso é uma chamada de ferramenta.
O resto da matriz
Pelo Claude Code, publique em: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram. Ou veja tudo o que o Claude Code consegue publicar.
Publique no Pinterest a partir de: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Marketing com Claude Code
Perguntas frequentes
O Claude Code consegue publicar no Pinterest?
Sim, com o plugin do Claude Code da Hermoso. Um comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dentro de uma sessão, /plugin marketplace add hermoso-ai/hermoso e depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso que acionam a CLI hermoso, então nenhuma lista de ferramentas é carregada nas suas sessões. Entre uma vez com npx -y hermoso auth login, que abre o navegador e guarda a credencial por conta própria, então não há chave para criar nem para colar. O Claude Code então tem 922+ ferramentas, incluindo as que publicam no Pinterest, além das que pesquisam os anúncios que já estão rodando no seu mercado e renderizam o criativo em primeiro lugar.
Como conecto o Pinterest ao Claude Code?
Duas etapas, uma vez cada. Um comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dentro de uma sessão, /plugin marketplace add hermoso-ai/hermoso e depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso que acionam a CLI hermoso, então nenhuma lista de ferramentas é carregada nas suas sessões. Entre uma vez com npx -y hermoso auth login, que abre o navegador e guarda a credencial por conta própria, então não há chave para criar nem para colar. Depois conecte o Pinterest dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Daí em diante, o Claude Code publica no Pinterest como uma chamada de ferramenta comum.
O Claude Code consegue publicar um carrossel no Pinterest?
Em princípio, sim: de 2 a 5 imagens, só imagens, direto da especificação OpenAPI v5 do próprio Pinterest. Na prática, a criação de Pins em si está bloqueada em produção enquanto este app tiver acesso de teste. O Claude Code chama a mesma ferramenta de publicação de qualquer forma, e um canal que não comporta carrossel é recusado com o motivo real indicado.
O Claude Code consegue agendar um post no Pinterest para depois?
Sim. O schedule_post coloca o post na fila de uma agenda única compartilhada com todos os outros canais, com uma legenda por canal se o texto precisar ser diferente, e o list_scheduled e o cancel_scheduled leem e retiram o post. O Pinterest é um dos onze canais que entram na fila.
O Claude Code precisa da minha senha do Pinterest?
Não. Você conecta o Pinterest ao Hermoso uma vez, por uma tela de consentimento OAuth em um navegador, e o Claude Code então acessa como uma chamada de ferramenta. Vincular uma conta é a única etapa que não é feita sem interface; nada depois dela precisa de senha, e nenhuma credencial é entregue ao modelo.
Quanto custa publicar no Pinterest a partir do Claude Code?
O Pinterest não cobra nada por chamada de API, então publicar não consome créditos. Os créditos são gastos na geração do criativo do Pin. Os planos são $29, $69 e $149 por mês, para 1.200, 3.000 e 7.000 créditos, e todos os recursos estão em todos os planos, incluindo o Grátis. A única exceção é o SSO empresarial.
Comece grátis com 30 créditos no cadastro e ganhe mais 250+ créditos. Todos os recursos estão em todos os planos.
Começar grátis → Ver preços