Publique, agende e rode anúncios a partir do Codex

O que é o Codex?

O Codex é o agente de programação da OpenAI, usado pelo terminal, pela extensão de IDE ou pelo app desktop do ChatGPT. Ele roda tanto com interação quanto sem, o que faz dele o cliente que as pessoas usam quando um trabalho de marketing deve acontecer em um agendamento, e não em uma conversa.

Codex ou ChatGPT? O Codex é o agente de programação da OpenAI, e ele aceita a Hermoso como plugin ou servidor MCP. O app de chat ChatGPT adiciona a Hermoso pelo diretório de apps dele.

Hermoso é marketing no piloto automático: 922+ ferramentas em um único endpoint MCP, cobrindo pesquisa de anúncios de concorrentes, anúncios finalizados em imagem e vídeo com mais de 100 modelos, publicação e agendamento em onze canais sociais, e gestão de campanhas no Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads. Uma conexão, e o Codex tem tudo isso.

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.

Todos os canais em que o Codex pode publicar

Cada um deles tem a própria página, com o limite real de legenda do canal, as opções de visibilidade reais, o que ele recusa e por quê, e um exemplo trabalhado escrito para o Codex.

Todos eles passam por uma única agenda schedule_post, com legendas por canal, e o list_scheduled informa os resultados por canal, em vez de um único visto verde, porque “a tarefa deu certo” e “a publicação saiu” são perguntas diferentes. Uma publicação agendada fica no Hermoso, então sai no horário certo, esteja o Codex rodando ou não.

Google Business Profile é o canal mais novo: Publicações com foto e botão na sua ficha do Google Search e do Maps, respostas às suas avaliações, edições da ficha e as ligações, cliques no site e pedidos de rota que a ficha gera. O Codex acessa por meio das mesmas ferramentas, e o schedule_post o coloca na mesma agenda.

Um canal que está construído, mas não oferecido

Ser direto sobre isso vale mais do que uma lista maior. Existe uma superfície de publicação no código que está retida, esperando a plataforma e não a gente:

• Reddit: a publicação orgânica e as estatísticas de posts estão construídas, mas a Responsible Builder Policy do Reddit exige aprovação formal por escrito antes que um app use a Data API, e essa autorização ainda não foi concedida. O conector está retido, em vez de ser oferecido como uma tela de OAuth que leva a uma API inativa. O Reddit Ads é outra conexão, e ela está ativa: a árvore completa de campanhas, previsão, busca de segmentação, pixels e formulários de lead.

Um conector que entregaria um OAuth bem-sucedido e uma API inativa é pior do que um que ainda não é oferecido, então ele não aparece como disponível.

Três coisas para digitar uma vez conectado

1. Pesquisa. “Quem são meus três concorrentes mais próximos, e quais são os anúncios da Meta que rodam há mais tempo? Me diga qual gancho continua se repetindo.” Ele roda find_competitors → pull_competitor_ads → mine_angles.
2. Criar. “Faça para mim um anúncio UGC 9:16 usando esse gancho, com a foto real do meu produto e as legendas queimadas no vídeo.” Ele roda get_brand → plan_ad → render_ad, e entrega uma URL de mp4 pronta.
3. Publicar. “Agende para o Instagram e o TikTok na terça às 9h, e crie uma campanha pausada no Meta em torno disso, segmentando os EUA com $30 por dia.” Ele roda schedule_post → create_meta_campaign → create_meta_ad.

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 fica deliberadamente com você: conectar cada conta, uma vez. A maioria dos canais se conecta pela tela de consentimento OAuth da própria plataforma, em um navegador; o Bluesky usa uma senha de app e o Telegram um token de bot, colados no Hermoso. Tudo depois disso é uma chamada de ferramenta.

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.

Quanto custa

