Publicar no X a partir do Gemini CLI

A Hermoso é um servidor MCP de marketing: 922+ ferramentas sobre um único endpoint com OAuth, que permitem a um agente pesquisar os anúncios que já estão rodando em um mercado, gerar anúncios finalizados de imagem e vídeo, publicá-los e criar as campanhas pagas por trás deles. O Gemini CLI acessa tudo isso por uma única conexão. Esta página trata de uma fatia disso: o que o Gemini CLI consegue fazer de fato no X, e o que o X não permite.

Conectar o Hermoso ao Gemini CLI

1. Instale a extensão.

   gemini extensions install https://github.com/hermoso-ai/hermoso

   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 contexto GEMINI.md. As skills executam o comando hermoso pelo npx, então nada é adicionado à lista de ferramentas do Gemini CLI, e nada custa contexto até que um comando rode. gemini extensions list mostra-as em Agent skills.
2. Faça login uma vez.

   npx -y hermoso auth login

   Ele abre um login pelo navegador e guarda uma credencial de acesso restrito ao dono em ~/.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 execute npx -y hermoso auth login --token hmk_….
3. Opcional: também o servidor MCP.

   gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/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 em settings.json; /mcp auth hermoso dentro de uma sessão executa o login. As skills alcançam todas as ferramentas sem isso.
4. 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 X, uma vez, em Configurações → Conectores na Hermoso. É uma tela de consentimento OAuth, por isso é o único passo que precisa de navegador. Tudo depois disso é uma chamada de ferramenta.

As ferramentas do X que o Gemini CLI recebe

• post_to_x: publica texto, imagem ou vídeo com texto alternativo, uma thread inteira, uma resposta, uma publicação com citação ou uma enquete, e pode restringir quem tem permissão para responder.
• post_x_article: publica um Article de formato longo. Escreva em Markdown, e os títulos, listas, citações, links, blocos de código e tabelas são mantidos.
• edit_x_post: reescreve uma publicação que você já fez, dentro da hora que o X permite.
• schedule_post: coloca a publicação na fila do calendário compartilhado.
• x_post_metrics: as contagens públicas de uma publicação.
• x_post_insights: números de nível de anunciante apenas das últimas 28 horas: impressões, cliques em links, visitas ao perfil, visualizações de vídeo e quartis de conclusão.
• x_post_insights_historical: os mesmos números em qualquer intervalo de datas, até 25 publicações por vez. Esta é a ferramenta para “como foi o mês passado”.
• x_mentions: quem está falando sobre a marca.
• delete_x_post: remove uma publicação.

O X é o único conector que custa dinheiro por chamada, e os números são publicados, não escondidos. Meta, TikTok, LinkedIn, YouTube, Threads e Drive não cobram nada por requisição; o X cobra da gente, então essas chamadas consomem uma pequena quantidade de créditos cada. Uma publicação simples sai a $0.015 por requisição, e uma publicação com link a $0.200, cerca de 13× mais. Exclusões, leituras e a gravação de texto alternativo têm preço próprio, e os insights são cobrados por publicação retornada. A detecção de link erra de propósito para o lado de presumir que há link, porque errar para o outro lado nos custa 13×. Na prática: no X, uma boa publicação vale mais que cinco, e o seu agente recebe o preço antes de publicar. O tamanho é o da conta que publica, não um fixo de 280. A Hermoso lê a assinatura do X da própria conta e envia até 25.000 caracteres onde o Premium permite, então uma publicação longa sai inteira, em vez de voltar recusada, e nada é cortado. Isso também é a forma barata: uma publicação longa é uma única chamada cobrada no X, enquanto as mesmas palavras divididas em cinco publicações são cinco chamadas. O X Premium também libera duas coisas que a Hermoso publica por você: um Article de formato longo, escrito em Markdown com títulos, listas, citações, blocos de código e tabelas intactos, e uma edição de uma publicação já feita, dentro da hora que o X permite.

Limites do X que vale conhecer antes de automatizar qualquer coisa

Experimente no Gemini CLI

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

