Instagram no Claude em 3 Passos

O Claude sempre soube pensar conteúdo. Ele escreve legenda, discute ângulo, ajuda no gancho do Reel. O que faltava era o seu perfil. Com o conector do Windsor.ai ligado no Claude, o Instagram Insights da sua conta fica acessível na própria conversa, e ele passa a ler o que aconteceu de verdade em vez de opinar no vácuo.

Este tutorial é o caminho inteiro, na ordem em que você vai usar. Primeiro a conexão, que são 3 passos e um deles quase todo mundo pula. Depois a cadeia de prompts, que é o produto de verdade: ler o perfil, entender o que parou de funcionar e por quê, diagnosticar um post específico, decidir a estratégia, escrever o roteiro e fechar a legenda. Cada prompt está pronto para copiar e colar.

Antes de começar

A boa notícia é que esse caminho dispensa a parte chata. Você não precisa criar app de desenvolvedor na Meta, não precisa gerar token e não precisa escrever uma linha de código. É conta no Windsor, conector no app e autorização por login.

Os 3 passos da conexão

Antes dos passos, um ajuste de expectativa que vai te poupar tempo. Os 3 passos que circulam por aí são criar a conta, conectar o Instagram e instalar a integração. Na prática os dois primeiros acontecem na mesma tela, de uma vez, e o terceiro não tem chave nenhuma para copiar. Então, em vez de forçar uma simetria bonita, aqui estão os 3 passos que funcionam de verdade.

Nenhum deles pede terminal. Se você nunca abriu um, não vai precisar abrir agora.

https://onboard.windsor.ai/app/instagram

Confirmar que conectou

Antes de pedir análise de qualquer coisa, faça um pedido de checagem. Ele responde três perguntas de uma vez: se a conexão está de pé, em que plano do Windsor você está e até onde o seu histórico vai na prática.

Rode get_connectors e me mostre quais contas de Instagram estão conectadas no Windsor.

Depois rode get_current_user e me diga em que plano do Windsor eu estou.

Por último, tente puxar um post meu de 90 dias atrás com get_data. Se voltar vazio, vá aproximando a data até achar o post mais antigo que traz dado, e me diga a partir de quando o meu histórico começa.

As respostas juntas dizem exatamente onde você parou. Se ele não listar ferramenta nenhuma, o toggle do conector não está ligado nessa conversa. Se listar as ferramentas mas nenhuma conta de Instagram, o problema está do outro lado: ou a autorização no Windsor não completou, ou completou com um login da Meta que não enxerga esse perfil. E se vier ferramenta e conta, está tudo certo.

claude mcp add --transport http --scope user windsor https://mcp.windsor.ai

# para conferir depois:
claude mcp list

# a linha que você quer ver tem o windsor e o status Connected

Se a listagem disser que falta autenticação, não é erro de instalação: é só o login pendente. Rode a barra mcp dentro do Claude Code e autentique.

O que ele passa a enxergar do seu perfil

A partir daqui o seu perfil vira uma coisa que você pergunta, não uma coisa que você abre. O catálogo de campos do Instagram Insights é grande e muda com o tempo, então não vale decorar lista. Vale saber o que cabe no pedido.

• •Cada publicação com data, formato, legenda e link, que é o que permite cruzar o que o texto diz com o que o número mostra
• •Alcance, visualizações, salvamentos, compartilhamentos, curtidas e comentários por publicação
• •O texto dos comentários, e não só a contagem, que é o que abre a porta para leitura de sentimento e pesquisa de pauta
• •Retenção de Reels: tempo médio assistido, taxa de abandono e total de interações
• •Audiência por país, cidade, faixa de idade e gênero
• •O perfil no período, para comparar um mês com o outro sem depender da sua memória

Sobre o frescor do dado, uma diferença que importa se você já usou integração de anúncio: aqui a consulta vai à API do Instagram na hora do pedido, não existe sincronização agendada esperando virar o dia. Com um asterisco honesto, porque existe cache: parte da resposta pode ter sido buscada um pouco antes. Isso dá para auditar.

Nos prompts abaixo, repare que eu escrevo o nome do campo. Isso não é firula técnica. Escrever media_saved em vez de pedir salvamentos é a diferença entre ele acertar a tabela de primeira e ficar tateando o catálogo inteiro até achar. Você copia, ele entende, e a resposta vem no formato que você pediu.

A cadeia de prompts

Estes são os prompts que eu uso, na ordem em que eu uso. Eles são encadeados de propósito: cada um consome o resultado do anterior, então rode todos na mesma conversa e não abra chat novo no meio do caminho. A conversa é a memória do processo. Quando você pede o roteiro, ele já leu o seu perfil inteiro, já sabe o que caiu e já sabe qual post você quer repetir.

