Publicar no X a partir do Codex

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

Conectar o Hermoso ao Codex

1. Um comando, e nenhuma chave.

   codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso

   O Codex lê o arquivo de marketplace no repositório público da Hermoso e instala as cinco skills dele (research, ad-from-brand, generate, product-photoshoot e marketing). As skills rodam o comando hermoso pelo npx, então nenhuma lista de ferramentas é carregada nas suas sessões e nada custa contexto até um comando rodar.
2. Entre uma vez.

   npx -y hermoso auth login

   Ele abre uma entrada pelo navegador e guarda uma credencial, só com acesso do dono, em ~/.hermoso/config.json. Sem navegador nessa máquina, por exemplo em CI ou em um contêiner? Crie uma chave em MCP & CLI → Terminal e chaves de API e rode npx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real de gasto, então trate-a como uma senha.
3. Opcional: o servidor MCP também.

   codex mcp add hermoso -- npx -y hermoso mcp

   Isso grava o servidor em ~/.codex/config.toml e lê a mesma credencial guardada, então nenhuma chave vai no arquivo. Prefere o endpoint hospedado? codex mcp add hermoso --url https://app.hermoso.ai/mcp e depois codex mcp login hermoso para o login OAuth. As skills alcançam todas as ferramentas sem nenhum dos dois.
4. Peça algo ao Codex. “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 Codex guarda os servidores MCP em ~/.codex/config.toml, ou em .codex/config.toml de um projeto confiável, e esse arquivo é TOML, não JSON: um bloco mcpServers copiado não carrega, e uma entrada escrita à mão é [mcp_servers.hermoso] com command = "npx" e args = ["-y", "hermoso", "mcp"]. O mcp final é essencial: npx -y hermoso sem subcomando só mostra a ajuda e sai. O Codex lê marketplaces de plugin no mesmo layout .claude-plugin que o Claude Code usa, por isso um único repositório instala nos dois.

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

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

“Sem interação: publique uma atualização no X por lançamento, com menos de 280 caracteres e o link nesse único post, e registre o custo cobrado.”

Isso percorre get_brand → generate_text → post_to_x → x_post_insights_historical. No modo interativo, o Codex mostra a chamada antes de rodá-la. No modo não interativo não há ninguém para perguntar, o que vale a pena considerar em qualquer etapa que publique ou gaste.

O Codex no X: a parte que pesa

Oriente este com orçamento de propósito. Cada post, exclusão e leitura é uma requisição cobrada, os insights cobram por post retornado, e um post com link custa cerca de 13× um simples. Para um job sem supervisão isso significa: um post por evento em vez de uma thread, um link em vez de vários e um limite de quantas vezes o job pode rodar. O limite de caracteres é uma recusa limpa, então um job que falha falha de forma clara, em vez de postar algo pela metade.

Em execuções sem supervisão, prefira a CLI hermoso com --json ao manifesto completo de ferramentas. Ela custa bem menos contexto e é mais fácil de 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 Codex 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 Codex, publique em: Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo o que o Codex consegue publicar.

Publique no X a partir de: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Anúncios pela linha de comando

Perguntas frequentes

O Codex consegue publicar no X?

Sim, com o plugin do Codex da Hermoso. Rode codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala as skills da Hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Para o servidor MCP também, rode codex mcp add hermoso -- npx -y hermoso mcp. O Codex 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 Codex?

Duas etapas, uma vez cada. Rode codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala as skills da Hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Para o servidor MCP também, rode codex mcp add hermoso -- npx -y hermoso mcp. Depois conecte o X dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Depois disso o Codex publica no X como uma chamada de ferramenta comum.

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

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