“Transforme ./notes/launch.md em um post no X, ou em um thread curto se não couber, com o link só no último post, e me diga o custo antes.”

Isso percorre get_brand → generate_text → post_to_x → x_post_insights_historical. 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.

O Gemini CLI no X: a parte que pesa

Se você adicionar o servidor MCP do Hermoso ao Gemini CLI, nunca o adicione com --trust quando ele for publicar no X. Essa flag pula todas as confirmações do servidor, e no X cada post, leitura e exclusão é uma chamada cobrada, com um post que carrega link custando cerca de 13 vezes um post simples. Em uma conta Premium, um post longo é uma chamada cobrada, enquanto um thread de cinco partes são cinco.

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

Não existe biblioteca de anúncios do X para pesquisar. A pesquisa do X aqui é a da sua própria conta: menções, métricas de publicações e os números históricos de anunciante. O restante da área de pesquisa segue igual: as bibliotecas de anúncios da Meta, do Google e do LinkedIn, e o TikTok, Instagram, YouTube, Reddit e Threads orgânicos.

A metade paga

O X Ads chegou em agosto de 2026, então o X agora cobre as duas frentes. A API do X Ads é um produto separado, em outro host, com assinatura OAuth 1.0a própria, por isso chegou depois do resto. A Hermoso agora monta a árvore inteira de publicações promovidas nela: campanha, line item (o nome que o X dá a grupo de anúncios), tweet promovido, segmentação, orçamentos, status e relatórios. Um anúncio do X promove uma publicação, então o criativo é uma publicação, a mesma que a Hermoso publica organicamente. A chave que ativa dinheiro real se recusa a rodar sem confirmação explícita, exatamente como nas outras onze plataformas. Uma coisa a saber antes de planejar um orçamento: o X concede acesso à API de Anúncios por conta de anúncios, e não por aplicativo, então não existe botão OAuth para isso. Você adiciona o usuário X da Hermoso à sua conta de anúncios em business.x.com → Account access, e ele aparece em list_x_ads_accounts com o nível de permissão que o X lhe concedeu.

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 · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo o que o Gemini CLI pode publicar.

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

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 X, e também as que pesquisam os anúncios que já rodam no seu mercado e renderizam o criativo do zero.

Como conecto o X 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 X dentro do Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. A partir daí, o Gemini CLI publica no X como uma chamada de ferramenta comum.

O Gemini CLI consegue publicar no X em privado ou como rascunho?

Não. Uma publicação no X é pública no momento em que existe; a API não tem rascunho nem publicação não listada. A Hermoso recusa uma visibilidade que o X não consegue cumprir no momento em que você pede, em vez de publicar discretamente algo mais fraco.

O Gemini CLI consegue pesquisar o X antes de publicar?

Não pela biblioteca de anúncios, porque o X não publica nenhuma. O que a Hermoso lê no X é a sua própria conta: métricas de publicações, insights de nível de anunciante em qualquer intervalo de datas e menções à marca.

Qual é o limite de legenda do X ao publicar pelo Gemini CLI?

Depende da conta, e a Hermoso confere em vez de adivinhar. Uma conta comum do X tem limite de 280 caracteres; com o X Premium, vai até 25.000. A Hermoso lê a assinatura no X e envia a publicação, então uma publicação longa sai inteira, e nada é cortado. Em uma conta Premium, uma publicação longa geralmente lê melhor do que uma thread e custa menos, porque é uma única chamada cobrada no X, enquanto cinco partes são cinco. O Premium também libera Articles de formato longo, escritos em Markdown, e a edição de uma publicação já feita dentro da hora que o X permite. 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 rodar anúncios no X, além de publicar?

Sim, desde agosto de 2026. O X Ads roda em outro host, com assinatura OAuth 1.0a própria, e a Hermoso monta a árvore inteira nele: campanha, line item, tweet promovido, segmentação, orçamentos, status e relatórios. O X concede acesso à API de Anúncios por conta de anúncios, e não por aplicativo, então não existe botão OAuth para isso: você adiciona o usuário X da Hermoso à sua conta de anúncios em business.x.com → Account access.