Publique, agende e rode anúncios a partir do Claude Code

O que é o Claude Code?

O Claude Code é o agente de terminal da Anthropic. Ele vive em um diretório de trabalho, lê e grava arquivos, roda comandos e instala plugins de um marketplace com um único comando. Isso faz dele o lugar natural para as partes do marketing que são de fato pipelines: renderizar, conferir, publicar, registrar.

Claude Code, Claude ou Cowork? O Claude Code é o agente de terminal da Anthropic, e a Hermoso chega como plugin. No Claude na web ou no desktop, a Hermoso é um conector, e o Cowork usa esse mesmo conector.

Hermoso é marketing no piloto automático: 922+ ferramentas em um único endpoint MCP, cobrindo pesquisa de anúncios de concorrentes, anúncios finalizados em imagem e vídeo com mais de 100 modelos, publicação e agendamento em onze canais sociais, e gestão de campanhas no Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads. Uma conexão, e o Claude Code tem tudo isso.

Conectar o Hermoso ao Claude Code

1. Um comando, e sem chave.

   claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

   Já está dentro de uma sessão? Digite /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 comando hermoso pelo npx, então nenhuma lista de ferramentas é carregada nas suas sessões, e nada custa contexto até ser executado.
2. Entre uma vez.

   npx -y hermoso auth login

   Ele abre um login pelo navegador em loopback, do mesmo jeito que o gh faz, 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 rode npx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real para gastar, então trate-a como uma senha.
3. 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 mcp depois 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.
4. 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.

Todos os canais em que o Claude Code pode publicar

Cada um deles tem a própria página, com o limite real de legenda do canal, as opções de visibilidade reais, o que ele recusa e por quê, e um exemplo trabalhado escrito para o Claude Code.

Todos eles passam por uma única agenda schedule_post, com legendas por canal, e o list_scheduled informa os resultados por canal, em vez de um único visto verde, porque “a tarefa deu certo” e “a publicação saiu” são perguntas diferentes. Uma publicação agendada fica no Hermoso, então sai no horário certo, esteja o Claude Code rodando ou não.

Google Business Profile é o canal mais novo: Publicações com foto e botão na sua ficha do Google Search e do Maps, respostas às suas avaliações, edições da ficha e as ligações, cliques no site e pedidos de rota que a ficha gera. O Claude Code acessa por meio das mesmas ferramentas, e o schedule_post o coloca na mesma agenda.

Um canal que está construído, mas não oferecido

Ser direto sobre isso vale mais do que uma lista maior. Existe uma superfície de publicação no código que está retida, esperando a plataforma e não a gente:

• Reddit: a publicação orgânica e as estatísticas de posts estão construídas, mas a Responsible Builder Policy do Reddit exige aprovação formal por escrito antes que um app use a Data API, e essa autorização ainda não foi concedida. O conector está retido, em vez de ser oferecido como uma tela de OAuth que leva a uma API inativa. O Reddit Ads é outra conexão, e ela está ativa: a árvore completa de campanhas, previsão, busca de segmentação, pixels e formulários de lead.

Um conector que entregaria um OAuth bem-sucedido e uma API inativa é pior do que um que ainda não é oferecido, então ele não aparece como disponível.

Três coisas para digitar uma vez conectado

1. Pesquisa. “Quem são meus três concorrentes mais próximos, e quais são os anúncios da Meta que rodam há mais tempo? Me diga qual gancho continua se repetindo.” Ele roda find_competitors → pull_competitor_ads → mine_angles.
2. Criar. “Faça para mim um anúncio UGC 9:16 usando esse gancho, com a foto real do meu produto e as legendas queimadas no vídeo.” Ele roda get_brand → plan_ad → render_ad, e entrega uma URL de mp4 pronta.
3. Publicar. “Agende para o Instagram e o TikTok na terça às 9h, e crie uma campanha pausada no Meta em torno disso, segmentando os EUA com $30 por dia.” Ele roda schedule_post → create_meta_campaign → create_meta_ad.

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 fica deliberadamente com você: conectar cada conta, uma vez. A maioria dos canais se conecta pela tela de consentimento OAuth da própria plataforma, em um navegador; o Bluesky usa uma senha de app e o Telegram um token de bot, colados no Hermoso. Tudo depois disso é uma chamada de ferramenta.

O Claude Code pede permissão antes de rodar uma ferramenta, e a transcrição fica bem ali no terminal, então uma etapa de publicação é uma linha que você pode ler antes de apertar y.

Quanto custa