O primeiro elo é a análise do perfil. Use este quando abrir a conversa, sempre. É ele que tira todo o resto do campo da impressão.

Usando o conector Windsor, puxe meus posts do Instagram dos últimos 30 dias com os campos timestamp, media_type, media_product_type, media_caption, media_reach, media_views, media_saved, media_shares, media_like_count, media_comments_count e media_permalink.

Me devolva o retrato do perfil em quatro partes:

1. Cadência: quantos posts por semana, em que dias e em que horários eu publico.
2. Mix de formato: quanto de cada media_type e media_product_type, e como cada formato se comporta em alcance e em salvamento.
3. Temas: agrupe as legendas em no máximo seis temas, diga quanto cada tema representa do que eu publico e como cada um performa.
4. Padrões de escrita: como minhas legendas costumam abrir, que tamanho elas têm e que tipo de chamada eu uso no fim.

Traga também a audiência com audience_country_name, audience_age_name e audience_gender_name, junto com os campos de tamanho correspondentes.

Use só o que você puxou. Se algum dado não vier, diga que não veio em vez de estimar.

O que volta é o seu perfil descrito por quem não tem apego a ele. Quase sempre tem uma surpresa: o tema que você acha que é o seu não é o que mais aparece, ou o formato que você menos gosta de fazer é o que mais guarda gente. Leia com calma, porque tudo daqui para baixo se apoia nessa leitura.

Relatório: o que funcionou, o que parou e por quê

Use este logo depois do retrato, uma vez por mês. É a leitura que ninguém faz sozinho porque dá trabalho.

Compare meus posts dos últimos 30 dias com os 30 dias anteriores usando media_type, media_product_type, media_caption, media_reach, media_views, media_saved, media_shares e media_comments_count.

Para cada formato, mostre a mediana de alcance e de salvamentos nos dois períodos e a variação. Use mediana, não média, porque um post fora da curva distorce a média e esconde a tendência.

Depois me responda três coisas:

1. O que continua funcionando, e o que esses posts têm em comum na legenda, no tema e no formato.
2. O que parou de funcionar, e se a queda foi de alcance, ou seja, menos gente viu, ou de engajamento, ou seja, a mesma gente reagiu menos.
3. Para cada queda, a hipótese mais provável e qual dado do próprio período sustenta essa hipótese.

Separe com clareza o que é leitura do dado e o que é palpite seu, e marque cada um. Não invente causa externa que você não consegue checar no que puxou.

Repare no item dois. Queda de alcance e queda de engajamento pedem reações opostas: uma é distribuição, a outra é conteúdo. Tratar as duas como a mesma coisa é o motivo mais comum de alguém mudar a estratégia inteira quando bastava mudar o gancho. E o item três é o que separa relatório de ranking: ranking diz quem ganhou, hipótese diz o que fazer amanhã.

Se você publica Reel com frequência, vale acoplar esta variação ao relatório. Reel tem uma métrica que o resto não tem: quanto tempo a pessoa ficou e em que ponto ela saiu. É o feedback mais direto que existe sobre o seu gancho.

Liste meus Reels dos últimos 60 dias com media_permalink, media_caption, media_views, media_reel_avg_watch_time, media_reel_skip_rate e media_reel_total_interactions.

Ordene por media_reel_skip_rate, do menor para o maior.

Compare os três de menor abandono com os três de maior e descreva a diferença nos primeiros três segundos, com base no que a legenda indica sobre o tema e o gancho.

Termine com uma regra prática de abertura que eu possa aplicar no próximo Reel, tirada dos meus próprios Reels que seguraram gente.

Diagnóstico: por que aquele post foi o que foi

Use este quando um post te surpreender, para cima ou para baixo. É o único da cadeia que precisa de uma informação sua: o link do post.

Quero entender um post específico: [cole aqui o link do post]

Puxe os dados dele com media_permalink, media_caption, media_type, media_product_type, timestamp, media_reach, media_views, media_saved, media_shares, media_like_count e media_comments_count. Se for Reel, traga também media_reel_avg_watch_time, media_reel_skip_rate e media_reel_total_interactions.

Compare esse post com a mediana dos meus últimos 30 dias no mesmo formato e me diga, nesta ordem:

1. Ele ficou acima ou abaixo do meu normal, e em qual métrica exatamente.
2. Onde a curva quebrou: pouca gente viu, muita gente viu e passou, ou viu e não guardou.
3. O que na legenda, no tema e no gancho pode explicar isso, usando os meus próprios posts parecidos como referência.

Depois puxe comment_text dos comentários desse post e me diga o que as pessoas responderam de fato, não só quantas responderam.

Se você não achar esse post pelo link, puxe os últimos 30 dias e case pelo media_permalink. Se ele não estiver nesse período, me diga em vez de analisar outro no lugar.

