Publicar no X a partir do Cursor

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

Conectar o Hermoso ao Cursor

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 ~/.cursor/mcp.json (ou no .cursor/mcp.json do projeto). Nenhuma chave vai no arquivo, porque hermoso mcp lê o login feito acima:

   { "mcpServers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"] } } }

3. Ou use a instalação com um clique pela página do MCP. Esse deeplink instala a URL hospedada e deixa a autenticação com o fluxo OAuth do próprio Cursor. Os dois funcionam, são só pré-requisitos diferentes.
4. Peça algo ao Cursor. “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 bloco acima roda o pacote npm hermoso publicado na sua máquina, e é por isso que nada é colado e por que a lista de ferramentas não custa nada até uma ferramenta ser chamada. Se você usar o deeplink, o Cursor faz o registro dinâmico de cliente no nosso servidor de autorização, e você também nunca precisa guardar uma chave.

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

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

“Monte uma thread no X a partir das notas de lançamento desta branch, mantenha cada post abaixo de 280 caracteres, coloque o link só no último post e me passe o preço antes.”

Isso percorre get_brand → generate_text → post_to_x → x_post_insights_historical. O Cursor mostra cada chamada de ferramenta no compositor antes de rodá-la, então publicar é um clique, e não um efeito colateral.

O Cursor no X: a parte que pesa

A recusa por tamanho é um recurso em um editor: a Hermoso verifica o que a sua conta tem direito (280 caracteres normalmente, até 25,000 com o X Premium) e devolve um erro limpo que nomeia o excedente, em vez de um post cortado, então a correção é uma edição de texto e uma nova tentativa. Mantenha o link em um post só. Um post com link custa cerca de 13× mais do que um simples, e uma thread de cinco posts com cinco links custa o que parece.

Coloque a configuração no .cursor/mcp.json do projeto, e não no diretório pessoal, quando um repositório deve sempre rodar com uma só marca; caso contrário, é o hermoso auth login que fixa o workspace.

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

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

Perguntas frequentes

O Cursor consegue publicar no X?

Sim, pelo servidor MCP da Hermoso. Rode npm install -g hermoso && hermoso auth login e depois aponte ~/.cursor/mcp.json para npx -y hermoso mcp. O login no navegador guarda a credencial, então nenhuma chave vai no arquivo. O Cursor 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 Cursor?

Duas etapas, uma vez cada. Rode npm install -g hermoso && hermoso auth login e depois aponte ~/.cursor/mcp.json para npx -y hermoso mcp. O login no navegador guarda a credencial, então nenhuma chave vai no arquivo. Depois conecte o X dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Depois disso o Cursor publica no X como uma chamada de ferramenta comum.

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

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

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

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