Adicionar o Hermoso ao Claude Code não custa nada a mais: há um único medidor de créditos, e ele não se importa com qual cliente fez a chamada. Uma conta gratuita começa com 30 créditos no cadastro e mais 250+ para ganhar. Os créditos são gastos apenas em modelos de IA e na pesquisa do Ad Spy; publicar, agendar, gerenciar anúncios e analytics são grátis em todos os canais, exceto no X, que cobra por chamada porque o X cobra por requisição de API. Os planos pagos custam $29, $69 e $149 por mês, por 1.200, 3.000 e 7.000 créditos, e todos os recursos estão em todos os planos. O hermoso_capabilities informa o preço exato em créditos de qualquer render antes de ele rodar.

Solução de problemas

• Um servidor local imprime a ajuda e encerra. Faltam os argumentos, o mcp final. npx -y hermoso sozinho imprime a ajuda; npx -y hermoso mcp inicia o servidor.
• Não há navegador nessa máquina. Crie uma chave em MCP & CLI → Terminal & API keys e rode npx -y hermoso auth login --token hmk_… no lugar.
• Um canal está faltando. Conecte-o no Hermoso em Configurações → Conectores e depois peça ao Claude Code para rodar o list_connectors de novo.
• O Claude Code responde sem usar o Hermoso. Cite-o no pedido: “use o Hermoso para …”. Isso deixa claro quais ferramentas devem fazer o trabalho.

Além da publicação

Publicar é a última etapa, e a menor delas. A mesma conexão dá ao Claude Code as bibliotecas de anúncios da Meta, do Google e do LinkedIn, além de TikTok, Instagram, YouTube, Reddit e Threads orgânicos para pesquisa; mais de 100 modelos de imagem, vídeo, voz e escrita em um único medidor de créditos, com avatares UGC, dublagem, aumento de resolução e formatos de anúncio HTML nativos; e a árvore completa de campanhas em doze plataformas pagas. Não há chaves de API de fornecedores para guardar e nenhum app separado para aprender.

Veja a lista completa de ferramentas, todos os agentes em que a Hermoso funciona, ou o que é um MCP de marketing. Para a história mais longa sobre este cliente em específico, veja Marketing com Claude Code.

O Hermoso em outros agentes

A mesma conta do Hermoso funciona em todos os agentes abaixo, então a sua marca, biblioteca, agenda e créditos acompanham você entre eles.

Perguntas frequentes

O Claude Code consegue publicar nas redes sociais?

Sim, depois de instalar a Hermoso. O Claude Code então pode publicar no Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram e Google Business Profile, e agendar para os onze a partir de uma única fila, com legendas específicas por canal.

Como adiciono o Hermoso ao Claude Code?

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

O Claude Code também consegue gerar o vídeo e as imagens?

Sim, de forma nativa, e não encaminhado para fora. Mais de 100 modelos de imagem, vídeo, voz e escrita ficam em um único medidor de créditos, e o Claude Code consegue precificar um render antes de rodá-lo, porque o hermoso_capabilities publica o custo exato de cada modelo. O resultado é um anúncio finalizado, com o seu produto real na cena e as legendas e um CTA sobrepostos ao render.

O Claude Code tem plano grátis?

Sim. Uma conta grátis começa com 30 créditos e mais de 250 que você pode ganhar ao configurar e criar, e o próprio servidor MCP é gratuito para adicionar ao Claude Code. Os planos pagos são $29, $69 e $149 por mês, para 1.200, 3.000 e 7.000 créditos. Todos os recursos estão em todos os planos, incluindo o Grátis, e a única exceção é o SSO empresarial.

É seguro deixar o Claude Code publicar e rodar anúncios para mim?

A Hermoso mantém as etapas que custam dinheiro ou não podem ser desfeitas atrás de travas no próprio servidor, independentemente do que o Claude Code esteja configurado para fazer: cada campanha é criada pausada, as chaves de gasto e as exclusões exigem confirmação explícita, e uma publicação só chega a uma conta que você conectou e marcou na Hermoso. O Claude Code pede permissão antes de rodar uma ferramenta, e a transcrição fica bem ali no terminal, então uma etapa de publicação é uma linha que você pode ler antes de apertar y.

O Claude Code consegue rodar a Hermoso em CI ou em um servidor?

Sim. Em uma máquina sem navegador, crie uma chave em MCP & CLI, Terminal & API keys e rode npx -y hermoso auth login --token hmk_… uma vez. Todo comando hermoso aceita --json, então uma etapa de pipeline pode validar a saída. Trate essa chave como uma senha, já que ela tem autoridade para gastar.