O item dois é o coração deste prompt. Post que pouca gente viu tem um problema. Post que muita gente viu e ninguém guardou tem outro, bem diferente, e o segundo é mais fácil de consertar do que parece. A leitura dos comentários no fim fecha a conta: é ali que aparece o que a pessoa entendeu, que nem sempre é o que você quis dizer.

Estratégia: o próximo ciclo

Use este depois do relatório, quando for planejar as próximas semanas. Ele decide com base no seu histórico, não no que costuma funcionar no Instagram em geral.

Com base no retrato e no relatório que você acabou de fazer, monte o meu próximo ciclo de conteúdo.

Antes, puxe meus dez posts com maior media_saved dos últimos 90 dias, trazendo media_caption, media_type, media_product_type, media_reach e media_saved. Use isso como base, e não a sua opinião sobre o que funciona no Instagram.

Me entregue:

1. Os três temas que mais guardam audiência, com os posts que provam cada um.
2. O formato certo para cada tema, segundo o meu próprio histórico.
3. Uma pauta de seis posts para as próximas duas semanas, cada um com tema, formato, ângulo e a razão pela qual ele está na lista.
4. Uma coisa que eu deveria parar de publicar, com o dado que justifica.

Se o histórico do meu plano não alcançar 90 dias, use o máximo que der e me diga qual período você usou de verdade.

O item quatro é o que mais dói e o que mais rende. Todo perfil tem um formato que sobrevive por hábito, e ver o dado escrito é mais fácil do que admitir sozinho. E o pedido final, sobre dizer qual período usou, é higiene: sem ele você pode receber uma estratégia construída em cima de metade do histórico sem saber.

Ainda na estratégia, tem uma fonte de pauta que quase ninguém usa. Como o conector traz o texto do comentário, e não só a contagem, dá para tratar a sua caixa de comentários como o que ela é: uma pesquisa de audiência que você já fez e nunca tabulou.

Puxe os comentários dos meus posts dos últimos 30 dias com comment_text, comment_timestamp, comment_like_count e media_id, e cruze com media_caption do post correspondente.

Agrupe os comentários em dúvidas, objeções, elogios e pedidos de conteúdo.

Liste as cinco dúvidas mais repetidas, com as palavras que as pessoas usaram. Cada uma delas é um post que eu ainda não fiz.

Me diga também qual objeção aparece mais, porque é ela que eu preciso responder antes de vender qualquer coisa.

Roteiro: o próximo Reel

Use este logo depois da estratégia, ainda na mesma conversa. Aqui a leitura vira produção.

Escolha o tema mais forte da pauta que você acabou de montar e escreva o roteiro de um Reel de 45 segundos.

Antes de escrever, releia as legendas dos meus posts que sustentam esse tema e os meus Reels com menor media_reel_skip_rate, para lembrar como eu abro e como eu falo.

Estrutura:

1. Gancho de 3 segundos, com três opções para eu escolher.
2. Três blocos de desenvolvimento, um por ideia, na ordem em que fazem sentido.
3. Fechamento que entrega alguma coisa, sem pedir curtida.

Escreva na minha voz, usando as minhas legendas como referência de tom, e não invente um estilo novo. Marque onde entra corte, texto na tela e mudança de plano.

A instrução sobre a voz é a mais importante do prompt inteiro. Sem ela, o texto sai no tom médio da internet. Com ela, ele tem material real seu para imitar, que são as suas legendas que ele acabou de ler. Ainda assim, o que sai dali é rascunho: você reescreve por cima, e é nessa reescrita que o post vira seu.

Legenda e chamada: fechando o post

Use este por último, com o roteiro já escolhido. É o elo que fecha o ciclo e devolve tudo para o dado de novo.

Agora escreva a legenda desse Reel, em três versões, todas na minha voz:

1. Uma curta, que funciona sozinha se a pessoa não ouvir o áudio.
2. Uma que conta a mesma ideia com um exemplo concreto.
3. Uma que abre com a objeção mais comum dos meus comentários dos últimos 30 dias, puxando comment_text para encontrar essa objeção.

Em todas, a primeira linha precisa fazer sentido sozinha, porque é só ela que aparece antes do ver mais.

Feche com uma chamada só, no formato que já funcionou nos meus posts com maior media_comments_count e maior media_saved. Se o que funciona comigo for pedir salvamento, peça salvamento. Não copie chamada de fora.

E o ciclo reinicia sozinho. O post sai, a semana passa, você volta na conversa e roda o diagnóstico daquele post específico. O que ele aprendeu sobre o seu perfil vira o material do próximo retrato. É por isso que eu insisto em rodar tudo na mesma conversa: a cadeia só fica melhor se ela lembrar do que já leu.

Publicar, ele publica

