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 Gemini CLI acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Gemini CLI consegue fazer de fato no Pinterest, e o que o Pinterest não deixa que ele faça.
Conectar o Hermoso ao Gemini CLI
- Instale a extensão.
Ela instala a versão mais recente do repositório público do Hermoso: cinco skills (research, ad-from-brand, generate, product-photoshoot e marketing) mais um arquivo de contextogemini extensions install https://github.com/hermoso-ai/hermosoGEMINI.md. As skills executam o comandohermosopelonpx, então nada é adicionado à lista de ferramentas do Gemini CLI, e nada custa contexto até que um comando rode.gemini extensions listmostra-as em Agent skills. - Faça login uma vez.
Ele abre um login pelo navegador e guarda uma credencial de acesso restrito ao dono emnpx -y hermoso auth login~/.hermoso/config.json. O Gemini CLI pode executá-lo por você na primeira vez que precisar do Hermoso. Sem navegador nessa máquina? Crie uma chave em MCP & CLI → Terminal & chaves de API e executenpx -y hermoso auth login --token hmk_…. - Opcional: também o servidor MCP.
O Gemini CLI encontra o servidor de autorização do Hermoso quando a primeira conexão responde 401 e se registra sozinho, então nenhuma chave vai emgemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcpsettings.json;/mcp auth hermosodentro de uma sessão executa o login. As skills alcançam todas as ferramentas sem isso. - Peça algo ao Gemini CLI. “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.
Rodamos a instalação acima em 2026-09-23 contra o Gemini CLI 0.60.0, em um diretório home limpo: ela puxou a versão atual de hermoso-ai/hermoso, e gemini extensions list mostrou as cinco skills e o arquivo de contexto. A extensão não traz servidor MCP próprio, e isso é intencional: uma lista de ferramentas é carregada em cada sessão, e as skills não custam nada até rodarem. O Hermoso não é afiliado nem endossado pelo Google.
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 Gemini CLI 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 Gemini CLI
Peça em linguagem comum. São frases simples, não uma DSL:
“Crie um board para a linha de outono, gere seis imagens verticais de Pin com títulos e descrições e grave o conjunto em ./out/pins.json.”
Isso percorre list_pinterest_boards → plan_ad → generate_image → post_to_pinterest. O Gemini CLI pede confirmação antes de rodar um comando de shell, e as skills atuam pelo comando hermoso, então uma publicação aparece como uma linha que você pode ler antes de dizer sim. Para ferramentas MCP, ele oferece permitir uma vez, sempre para aquela ferramenta ou sempre para o servidor.
Gemini CLI no Pinterest: a parte que pega
Prepare os Pins como dados agora. Os boards listam e criam com acesso Trial; a criação de Pins é recusada em produção pelo próprio Pinterest, e nenhuma nova tentativa muda um nível de acesso. Quando o acesso Standard for liberado, o arquivo que você preparou é o lote. boardId é obrigatório e recusado na entrada da fila quando falta, porque um Pin no board errado é um erro público.
Dois detalhes do Gemini CLI decidem o quão seguro isso é. gemini mcp add grava em .gemini/settings.json do projeto, a não ser que você passe --scope user, o que é útil quando um repositório deve sempre rodar contra uma mesma marca. E nunca adicione o Hermoso com --trust: ele pula todas as confirmações do servidor, inclusive as que aparecem antes de uma publicação. Ferramentas MCP chegam com o nome mcp_hermoso_ mais o nome da ferramenta, e --exclude-tools mantém qualquer uma delas fora por completo.
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 Gemini CLI 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
A partir do Gemini CLI, publique em: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram. Ou veja tudo o que o Gemini CLI pode publicar.
Publique no Pinterest a partir de: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
Perguntas frequentes
O Gemini CLI consegue publicar no Pinterest?
Sim, com a extensão do Gemini CLI do Hermoso. Execute gemini extensions install https://github.com/hermoso-ai/hermoso, que adiciona cinco skills do Hermoso que acionam o comando hermoso, e depois faça login uma vez com npx -y hermoso auth login. O login abre um navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Se você também quiser as ferramentas do Hermoso na própria lista do Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp adiciona o servidor hospedado, que faz login com OAuth. O Gemini CLI passa a ter 922+ ferramentas, incluindo as que publicam no Pinterest, e também as que pesquisam os anúncios que já rodam no seu mercado e renderizam o criativo do zero.
Como conecto o Pinterest ao Gemini CLI?
Duas etapas, uma vez cada. Execute gemini extensions install https://github.com/hermoso-ai/hermoso, que adiciona cinco skills do Hermoso que acionam o comando hermoso, e depois faça login uma vez com npx -y hermoso auth login. O login abre um navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Se você também quiser as ferramentas do Hermoso na própria lista do Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp adiciona o servidor hospedado, que faz login com OAuth. Depois conecte o Pinterest dentro do Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. A partir daí, o Gemini CLI publica no Pinterest como uma chamada de ferramenta comum.
Qual é o limite de legenda do Pinterest ao publicar a partir do Gemini CLI?
A descrição de um Pin tem limite de 800 caracteres, e o título, 100. A Hermoso aplica o limite quando a publicação é criada ou colocada na fila, então o Gemini CLI é avisado na hora, em vez de falhar depois, quando ninguém está acompanhando.
O Gemini CLI consegue pesquisar o Pinterest antes de publicar?
Não existe biblioteca de anúncios do Pinterest, e a Hermoso não afirma fazer pesquisa de concorrentes ali. O restante da área de pesquisa segue igual: as bibliotecas de anúncios da Meta, do Google e do LinkedIn, além do TikTok, Instagram, YouTube, Reddit e Threads orgânicos.
O Gemini CLI consegue publicar no Pinterest de forma privada ou como rascunho?
A visibilidade no Pinterest fica no quadro, e não no Pin: um Pin herda o estado público ou secreto do seu quadro, por isso o quadro é um argumento obrigatório, e não um padrão. A Hermoso recusa uma visibilidade que o Pinterest não consegue cumprir no momento em que você pede, em vez de publicar discretamente algo mais fraco.
O Gemini CLI consegue rodar anúncios no Pinterest, além de publicar?
As ferramentas de Anúncios do Pinterest existem (campanha, grupo de anúncios e um anúncio que promove um Pin), 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.
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