Publicar no Instagram a partir do Cursor

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 Cursor acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Cursor consegue fazer de fato no Instagram, e o que o Instagram não deixa que ele faça.

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

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

“Pegue as seis exportações de ./public/social, publique-as no Instagram como um carrossel nessa ordem e acrescente o permalink à checklist de lançamento.”

Isso percorre search_instagram → plan_ad → render_ad → post_to_meta (target: "instagram"). O Cursor mostra cada chamada de ferramenta no compositor antes de rodá-la, então publicar é um clique, e não um efeito colateral.

Cursor no Instagram: a parte que pega

A ordem é o produto em um carrossel, e é a coisa que um editor facilita para acertar. Os arquivos estão na sua frente, e a Hermoso preserva exatamente a ordem que você passa, removendo apenas repetições idênticas. Dez slides é o teto da Meta, não o nosso. Lembre que a legenda de um post no Instagram não pode ser editada depois de publicada, então a revisão acontece no compositor. O post em si ainda pode ser apagado com manage_meta_post se algum render sair errado.

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

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

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

Qual é o limite de legenda do Instagram ao publicar a partir do Cursor?

A legenda do Instagram tem limite de 2.200 caracteres, e o limite é aplicado quando a publicação é colocada na fila, e não quando ela é disparada. 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 Instagram, além de publicar?

Sim, pela árvore de campanhas da Meta. Os posicionamentos do Instagram são escolhidos dentro de um conjunto de anúncios da Meta. O preview_meta_ad mostra o anúncio real em cada posicionamento antes de você gastar.

O Cursor consegue publicar no Instagram de forma privada ou como rascunho?

Não. A API de Publicação de Conteúdo do Instagram publica ou não faz nada. Não existe publicação não listada, privada nem rascunho. Uma legenda publicada também não pode ser editada; o único campo que a Meta permite alterar em uma publicação no ar é se os comentários estão ativados. Excluir uma publicação é suportado, e isso vale para publicações comuns, Stories, Reels e álbuns de carrossel inteiros. A Hermoso recusa uma visibilidade que o Instagram não consegue cumprir no momento em que você pede, em vez de publicar discretamente algo mais fraco.

O Cursor consegue pesquisar o Instagram antes de publicar?

Sim. O search_meta_ads cobre os posicionamentos do Instagram na Biblioteca de Anúncios da Meta, e o search_instagram pesquisa Reels públicos por palavra-chave.