Adicionar o Hermoso ao Codex não custa nada a mais: há um único medidor de créditos, e ele não se importa com qual cliente fez a chamada. Uma conta gratuita começa com 30 créditos no cadastro e mais 250+ para ganhar. Os créditos são gastos apenas em modelos de IA e na pesquisa do Ad Spy; publicar, agendar, gerenciar anúncios e analytics são grátis em todos os canais, exceto no X, que cobra por chamada porque o X cobra por requisição de API. Os planos pagos 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. O hermoso_capabilities informa o preço exato em créditos de qualquer render antes de ele rodar.

Solução de problemas

• Um servidor local imprime a ajuda e encerra. Faltam os argumentos, o mcp final. npx -y hermoso sozinho imprime a ajuda; npx -y hermoso mcp inicia o servidor.
• Não há navegador nessa máquina. Crie uma chave em MCP & CLI → Terminal & API keys e rode npx -y hermoso auth login --token hmk_… no lugar.
• Um canal está faltando. Conecte-o no Hermoso em Configurações → Conectores e depois peça ao Codex para rodar o list_connectors de novo.
• O Codex responde sem usar o Hermoso. Cite-o no pedido: “use o Hermoso para …”. Isso deixa claro quais ferramentas devem fazer o trabalho.

Além da publicação

Publicar é a última etapa, e a menor delas. A mesma conexão dá ao Codex as bibliotecas de anúncios da Meta, do Google e do LinkedIn, além de TikTok, Instagram, YouTube, Reddit e Threads orgânicos para pesquisa; mais de 100 modelos de imagem, vídeo, voz e escrita em um único medidor de créditos, com avatares UGC, dublagem, aumento de resolução e formatos de anúncio HTML nativos; e a árvore completa de campanhas em doze plataformas pagas. Não há chaves de API de fornecedores para guardar e nenhum app separado para aprender.

Veja a lista completa de ferramentas, todos os agentes em que a Hermoso funciona, ou o que é um MCP de marketing. Para a história mais longa sobre este cliente em específico, veja Anúncios pela linha de comando.

O Hermoso em outros agentes

A mesma conta do Hermoso funciona em todos os agentes abaixo, então a sua marca, biblioteca, agenda e créditos acompanham você entre eles.

Perguntas frequentes

O Codex consegue publicar nas redes sociais?

Sim, depois de instalar a Hermoso. O Codex então pode publicar no Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram e Google Business Profile, e agendar para os onze a partir de uma única fila, com legendas específicas por canal.

Como adiciono o Hermoso ao Codex?

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

O Codex consegue pesquisar os anúncios dos meus concorrentes?

Sim. Pelo Codex, as bibliotecas de anúncios da Meta, do Google e do LinkedIn podem ser pesquisadas junto com o TikTok, Instagram, YouTube, Reddit e Threads orgânicos, ordenados pelo tempo de veiculação, porque um anúncio que segue no ar depois de meses é um anúncio que se paga. Ele também desmonta a estratégia de um concorrente e devolve a locução de um vídeo, o texto na tela e a lista de batidas com timestamps.

Preciso de uma conta separada para usar a Hermoso no Codex?

Não. Uma conta Hermoso basta, e o Codex se autentica nela. A etapa de login guarda a credencial sozinha, então não há nada para colar. O estúdio web em app.hermoso.ai é o mesmo motor e os mesmos créditos.

É seguro deixar o Codex publicar e rodar anúncios para mim?

A Hermoso mantém atrás de travas no próprio servidor as etapas que custam dinheiro ou não podem ser desfeitas, independentemente do que o Codex estiver configurado para fazer: toda campanha é criada pausada, a troca de gasto e as exclusões exigem confirmação explícita, e um post só chega a uma conta que você conectou e marcou na Hermoso. 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 compartilha a configuração da Hermoso entre a CLI e o app desktop?

Sim, para servidores MCP. A OpenAI documenta um único arquivo de configuração, ~/.codex/config.toml, compartilhado pela CLI do Codex, pela extensão de IDE e pelo Codex no app desktop do ChatGPT, então um servidor adicionado com codex mcp add aparece nos três.