Publicar no Instagram a partir do Codex

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 Instagram, e o que o Instagram não deixa que ele faça.

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 Instagram, 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 Instagram que o Codex recebe

• post_to_meta: publica no Instagram com target: "instagram". O Instagram é um canal visual, e a API concorda: um post precisa de uma imagem ou de um vídeo.
• schedule_post: coloca na fila da agenda compartilhada, com uma legenda por canal se o texto precisar ser diferente da sua versão para o Facebook ou o LinkedIn.
• list_meta_comments / reply_to_meta_comment / moderate_meta_comment: lê, responde e modera os comentários de um post.
• meta_page_insights / meta_post_insights: alcance, impressões, salvamentos e engajamento, por conta e por post.
• search_instagram: busca por palavra-chave em Reels públicos do Instagram, para pesquisa e não para publicação.

Dois fatos sobre o Instagram que vale conhecer antes de automatizar qualquer coisa. Não existe agendamento nativo do Instagram na API da Meta, então um agendamento é a fila do Hermoso, e não a do Instagram; e passar o scheduleAt do Facebook para o Instagram é recusado, em vez de publicar em silêncio agora. E uma legenda do Instagram não pode ser editada depois que o post está no ar: a única coisa que a Meta permite mudar em um post publicado é se os comentários estão ativados. Excluir é possível: o manage_meta_post remove posts comuns, Stories, Reels e álbuns de carrossel inteiros, mas nunca um único cartão de dentro de um álbum.

Limites do Instagram 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: monte um carrossel de 4 slides com as fotos de produto de hoje, publique no Instagram com uma legenda de menos de 2,200 caracteres e encerre com o permalink.”

Isso percorre search_instagram → plan_ad → render_ad → post_to_meta (target: "instagram"). 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 Instagram: a parte que pega

O Instagram exige uma etapa humana em um pipeline sem supervisão: uma legenda publicada nunca pode ser editada pela API. Se o Codex roda em um timer, coloque a revisão antes da publicação: gere e segure, depois publique com aprovação. Apagar é o único desfazer. A manage_meta_post remove posts comuns, Stories, Reels e álbuns de carrossel inteiros, mas uma exclusão leva junto as curtidas e os comentários.

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 Instagram antes de publicar

O search_meta_ads cobre posicionamentos do Instagram além do Facebook, já que é uma só biblioteca. Para o orgânico, o search_instagram busca Reels públicos por palavra-chave, que é a superfície em que o formato de fato se move; buscas por perfil e hashtag passam pelo fetch_social_data e pelo search_instagram_hashtag.

A metade paga

Posicionamentos no Instagram são comprados pela mesma árvore de campanhas da Meta que o Facebook: create_meta_campaign → create_meta_adset → create_meta_ad, com posicionamentos selecionáveis por plataforma e posição. O preview_meta_ad mostra o anúncio renderizado real por posicionamento antes de você gastar, e o meta_insights separa os resultados por idade, gênero, posicionamento e país. Essa separação é o que molda o próximo criativo.

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 · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo o que o Codex consegue publicar.

Publique no Instagram 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 Instagram?

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 Instagram e as que pesquisam os anúncios que já estão rodando no seu mercado e criam o criativo do zero.

Como conecto o Instagram 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 Instagram dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Depois disso o Codex publica no Instagram como uma chamada de ferramenta comum.

O Codex consegue publicar um carrossel no Instagram?

Sim, de 2 a 10 slides, e imagens e vídeos podem ser misturados. Dez é o limite publicado pela própria Meta, não um que o Hermoso inventou. O Codex chama a mesma ferramenta de publicação em qualquer caso, e um canal que não consegue carregar um carrossel é recusado com o motivo real anexado.

Quanto custa publicar no Instagram a partir do Codex?

Publicar no Instagram não custa créditos; a Meta não cobra nada por chamada de API. Os créditos vão para o próprio render. 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.

O Codex precisa da minha senha do Instagram?

Não. Você conecta o Instagram ao Hermoso uma vez, por uma tela de consentimento OAuth em um navegador, e o Codex então acessa como uma chamada de ferramenta. Vincular uma conta é a única etapa que não é feita sem interface; nada depois dela precisa de senha, e nenhuma credencial é entregue ao modelo.

O Codex consegue agendar um post no Instagram 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 Instagram é um dos onze canais que entram na fila.