Publicar no X a partir do Hermes

O X cobra por requisição de API, então uma execução automatizada precisa de uma regra sobre frequência e links antes de precisar de qualquer outra coisa.

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 Hermes acessa tudo isso por uma única conexão. Esta página trata de uma fatia disso: o que o Hermes consegue fazer de fato no X, e o que o X não permite.

Conectar o Hermoso ao Hermes

  1. Instale e entre.
    npm install -g hermoso && hermoso auth login
    O seu navegador abre uma vez. Não há nada para criar nem para colar: a credencial fica guardada, só com acesso do dono, em ~/.hermoso/config.json. Em uma máquina sem navegador, hermoso auth login --token hmk_… usa uma chave de MCP & CLI → Terminal e chaves de API.
  2. Adicione em ~/.hermes/config.yaml. mcp_servers é uma chave de nível superior, não aninhada em mcp, e nenhuma chave vai no arquivo porque hermoso mcp usa o login acima:
    mcp_servers:
      hermoso:
        command: "npx"
        args: ["-y", "hermoso", "mcp"]
  3. Peça algo ao Hermes. “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 Hermoso não é afiliado nem endossado pelos criadores do Hermes e não afirma ser. O formato acima é citado da referência MCP do próprio projeto, em NousResearch/hermes-agent, lida em 2026-08-23. Ele está documentado, não executado aqui, e por isso é o formato de arquivo publicado, e não um comando de instalação personalizado.

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

TextoO tamanho é o da conta que publica: 280 caracteres normalmente, até 25.000 com o X Premium. A Hermoso lê a assinatura no X, então uma publicação longa sai inteira. Nada é cortado. A verificação acontece quando a publicação é criada ou colocada na fila, então uma publicação acima do limite é recusada enquanto você ainda está ali para corrigir, em vez de ser cortada silenciosamente no caminho.
VisibilidadeSó público. Uma publicação no X é pública no momento em que existe. A API não tem rascunho nem publicação não listada. Existem contas protegidas, mas isso é uma configuração da conta inteira que a Hermoso não lê nem controla, e não uma escolha por publicação.
CarrosselRecusado, com nome e motivo específico. “O X não tem carrossel deslizável.” A API dele anexa até 4 mídias a uma publicação, e elas aparecem como uma grade, com todas as imagens visíveis ao mesmo tempo e nada para deslizar; por isso um deck de slides com “1/6 · DESLIZE” não pode ser publicado ali como foi pensado. A recusa diz o que fazer: “Publique o slide mais forte no X, ou tire o X desta publicação.” Um deck que manda o leitor deslizar, publicado como grade, é pior do que não publicar.
Qual contaNenhum. O X publica na conta conectada.

Experimente no Hermes

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

“Publique uma atualização no X por release, com menos de 280 caracteres e o link só nesse post, e registre o custo cobrado.”

Isso percorre get_brand → generate_text → post_to_x → x_post_insights_historical. O comportamento de aprovação é você quem configura. As garantias do próprio Hermoso não dependem disso: campanhas nascem pausadas, trocas de gasto exigem confirmação e nenhuma chamada de geração roda sem uma conta verificada por trás.

O Hermes no X: a parte que pesa

Aqui, um post vale mais que cinco, literalmente. Cada post, exclusão e leitura é cobrado, os insights são cobrados por post retornado, e um post com link custa cerca de 13× o preço de um post simples. Por isso, uma conta automatizada que posta sem parar é o formato caro. O limite de caracteres falha de forma limpa, em vez de cortar o texto, que é o que você quer em uma tarefa que ninguém está acompanhando.

Para execuções sem supervisão, a CLI hermoso com --json é mais fácil de verificar do que um manifesto de ferramentas, e custa bem menos contexto.

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 Hermes 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 Hermes, publique em: Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo o que o Hermes pode publicar.

Publique no X a partir de: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip

Perguntas frequentes

O Hermes consegue publicar no X?

Sim, pelo servidor MCP do Hermoso. Execute npm install -g hermoso && hermoso auth login, depois adicione o hermoso na chave de nível superior mcp_servers em ~/.hermes/config.yaml, com o comando "npx" e os argumentos ["-y", "hermoso", "mcp"]. O login pelo navegador guarda a credencial, então nenhuma chave vai no arquivo. O Hermes 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 Hermes?

Duas etapas, uma vez cada. Execute npm install -g hermoso && hermoso auth login, depois adicione o hermoso na chave de nível superior mcp_servers em ~/.hermes/config.yaml, com o comando "npx" e os argumentos ["-y", "hermoso", "mcp"]. O login pelo navegador guarda a credencial, então nenhuma chave vai no arquivo. Depois conecte o X dentro do Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. A partir daí, o Hermes publica no X como uma chamada de ferramenta comum.

O Hermes consegue publicar um carrossel no X?

Não. A API do X anexa até quatro mídias a uma publicação, e elas aparecem como uma grade, com todas as imagens visíveis ao mesmo tempo e nada para deslizar; por isso um deck de slides numerados não pode ser publicado ali como foi pensado. O Hermes chama a mesma ferramenta de publicação de qualquer forma, e um canal que não comporta carrossel é recusado com o motivo real indicado.

Quanto custa publicar no X a partir do Hermes?

O X é o único conector que cobra créditos por chamada, porque o X cobra por requisição à API: cerca de $0.015 por publicação e $0.200 por publicação com link, cerca de 13 vezes mais. O seu agente recebe o preço antes de publicar. 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 Hermes precisa da minha senha do X?

Não. Você conecta o X à Hermoso uma vez, por uma tela de consentimento OAuth no navegador, e depois o Hermes acessa o X como chamada de ferramenta. Vincular a conta é o único passo que não é feito sem interface; depois dele, nada precisa de senha, e nenhuma credencial é entregue ao modelo.

O Hermes consegue agendar uma publicação no X para depois?

Sim. schedule_post coloca a publicação na fila de um calendário compartilhado com todos os outros canais, com legenda específica por canal se o texto precisar ser diferente, e list_scheduled e cancel_scheduled consultam e removem essa publicação. O X é um dos onze canais que entram nessa fila.

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