Publicar no Facebook a partir do Claude Code

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 Facebook, e o que o Facebook não deixa que ele faça.

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.

Depois conecte o próprio Facebook, 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 Facebook que o Claude Code recebe

• post_to_meta: publica texto, uma imagem, um vídeo ou um post com várias fotos na Página, e recebe pageId para nunca precisar adivinhar qual Página.
• schedule_post: coloca o mesmo post na fila para o horário que você escolher, em uma agenda compartilhada com todos os outros canais.
• list_meta_pages: lista as Páginas que a conta conectou, com os respectivos ids.
• manage_meta_post: edita o texto de um post publicado, ou o exclui.
• list_meta_comments / reply_to_meta_comment / moderate_meta_comment: lê os comentários de um post, responde como a Página, e oculta ou exclui o que não deveria estar lá.
• meta_page_insights / meta_post_insights: alcance, impressões e engajamento no nível da Página e de cada post.
• upload_meta_asset: coloca um render finalizado na biblioteca de criativos da conta de anúncios.

O Facebook também é o único canal com agendamento remoto nativo. O post_to_meta aceita um scheduleAt entre dez minutos e trinta dias à frente e entrega o horário à própria Meta. Instagram e Threads não têm isso na API da Meta, e passar o parâmetro para eles é recusado, em vez de publicar imediatamente sem aviso.

Limites do Facebook que vale conhecer antes de automatizar qualquer coisa

Experimente no Claude Code

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

“Pegue o mp4 em ./renders, escreva uma legenda com a voz da marca, publique na Página como rascunho não publicado e grave o ID da publicação em ./out/posts.json.”

Isso percorre find_competitors → search_meta_ads → plan_ad → render_ad → list_meta_pages → post_to_meta. 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.

Claude Code no Facebook: a parte que pega

É aqui que um agente de terminal é de fato melhor do que um chat: o ID da publicação volta como um resultado estruturado que você pode gravar em um arquivo e validar depois. O Facebook também é o único canal com agendamento remoto nativo (post_to_meta aceita um scheduleAt entre dez minutos e trinta dias à frente), então um script pode entregar o horário à própria Meta, em vez de manter uma fila.

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 Facebook antes de publicar

A Biblioteca de Anúncios da Meta é o maior arquivo público de criativos que existe, e o search_meta_ads a consulta por palavra-chave ou por página, cobrindo posicionamentos do Facebook e do Instagram. O pull_competitor_ads e o competitor_teardown se apoiam nela, e o find_competitors descobre para onde apontá-los.

A metade paga

O Facebook é a superfície paga mais profunda que o Hermoso tem. O create_meta_campaign, o create_meta_adset e o create_meta_ad montam a árvore inteira com segmentação real: geografia até um raio em torno de uma cidade, interesses, comportamentos, públicos personalizados e semelhantes, posicionamentos, horários do dia, e limites de lance e de custo. Tudo é criado PAUSADO, sem substituição pelo chamador, e o resumo que o seu agente informa é montado a partir de uma releitura do que a Meta de fato armazenou, nunca a partir do que foi pedido. Antes de comprometer um orçamento, o preview_meta_ad renderiza o anúncio real por posicionamento como um link que você pode ver, e o estimate_meta_reach diz quantas pessoas a segmentação realmente alcança. Um aviso que economiza dinheiro: um conjunto de anúncios criado sem localizações assume apenas os Estados Unidos por padrão, e a releitura diz isso em alto e bom som.

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

A partir do Claude Code, publique em: Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo para onde o Claude Code pode publicar.

Publique no Facebook 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 Facebook?

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 Facebook, 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 Facebook 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 Facebook dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Daí em diante, o Claude Code publica no Facebook como uma chamada de ferramenta comum.

O Claude Code consegue publicar no Facebook de forma privada ou como rascunho?

Sim. O Facebook é o único canal com um rascunho de verdade: um post de Página não publicado que existe no Meta Business Suite e que ninguém de fora consegue ver. O Hermoso recusa uma visibilidade que o Facebook não consegue cumprir no momento em que você pede, em vez de publicar discretamente algo mais fraco.

Quanto custa publicar no Facebook a partir do Claude Code?

Publicar no Facebook não custa créditos, porque a Meta não cobra nada por chamada de API. Os créditos são gastos na geração: renderizar a imagem ou o vídeo que o post carrega. Os planos 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, inclusive o Free. A única exceção é o SSO empresarial.

Qual é o limite de legenda do Facebook ao publicar a partir do Claude Code?

Um post no Facebook pode ter até 63.206 caracteres, o que na prática não tem limite. O Hermoso aplica o limite quando o post é criado ou colocado na fila, então o Claude Code é avisado na hora, em vez de falhar depois, quando ninguém está acompanhando.

O Claude Code consegue agendar um post no Facebook 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 Facebook é um dos onze canais que entram na fila.