Instagram Saves Engine — Guia Completo com Prompts | IA Club
Sistema completo com prompts para criar conteúdo otimizado para saves no Instagram.
Por IA Club
Um pipeline que puxa automaticamente seus saves do Instagram para o Notion duas vezes por dia, e depois permite rodar um único comando para transformar esses saves em ideias de conteúdo prontas para produzir. Nada de teoria. Cada passo gera um arquivo real funcionando.
As três peças que você vai construir
Como o sistema funciona
-
O launchd dispara o sync.py às 9h e às 21h
-
O sync.py chama a API web do Instagram usando os cookies de sessão do seu navegador e puxa seus saves
-
Os novos saves chegam no database Instagram Saves com Status = New
-
Você abre o Claude Code e roda
/instagram-sync ideate -
O Claude lê os saves novos, gera ideias de conteúdo na sua voz e escreve as aprovadas no database Content Ideas
Placeholders que você vai personalizar
Prompt inicial para o Claude Code
Cole isso em um projeto novo:
# Construa um sistema de sincronização Instagram Saves → Notion com duas partes:
## Parte 1:
Um script Python em background que autentica na API web do Instagram usando cookies de sessão do navegador, busca todos os posts salvos (com nomes de coleções) e sincroniza os novos em um database do Notion. Cada save é armazenado com autor, legenda, URL, tipo de conteúdo (Post/Reel/Carrossel) e de qual coleção do Instagram veio. Um arquivo de estado evita duplicatas. O script roda automaticamente duas vezes por dia via macOS launchd.
## Parte 2:
Uma skill do Claude Code que lê saves não processados do Notion e os transforma em ideias de conteúdo. Para cada save, ela reformula o conceito original para uma audiência de {{seu_nicho}} — gera 3 variações de hook, um outline estruturado (Hook → Pontos principais → CTA) e breakdowns específicos por plataforma para Instagram, TikTok e YouTube. Apresenta as ideias para revisão, depois salva as aprovadas em um database separado de Content Ideas no Notion e marca os saves originais como processados.
## Objetivo
Um pipeline de zero fricção: salva algo no Instagram, e duas vezes por dia entra automaticamente no Notion. Depois, sob demanda, esses saves viram ideias de conteúdo prontas para produção.
Passo 1 — Pré-requisitos e instalação
O que você precisa
-
Claude Code instalado (claude.ai/claude-code)
-
Mac (a seção do agendador é específica para Mac; usuários Linux podem adaptar com cron)
-
Python 3.9 ou mais recente
-
Conta no Notion com token de integração interna
-
Conta no Instagram com pelo menos alguns posts salvos
Verifique sua versão do Python
python3 --version
Se retornar 3.9 ou superior, está pronto. Se não:
brew install python3
Crie uma integração no Notion
-
Clique em New integration
-
Dê um nome como "Instagram Saves Sync"
-
Em Capabilities, marque Read content, Insert content e Update content
-
Clique em Save. Copie o token que começa com
ntn_— você vai precisar no Passo 4
Crie a pasta do projeto
mkdir instagram-saves-engine
cd instagram-saves-engine
Passo 2 — Construir os dois databases no Notion
Você precisa de dois databases. O primeiro captura saves brutos. O segundo guarda ideias de conteúdo polidas. Mantê-los separados significa que seu calendário de conteúdo fica limpo enquanto seu histórico de saves se acumula em background.
Por que dois databases: Saves é seu feed de pesquisa bruta. Content Ideas é onde vive o conteúdo reformulado, pronto para gravar. Mantê-los separados significa que você pode processar saves em lotes sem bagunçar seu calendário de conteúdo.
Cole este prompt no Claude Code:
Eu quero criar dois databases no Notion para um pipeline de saves do Instagram. Me guie na criação de cada um no Notion e liste cada nome de propriedade e tipo que preciso adicionar.
## Database 1: Instagram Saves
Propriedades necessárias:
- Name (title)
- URL (URL)
- Type (select: Post, Reel, Carousel, IGTV)
- Author (text)
- Status (select: New, Reviewed, Used)
- Media ID (text)
- Saved (date)
- Caption (text)
- Collection (select)
## Database 2: Content Ideas
Propriedades necessárias:
- Name (title)
- Pillar (select: seus pilares de conteúdo aqui)
- Week Of (date)
- Priority (select: High, Medium, Low)
- Hook Options (text)
- Angle (text)
- Status (select: Not started, In progress, Done)
- Format (select: Carousel, Reel, Short Video, Long-form Video)
- Platform (multi-select: Instagram, TikTok, YouTube)
Depois que eu criar, me diga como encontrar os IDs dos databases pela URL do Notion.
Como encontrar o ID de um database no Notion
Abra seu database no Notion e olhe a URL:
https://www.notion.so/seuworkspace/SEU-DATABASE-ID?v=...
A string de 32 caracteres antes do ?v= é o ID do database. Copie os dois IDs — você vai precisar deles nos Passos 4 e 7.
Depois conecte sua integração a cada database:
-
Abra o database
-
Clique no menu de três pontos (canto superior direito)
-
Selecione Connect to e escolha sua integração
-
Repita para o segundo database
Erro comum: Se o Claude Code retornar "Object not found" ao tentar escrever no Notion, você esqueceu de conectar a integração ao database. Volte aqui e adicione.
Passo 3 — Pegar seus cookies de sessão do Instagram
O Instagram não tem API pública para posts salvos. A autenticação é feita usando os mesmos cookies de sessão que seu navegador já envia em cada requisição.
-
Abra o Chrome e faça login no instagram.com
-
Pressione Cmd+Option+I para abrir o DevTools
-
Clique em Application na barra de abas superior
-
Na barra lateral esquerda, expanda Cookies e clique em
https://www.instagram.com -
Encontre
sessionid. Copie o Value inteiro. -
Encontre
csrftoken. Copie o Value inteiro. -
Encontre
ds_user_id. Copie o Value inteiro (este é o seu ID de usuário do Instagram como número).
Mantenha esses três valores em mãos. Você vai adicioná-los ao arquivo de config no Passo 4.
Trate esses cookies como senha. Qualquer pessoa com seu
sessionidpode acessar sua conta do Instagram. Nunca faça commit deles no git. Armazenamos em umconfig.jsonlocal que fica apenas na sua máquina.
Os cookies expiram. O Instagram rotaciona os cookies de sessão a cada poucas semanas. Quando seu sync começar a falhar, volte a este passo e pegue valores frescos. O slash command
/instagram-synctem uma ação "Refresh session" embutida para guiar você.
Passo 4 — Gerar o sync daemon (sync.py)
O Claude Code vai gerar o arquivo Python inteiro. Você não precisa escrever uma linha de Python.
Cole este prompt no Claude Code (com a pasta do projeto aberta):
Construa um script Python chamado `sync.py` que puxa meus posts salvos do Instagram e escreve os novos em um database do Notion.
## Inputs (do config.json no mesmo diretório):
- ig_session_id, ig_csrftoken, ig_user_id (cookies web do Instagram)
- notion_token (token de integração do Notion começando com ntn_)
- notion_database_id (ID do meu database Instagram Saves)
- collections_filter (lista opcional de nomes de coleções para sincronizar, ex: ["Ideias de Conteúdo", "Inspiração"])
## Chamadas à API do Instagram (imitar o cliente web, não o app mobile):
- Headers: User-Agent do Chrome desktop, X-IG-App-ID: 936619743392459
- Cookies: sessionid, csrftoken, ds_user_id
- Validar sessão: GET https://www.instagram.com/api/v1/accounts/edit/web_form_data/
- Buscar saves: GET https://www.instagram.com/api/v1/feed/saved/posts/?count=50, paginar com next_max_id, sleep de 1 segundo entre páginas
- Buscar nomes de coleções: GET https://www.instagram.com/api/v1/collections/list/ com collection_types=["ALL_MEDIA_AUTO_COLLECTION","PRODUCT_AUTO_COLLECTION","MEDIA"]
## Lógica de dedup:
- Manter state.json com lista de media IDs já sincronizados
- Pular qualquer post cujo pk já esteja na lista
- Só adicionar IDs ao state.json após writes bem-sucedidos no Notion
## Writes no Notion (usar o SDK Python oficial notion-client):
- Criar uma página por post novo com estas propriedades: Name (title = @autor/code), URL, Type (select: Post/Reel/Carousel/IGTV baseado em media_type e product_type), Author (text), Status (select = "New"), Media ID (text), Saved (date = agora UTC), Caption (text, truncado para 1900 chars), Collection (select = nome da coleção correspondente se filtro estiver definido)
- Formato de URL: https://instagram.com/reel/CODE/ para reels, /p/CODE/ para todo o resto
## Logging:
- Logar tanto no stdout quanto em sync.log no mesmo diretório
- Linha de resumo final formato: Sync complete: N new | N skipped | N total | N errors
## Tratamento de erros:
- Exceções por post: logar o erro e continuar o loop, não crashar a execução
- IDs que falharam NÃO devem ser adicionados ao state.json (para tentar novamente no próximo run)
- Sessão inválida: sair imediatamente com mensagem clara para atualizar os cookies
Também gere:
- requirements.txt (requests>=2.31.0, notion-client>=2.2.0)
- config.example.json (template com strings placeholder para todas as chaves necessárias)
- .gitignore (exclui config.json, state.json, sync.log e .venv/)
Por que não usar instagrapi: A popular biblioteca instagrapi tem como alvo a API mobile do Instagram e é detectada mais rápido. A API web que usamos aqui imita exatamente o que seu navegador envia, o que é de menor risco para um script pessoal rodando na sua própria conta.
Assim que o Claude gerar os arquivos, configure o ambiente Python:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Depois copie o config de exemplo e preencha:
cp config.example.json config.json
Abra config.json e substitua cada placeholder:
-
ig_session_id,ig_csrftoken,ig_user_id: os valores de cookie do Passo 3 -
notion_token: seu token de integraçãontn_...do Passo 1 -
notion_database_id: o ID do database Instagram Saves do Passo 2 -
collections_filter: um array JSON com nomes de coleções, ou remova a chave para puxar todos os saves
Passo 5 — Rodar a primeira sincronização
.venv/bin/python3 sync.py
Uma execução bem-sucedida parece assim:
Instagram session valid for @seuusuario
Fetching saved posts...
Found X collections
Sync complete: 47 new | 0 skipped | 47 total | 0 errors
Abra seu database Instagram Saves no Notion. Você deve ver linhas com Status = New e campos preenchidos para cada save.
Pro tip: Se a primeira execução puxar mais saves do que esperado, adicione
collections_filterao config.json listando apenas as coleções que você realmente quer. Minha configuração puxa de apenas duas: "Ideias de Conteúdo" e "Claude Code". Todo o resto fica fora.
Importante: Quando o Claude Code para de consumir tokens, isso não significa que o script parou. O sync.py continua rodando em background. Não aperte Ctrl+C. Espere aparecer a mensagem final de resumo. Se passar de 30 minutos sem atualização, rode:
Can you check whether the running sync.py process is still actively working or stuck?
Assim que você vir linhas no Notion com Status = New, a infraestrutura está pronta. Tudo a partir daqui é configuração.
Passo 6 — Agendar com launchd
O launchd é o agendador de processos nativo do Mac. Este job vai rodar o sync.py duas vezes por dia, todos os dias, mesmo quando você não estiver na frente do computador.
Cole este prompt no Claude Code:
Gere um arquivo plist para macOS launchd chamado `com.meunome.instagram-saves-sync.plist` que rode `.venv/bin/python3 sync.py` do meu diretório de projeto às 9h e às 21h todos os dias.
Use caminhos absolutos em todo lugar. Capture stdout em `launchd-stdout.log` e stderr em `launchd-stderr.log` no diretório do projeto.
Meu diretório de projeto é: [cole seu caminho absoluto aqui]
Depois de escrever o arquivo, me dê os dois comandos bash para instalá-lo:
1. Copiar para ~/Library/LaunchAgents/
2. Carregar com launchctl
Rode os dois comandos que o Claude fornecer. Depois verifique:
launchctl list | grep instagram-saves
Se aparecer uma entrada, o agendador está rodando. Vai disparar às 9h e às 21h mesmo depois de reiniciar o Mac.
Por que launchd e não cron: O launchd é o agendador oficial do Mac. Inicia no boot automaticamente, gera logs de forma limpa e é como a Apple pretende que processos em background rodem.
Pro tip: Se o agendador parar de funcionar após uma atualização do macOS, recarregue com
launchctl load ~/Library/LaunchAgents/com.meunome.instagram-saves-sync.plist.