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

  1. O launchd dispara o sync.py às 9h e às 21h

  2. O sync.py chama a API web do Instagram usando os cookies de sessão do seu navegador e puxa seus saves

  3. Os novos saves chegam no database Instagram Saves com Status = New

  4. Você abre o Claude Code e roda /instagram-sync ideate

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

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

  1. Acesse notion.so/profile/integrations

  2. Clique em New integration

  3. Dê um nome como "Instagram Saves Sync"

  4. Em Capabilities, marque Read content, Insert content e Update content

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

  1. Abra o database

  2. Clique no menu de três pontos (canto superior direito)

  3. Selecione Connect to e escolha sua integração

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

  1. Abra o Chrome e faça login no instagram.com

  2. Pressione Cmd+Option+I para abrir o DevTools

  3. Clique em Application na barra de abas superior

  4. Na barra lateral esquerda, expanda Cookies e clique em https://www.instagram.com

  5. Encontre sessionid. Copie o Value inteiro.

  6. Encontre csrftoken. Copie o Value inteiro.

  7. 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 sessionid pode acessar sua conta do Instagram. Nunca faça commit deles no git. Armazenamos em um config.json local 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-sync tem 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:


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


Passo 7 — Construir o slash command /instagram-sync