Publicar no X a partir do Claude Code

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

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 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 Claude Code 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 Claude Code

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

“Transforme ./notes/launch.md em uma thread no X de no máximo cinco posts, deixe o link só no último e me diga o custo antes de publicar.”

Isso percorre get_brand → generate_text → post_to_x → x_post_insights_historical. O Claude Code pede confirmação antes de rodar uma ferramenta, e a transcrição fica ali no terminal, então cada etapa de publicação é uma linha que você lê antes de apertar y.

O Claude Code no X: a parte que pesa

Coloque o link em um post, não em cinco. Um post com link custa cerca de 13× mais do que um simples, então uma thread em que todo post tem link é o formato caro, e a detecção de link erra de propósito para o lado de presumir que há um link. Texto acima do limite é recusado em vez de cortado, e o excedente é contado. Em um script, isso significa uma falha limpa que você pode tratar, em vez de um post enviado pela metade.

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

Pelo Claude Code, publique em: Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo o que o Claude Code consegue publicar.

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

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 sozinho, então não há chave para criar nem para colar. Depois disso o Claude Code tem mais de 922+ ferramentas, incluindo as que publicam no X e as que pesquisam os anúncios que já estão rodando no seu mercado e criam o criativo do zero.

Como conecto o X 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 sozinho, então não há chave para criar nem para colar. Depois conecte o X dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Depois disso o Claude Code publica no X como uma chamada de ferramenta comum.

O Claude Code 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 Claude Code 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 Claude Code 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.

O Claude Code 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 Claude Code 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 Claude Code?

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.