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 Facebook, e o que o Facebook 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 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 Gemini CLI recebe
post_to_meta: publica texto, uma imagem, um vídeo ou um post com várias fotos na Página, e recebepageIdpara 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
| Texto | Um post no Facebook pode ter até 63.206 caracteres, o que na prática não tem limite. O limite é aplicado quando o post é criado ou colocado na fila, então um post longo demais é recusado enquanto você ainda está ali para corrigir, em vez de ser cortado em silêncio na saída. |
|---|---|
| Visibilidade | Público ou rascunho. Um rascunho é um post de Página realmente não publicado, o que é útil para revisão: ele existe no Meta Business Suite e ninguém de fora consegue vê-lo. Não há opção não listada nem privada: “um post de Página do Facebook está publicado ou guardado como rascunho não publicado”. |
| Carrossel | 2 slides ou mais, somente fotos. A Meta não publica um máximo para o attached_media que possamos obter, então o Hermoso não inventa um e o atribui ao Facebook. O único limite é o nosso, em 30 slides, e a recusa diz de quem ele é: “O Facebook não publica um máximo documentado para attached_media, então este limite é nosso, não deles.” Vídeo não pode entrar em um carrossel de fotos do Facebook; essa é outra restrição da API da Meta, e o Hermoso recusa em vez de descartar o clipe em silêncio. |
| Qual conta | pageId. Isso importa no momento em que uma marca conecta mais de uma Página: o caminho de publicação recusa pelo nome em vez de escolher uma por você, e um agendamento que não conseguisse carregar essa resposta transformaria a recusa em falha horas depois, sem ninguém acompanhando. |
Experimente no Gemini CLI
Peça em linguagem comum. São frases simples, não uma DSL:
“Renderize um anúncio de imagem 4:5 da nossa marca, publique-o na Página do Facebook como rascunho não publicado e grave o id da publicação em ./out/facebook.json.”
Isso percorre find_competitors → search_meta_ads → plan_ad → render_ad → list_meta_pages → post_to_meta. 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 Facebook: a parte que pega
O Facebook tem o único rascunho de verdade entre estes canais e o único agendamento remoto nativo: post_to_meta aceita um scheduleAt entre dez minutos e trinta dias à frente, então a Meta segura o horário em vez de uma sessão de terminal que precisa ficar aberta. Com mais de uma Página conectada, faça o Gemini CLI rodar list_meta_pages primeiro; o caminho de publicação se recusa a adivinhar.
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 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 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: Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo o que o Gemini CLI pode publicar.
Publique no Facebook 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 Facebook?
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 Facebook, e também as que pesquisam os anúncios que já rodam no seu mercado e renderizam o criativo do zero.
Como conecto o Facebook 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 Facebook dentro do Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. A partir daí, o Gemini CLI publica no Facebook como uma chamada de ferramenta comum.
O Gemini CLI consegue publicar um carrossel no Facebook?
Sim, como publicação do Facebook com várias fotos: de dois slides para cima, só fotos. A Meta não publica um máximo para isso que conseguíssemos encontrar, então a Hermoso aplica o próprio limite de 30 slides e diz que esse limite é dela, e não do Facebook. O Gemini CLI 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 Gemini CLI consegue rodar anúncios no Facebook, além de publicar?
Sim. A árvore de campanhas da Meta inteira pode ser montada (campanha, conjunto de anúncios, anúncio, segmentação, públicos e orçamentos), com ferramentas de prévia e de estimativa de alcance antes de qualquer orçamento ser comprometido.
O Gemini CLI precisa da minha senha do Facebook?
Não. Você conecta o Facebook ao Hermoso uma vez, por uma tela de consentimento OAuth em um navegador, e o Gemini CLI 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.
O Gemini CLI consegue pesquisar o Facebook antes de publicar?
Sim. A Biblioteca de Anúncios da Meta pode ser pesquisada pelo search_meta_ads, por palavra-chave ou por página, e cobre os posicionamentos do Facebook e do Instagram juntos.
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