Agora a parte que costuma surpreender. O conector não é só leitura. Pelo Instagram, o Windsor expõe ações de escrita que cobrem publicar foto no feed, publicar vídeo, publicar carrossel e publicar story, além de comentar, responder comentário, ocultar, reexibir e apagar comentário. Detalhe da própria plataforma: vídeo único no feed sai como Reel, e quem decide isso é o Instagram. E tem uma condição prática que vale saber antes de cogitar automatizar isso: publicar por ali não é escolher o arquivo no rolo do celular. A foto ou o vídeo precisam já estar hospedados num endereço público, que você entrega junto com o pedido, e isso vale para feed, carrossel e story.

Então quando eu digo que quem publica é você, não é limite de ferramenta. É escolha, e eu prefiro deixar ela explícita a deixar você descobrir sozinho em dois minutos de teste. O que eu quero do Claude é a leitura fria do que aconteceu e o rascunho do que vem. O texto final, a capa, a hora de subir e a decisão de publicar continuam comigo, porque é ali que está a minha voz e o meu nome. Delegar a leitura é ganho. Delegar a publicação é terceirizar a assinatura.

Vale saber também que esse conjunto de ações cresce. Entre uma conferida e outra, neste ano, ele ganhou ações novas de comentário que antes não existiam. Não trate a lista como fechada: pergunte ao Claude o que existe hoje na sua conta em vez de assumir o que leu em qualquer tutorial, inclusive neste.

O que não dá para pedir

Esta seção é a que quase nenhum tutorial tem paciência de escrever, e é a que evita frustração no meio da cadeia. Os limites abaixo não são do Windsor: vêm da Meta, e valem para qualquer ferramenta que leia o Instagram.

• •Perfil de concorrente. O Insights cobre só a sua conta. Para ler perfil de terceiro existe uma fonte separada, a de dados públicos, e no plano gratuito ela ocuparia a sua única fonte. Ou a sua conta, ou a dos outros
• •Curva de seguidores para trás. A contagem de seguidores vem só do dia de hoje, sem histórico. Existe um campo de variação diária, mas ele não funciona em conta pequena e nunca traz o dia corrente
• •Histórico de Stories. Story vive um dia e some, e o dado some junto. Se você quer medir Story, a leitura precisa acontecer enquanto ele ainda está no ar
• •Qual Reel te trouxe seguidor. Visitas ao perfil, cliques no perfil e seguidores ganhos por publicação não são suportados para Reels. É exatamente a pergunta que todo criador quer fazer, e é a que não tem resposta
• •Impressões. O campo foi aposentado, junto com reproduções de vídeo. Um prompt pedindo impressões pode voltar vazio. Peça visualizações
• •Julgar o criativo. Ele lê a legenda e os números, não o arquivo do post. Se a capa ficou fraca ou o corte saiu errado, isso continua sendo olho seu

Nada disso diminui o ganho. O trabalho repetitivo, que é abrir o painel, anotar número, comparar de cabeça e tentar lembrar o que funcionou, sai do seu dia. O que sobra é decidir o que dizer, que é onde você deveria estar mesmo.

Pegadinhas e erros comuns

• •Conector adicionado e toggle desligado na conversa. É o erro mais comum de todos, e a cara dele é a de integração quebrada
• •Perfil pessoal. Sem conta profissional vinculada a uma Página, a API da Meta não abre, e não existe contorno
• •Autorizar com o login errado da Meta. Se ele lista as ferramentas mas nenhuma conta de Instagram, comece a investigação por aí
• •Confundir Instagram Insights com Instagram Public Data na hora de escolher a fonte. Uma é a sua conta, a outra é a dos outros
• •Tentar escolher campos e destino na tela do Windsor. Aquele é o caminho de planilha e banco, e não leva a lugar nenhum aqui
• •Quebrar a cadeia abrindo chat novo a cada prompt. Sem a conversa anterior, o roteiro nasce genérico de novo
• •Pedir um período maior do que o histórico do seu plano. A resposta volta menor do que você esperava e sem dizer o porquê
• •Pedir impressões. O campo foi aposentado, então peça visualizações
• •Querer duas fontes no plano gratuito. É uma fonte e uma conta, então o seu Instagram junto com a conta de anúncio já pede plano pago
• •Deixar a ferramenta de escrita marcada como sempre permitir. Ela cobre desde responder comentário até publicar no seu perfil
• •Aceitar a hipótese como se fosse fato. Ele descreve bem o que aconteceu, mas o porquê é ponto de partida seu para confirmar

Checklist final

A mudança real não é o Claude publicar por você. É parar de olhar o seu próprio perfil por cima do ombro, rolando o feed no celular e tentando lembrar o que deu certo mês passado. Você pergunta, ele lê tudo de uma vez, te devolve o padrão e escreve o rascunho. A parte de decidir o que dizer continua sua. E é bom que continue.