Publicar no X a partir do Cline

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

Conectar o Hermoso ao Cline

1. Crie uma chave de API. Na Hermoso, abra a aba MCP & CLI e, em Terminal & API keys, clique em ＋ Criar chave de API. Ela tem a forma hmk_… e tem autoridade real de gasto, então trate-a como uma senha.
2. Adicione um servidor MCP nas configurações de MCP do Cline, apontando para o endpoint hospedado com a sua chave:

   { "url": "https://app.hermoso.ai/mcp",
     "headers": { "Authorization": "Bearer <your key>" } }

3. Peça algo ao Cline. “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.

Esse é o bloco HTTP MCP genérico da Hermoso, não uma integração específica para o Cline, e vale dizer isso com clareza. O que é específico do Cline do nosso lado é o servidor de autorização: ele aceita URIs de redirecionamento de loopback (http://127.0.0.1:PORT/…) justamente para que agentes instalados localmente, como o Cline, consigam completar o aperto de mão de registro.

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

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

“Rascunhe um post no X com menos de 280 caracteres sobre esta correção, me passe o preço e espere a minha aprovação antes de postar.”

Isso percorre get_brand → generate_text → post_to_x → x_post_insights_historical. Por padrão, o Cline pede confirmação antes de cada chamada de ferramenta, que é o comportamento que você quer em qualquer coisa que publique.

O Cline no X: a parte que pesa

Não tire o X da aprovação automática só por causa do custo. Cada post, resposta, exclusão e leitura é uma requisição cobrada; os insights cobram por post retornado; e um link multiplica o preço de um post por cerca de 13. A Hermoso informa o custo antes, o que só ajuda se houver alguém para ler.

Se você usa o Cline com aprovação automática, exclua as ferramentas de publicação e de campanha, já que são as que têm consequência pública ou financeira.

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

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

Perguntas frequentes

O Cline consegue publicar no X?

Sim, pelo servidor MCP da Hermoso. Crie uma chave de API na Hermoso, na aba MCP & CLI, em Terminal & API keys, e depois adicione https://app.hermoso.ai/mcp ao Cline com um cabeçalho Authorization: Bearer. O Cline passa a ter 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 Cline?

Duas etapas, uma vez cada. Crie uma chave de API na Hermoso, na aba MCP & CLI, em Terminal & API keys, e depois adicione https://app.hermoso.ai/mcp ao Cline com um cabeçalho Authorization: Bearer. Depois conecte o X dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Depois disso o Cline publica no X como uma chamada de ferramenta comum.

O Cline 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 Cline 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 Cline?

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 Cline é avisado na hora, em vez de falhar depois, quando ninguém está acompanhando.

O Cline 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.