Publicar no Pinterest a partir do Codex

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 Codex acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Codex consegue fazer de fato no Pinterest, e o que o Pinterest não deixa que ele faça.

Conectar o Hermoso ao Codex

1. Um comando, e nenhuma chave.

   codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso

   O Codex lê o arquivo de marketplace no repositório público da Hermoso e instala as cinco skills dele (research, ad-from-brand, generate, product-photoshoot e marketing). As skills rodam o comando hermoso pelo npx, então nenhuma lista de ferramentas é carregada nas suas sessões e nada custa contexto até um comando rodar.
2. Entre uma vez.

   npx -y hermoso auth login

   Ele abre uma entrada pelo navegador e guarda uma credencial, só com acesso do dono, em ~/.hermoso/config.json. Sem navegador nessa máquina, por exemplo em CI ou em um contêiner? Crie uma chave em MCP & CLI → Terminal e chaves de API e rode npx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real de gasto, então trate-a como uma senha.
3. Opcional: o servidor MCP também.

   codex mcp add hermoso -- npx -y hermoso mcp

   Isso grava o servidor em ~/.codex/config.toml e lê a mesma credencial guardada, então nenhuma chave vai no arquivo. Prefere o endpoint hospedado? codex mcp add hermoso --url https://app.hermoso.ai/mcp e depois codex mcp login hermoso para o login OAuth. As skills alcançam todas as ferramentas sem nenhum dos dois.
4. Peça algo ao Codex. “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 Codex guarda os servidores MCP em ~/.codex/config.toml, ou em .codex/config.toml de um projeto confiável, e esse arquivo é TOML, não JSON: um bloco mcpServers copiado não carrega, e uma entrada escrita à mão é [mcp_servers.hermoso] com command = "npx" e args = ["-y", "hermoso", "mcp"]. O mcp final é essencial: npx -y hermoso sem subcomando só mostra a ajuda e sai. O Codex lê marketplaces de plugin no mesmo layout .claude-plugin que o Claude Code usa, por isso um único repositório instala nos dois.

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 Codex 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, levando boardId.
• 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

Experimente no Codex

Peça em linguagem comum. São frases simples, não uma DSL:

“Sem interação: para cada produto novo do feed, gere uma imagem vertical de Pin, um título e uma descrição, e prepare o lote inteiro como JSON.”

Isso percorre list_pinterest_boards → plan_ad → generate_image → post_to_pinterest. No modo interativo, o Codex mostra a chamada antes de rodá-la. No modo não interativo não há ninguém para perguntar, o que vale a pena considerar em qualquer etapa que publique ou gaste.

Codex no Pinterest: a parte que pega

Prepare, não publique. Um job sem supervisão que tenta criar Pins em produção com acesso Trial vai falhar em todos os itens, e nenhuma política de tentativas resolve um nível de acesso. Os painéis lêem e gravam, então a estrutura pode ser construída de verdade, e o boardId é recusado na entrada da fila, e não na hora de disparar. Para uma execução agendada, essa é a diferença entre uma falha limpa agora e uma silenciosa depois.

Em execuções sem supervisão, prefira a CLI hermoso com --json ao manifesto completo de ferramentas. Ela custa bem menos contexto e é mais fácil de 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 Codex 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 Codex, publique em: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram. Ou veja tudo o que o Codex consegue publicar.

Publique no Pinterest a partir de: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Anúncios pela linha de comando

Perguntas frequentes

O Codex consegue publicar no Pinterest?

Sim, com o plugin do Codex da Hermoso. Rode codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala as skills da Hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Para o servidor MCP também, rode codex mcp add hermoso -- npx -y hermoso mcp. O Codex passa a ter mais de 922+ ferramentas, incluindo as que publicam no Pinterest e as que pesquisam os anúncios que já estão rodando no seu mercado e criam o criativo do zero.

Como conecto o Pinterest ao Codex?

Duas etapas, uma vez cada. Rode codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala as skills da Hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Para o servidor MCP também, rode codex mcp add hermoso -- npx -y hermoso mcp. Depois conecte o Pinterest dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Depois disso o Codex publica no Pinterest como uma chamada de ferramenta comum.

O Codex 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 Codex 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 Codex?

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.

O Codex 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 Codex 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 Codex 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.