Hermoso é um servidor MCP de marketing: 922+ ferramentas em um endpoint único com OAuth, que permitem a um agente pesquisar os anúncios que já rodam em um mercado, gerar anúncios finalizados em imagem e vídeo, publicá-los e montar as campanhas pagas por trás deles. O Codex acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Codex consegue fazer de fato no Threads, e o que o Threads não deixa que ele faça.
Conectar o Hermoso ao Codex
- Um comando, e nenhuma chave.
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 comandocodex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermosohermosopelonpx, então nenhuma lista de ferramentas é carregada nas suas sessões e nada custa contexto até um comando rodar. - Entre uma vez.
Ele abre uma entrada pelo navegador e guarda uma credencial, só com acesso do dono, emnpx -y hermoso auth login~/.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 rodenpx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real de gasto, então trate-a como uma senha. - Opcional: o servidor MCP também.
Isso grava o servidor emcodex mcp add hermoso -- npx -y hermoso mcp~/.codex/config.tomle 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/mcpe depoiscodex mcp login hermosopara o login OAuth. As skills alcançam todas as ferramentas sem nenhum dos dois. - 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 Threads, uma vez, em Configurações → Conectores no Hermoso. Isso é uma tela de consentimento OAuth, então é a única etapa que precisa de navegador. Tudo depois disso é uma chamada de ferramenta.
As ferramentas do Threads que o Codex recebe
post_to_meta: publica texto, uma imagem ou um vídeo comtarget: "threads", opcionalmente com geolocalização.schedule_post: coloca na fila junto com todos os outros canais.list_threads_posts / threads_insights: o que você publicou e como cada post foi.list_threads_replies / reply_to_thread / hide_thread_reply: lê as respostas, responde como a marca e oculta o que não deveria estar lá.list_threads_mentions: quem está falando de você.search_threads_keyword / search_threads_locations: busca por palavra-chave e os ids de localização que uma geolocalização precisa.delete_thread: remove um post.
O Threads é o canal em que o Hermoso vai mais longe além da publicação. Além de postar, há uma superfície completa de ler e responder (respostas, menções, busca por palavra-chave e métricas por post), o que o torna útil como canal de escuta além de canal de saída. Observe que o Threads é uma concessão OAuth separada do Facebook, mesmo compartilhando a Página.
Limites do Threads que vale conhecer antes de automatizar qualquer coisa
| Texto | Um post no Threads tem limite de 500 caracteres, o mais apertado daqui exceto o X. O limite é aplicado quando o post é criado ou colocado na fila, então um post longo demais é recusado enquanto você ainda está ali para corrigir, em vez de ser cortado em silêncio na saída. |
|---|---|
| Visibilidade | Somente público. “O Threads não tem post não listado, privado ou rascunho.” Um post no Threads existe publicamente ou não existe. |
| Carrossel | 2 a 20 slides, com imagens e vídeos misturados. Os dois limites são palavras da própria Meta, citadas na tabela que os aplica: “Carrosséis precisam ter pelo menos 2” itens, e “no máximo 20 imagens, vídeos ou uma mistura dos dois, no total.” Isso faz do Threads o carrossel de mídia mista mais generoso de todos os canais daqui. |
| Qual conta | pageId. A mesma identidade de Página conectada carrega o Facebook, o Instagram e o Threads. |
Experimente no Codex
Peça em linguagem comum. São frases simples, não uma DSL:
“Todo dia útil às 9h: leia as novas entradas do changelog, escreva um post no Threads com menos de 500 caracteres, publique e registre o id.”
Isso percorre get_brand → generate_text → post_to_meta (target: "threads") → list_threads_replies. 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.
Codex no Threads: a parte que pega
Aplique o limite de 500 caracteres no prompt também, e não dependa só da checagem na entrada da fila. Uma execução sem supervisão que falha na validação é um job que não publicou, e em uma cadência diária isso vira uma lacuna silenciosa. A parte de escuta funciona do mesmo jeito: list_threads_mentions devolve resultados estruturados que uma execução no formato de cron pode usar.
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 Threads antes de publicar
search_threads busca Threads públicos por palavra-chave pela superfície de pesquisa, e o search_threads_keyword faz o mesmo pela sua conta conectada do Threads. Não existe biblioteca de anúncios do Threads, porque não há anúncios do Threads para arquivar.
A metade paga
Não existe produto de anúncios do Threads no Hermoso, e seria errado sugerir um. Aqui o Threads é um canal orgânico: publicar, ler, responder, medir. As ferramentas pagas cobrem Meta (Facebook e Instagram), Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads.
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 · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo o que o Codex consegue publicar.
Publique no Threads 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 Threads?
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 Threads e as que pesquisam os anúncios que já estão rodando no seu mercado e criam o criativo do zero.
Como conecto o Threads 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 Threads dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Depois disso o Codex publica no Threads como uma chamada de ferramenta comum.
O Codex consegue publicar no Threads de forma privada ou como rascunho?
Não. O Threads não tem post não listado, privado ou rascunho; um post no Threads é público ou não existe. O Hermoso recusa uma visibilidade que o Threads não consegue cumprir no momento em que você pede, em vez de publicar discretamente algo mais fraco.
O Codex consegue agendar um post no Threads para depois?
Sim. O schedule_post coloca o post na fila de uma agenda única compartilhada com todos os outros canais, com uma legenda por canal se o texto precisar ser diferente, e o list_scheduled e o cancel_scheduled leem e retiram o post. O Threads é um dos onze canais que entram na fila.
Qual é o limite de legenda do Threads ao publicar a partir do Codex?
Um post no Threads tem limite de 500 caracteres, o mais apertado de qualquer canal aqui, exceto o X. O Hermoso aplica o limite quando o post é criado ou colocado na fila, então o Codex é avisado na hora, em vez de falhar depois, quando ninguém está acompanhando.
Quanto custa publicar no Threads a partir do Codex?
Publicar no Threads não custa créditos; a Meta não cobra nada por chamada de API. Os créditos são gastos na geração do criativo. Os planos custam $29, $69 e $149 por mês, por 1.200, 3.000 e 7.000 créditos, e todos os recursos estão em todos os planos, inclusive o Free. A única exceção é o SSO empresarial.
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