Skill: Instagram Integration
Overview
Integracao completa com Instagram via Graph API. Publicacao, analytics, comentarios, DMs, hashtags, agendamento, templates e gestao de contas Business/Creator.
When to Use This Skill
- When the user mentions "instagram" or related topics
- When the user mentions "ig" or related topics
- When the user mentions "post instagram" or related topics
- When the user mentions "publicar instagram" or related topics
- When the user mentions "reels instagram" or related topics
- When the user mentions "stories instagram" or related topics
Do Not Use This Skill When
- The task is unrelated to instagram
- A simpler, more specific tool can handle the request
- The user needs general-purpose assistance without domain expertise
How It Works
Controle completo da conta Instagram via Graph API. Publicação, comunidade, analytics, DMs, hashtags, templates e dashboard — tudo gerido com governança (rate limits, audit log, confirmações antes de ações públicas).
Resumo Rápido
| Área | Scripts | O que faz |
|---|---|---|
| Setup | account_setup.py, auth.py | Configurar conta, OAuth, token |
| Publicação | publish.py, schedule.py | Publicar foto/vídeo/reel/story/carrossel, agendar |
| Comunidade | comments.py, messages.py | Comentários, DMs, menções |
| Analytics | insights.py, analyze.py | Métricas, melhores horários, top posts |
| Hashtags | hashtags.py | Pesquisa e tracking |
| Inteligência | templates.py, analyze.py | Templates de conteúdo, tendências |
| Infra | export.py, serve_api.py, run_all.py | Exportar, dashboard, sync |
| Leitura | profile.py, media.py | Perfil, listar mídia |
Localização
C:\Users\renat\skills\instagram\
├── SKILL.md
├── scripts/
│ ├── requirements.txt
│ │ # ── CORE ──
│ ├── config.py # Paths, constantes, specs de mídia
│ ├── db.py # SQLite: accounts, posts, comments, insights
│ ├── auth.py # OAuth 2.0, token storage/refresh
│ ├── api_client.py # Instagram Graph API wrapper + retry
│ ├── governance.py # Rate limits, audit log, confirmações
│ │ # ── FEATURES ──
│ ├── account_setup.py # Detecção conta, migração, verificação
│ ├── publish.py # Publicar + upload local via Imgur
│ ├── schedule.py # Orquestrador: approved → published
│ ├── comments.py # Ler/responder/deletar comentários
│ ├── messages.py # DMs (enviar/receber/listar)
│ ├── insights.py # Fetch + store métricas
│ ├── hashtags.py # Pesquisa + tracking
│ ├── profile.py # Ver/atualizar perfil
│ ├── media.py # Listar mídia, detalhes
│ │ # ── INTELIGÊNCIA ──
│ ├── templates.py # Templates de caption/hashtags
│ ├── analyze.py # Melhores horários, top posts
│ │ # ── INFRA ──
│ ├── export.py # Exportar JSON/CSV/JSONL
│ ├── serve_api.py # FastAPI + dashboard
│ └── run_all.py # Sync completo
├── references/
│ ├── graph_api.md # Endpoints e parâmetros
│ ├── permissions.md # Scopes OAuth por feature
│ ├── rate_limits.md # Limites 2025
│ ├── account_types.md # Business vs Creator
│ ├── publishing_guide.md # Specs de mídia
│ ├── setup_walkthrough.md # Guia Meta App
│ └── schema.md # ER diagram
├── static/
│ └── dashboard.html # Dashboard Chart.js
└── data/
## Instalação (Uma Vez)
```bash
pip install -r C:\Users\renat\skills\instagram\scripts\requirements.txt
Configuração Inicial
## 1. Verificar Tipo De Conta Instagram
python C:\Users\renat\skills\instagram\scripts\account_setup.py --check
## 2. Configurar Oauth (Abre Browser Para Autorização)
python C:\Users\renat\skills\instagram\scripts\auth.py --setup
## 3. Verificar Se Está Tudo Funcionando
python C:\Users\renat\skills\instagram\scripts\profile.py --view
Se a conta for pessoal, o script account_setup.py --guide dá instruções de migração
para Business ou Creator.
Foto (Aceita Arquivo Local — Faz Upload Automático Via Imgur)
python C:\Users\renat\skills\instagram\scripts\publish.py --type photo --image caminho/foto.jpg --caption "Texto do post"
Vídeo
python C:\Users\renat\skills\instagram\scripts\publish.py --type video --video caminho/video.mp4 --caption "Meu vídeo"
Reel
python C:\Users\renat\skills\instagram\scripts\publish.py --type reel --video caminho/reel.mp4 --caption "Novo reel!"
Story
python C:\Users\renat\skills\instagram\scripts\publish.py --type story --image caminho/story.jpg
Carrossel (2-10 Imagens)
python C:\Users\renat\skills\instagram\scripts\publish.py --type carousel --images img1.jpg img2.jpg img3.jpg --caption "Carrossel"
Criar Como Rascunho (Não Publica Imediatamente)
python C:\Users\renat\skills\instagram\scripts\publish.py --type photo --image foto.jpg --caption "Texto" --draft
Aprovar Rascunho Para Publicação
python C:\Users\renat\skills\instagram\scripts\publish.py --approve --id 5
## Agendar Publicação Futura
python C:\Users\renat\skills\instagram\scripts\schedule.py --type photo --image foto.jpg --caption "Post agendado" --at "2026-03-01T10:00"
## Listar Posts Agendados
python C:\Users\renat\skills\instagram\scripts\schedule.py --list
## Processar Posts Prontos Para Publicar
python C:\Users\renat\skills\instagram\scripts\schedule.py --process
## Cancelar Agendamento
python C:\Users\renat\skills\instagram\scripts\schedule.py --cancel --id 5
Listar Comentários De Um Post
python C:\Users\renat\skills\instagram\scripts\comments.py --list --media-id 12345
Responder A Um Comentário
python C:\Users\renat\skills\instagram\scripts\comments.py --reply --comment-id 67890 --text "Obrigado!"
Deletar Comentário
python C:\Users\renat\skills\instagram\scripts\comments.py --delete --comment-id 67890
Ver Menções
python C:\Users\renat\skills\instagram\scripts\comments.py --mentions
Comentários Não Respondidos
python C:\Users\renat\skills\instagram\scripts\comments.py --unreplied
## Enviar Dm
python C:\Users\renat\skills\instagram\scripts\messages.py --send --user-id 12345 --text "Olá!"
## Listar Conversas
python C:\Users\renat\skills\instagram\scripts\messages.py --conversations
## Ver Mensagens De Uma Conversa
python C:\Users\renat\skills\instagram\scripts\messages.py --thread --conversation-id 12345
Métricas De Um Post Específico
python C:\Users\renat\skills\instagram\scripts\insights.py --media --media-id 12345
Métricas Da Conta (Últimos 7 Dias)
python C:\Users\renat\skills\instagram\scripts\insights.py --user --period day --since 7
Buscar E Salvar Insights De Todos Os Posts Recentes
python C:\Users\renat\skills\instagram\scripts\insights.py --fetch-all --limit 20
## Melhores Horários Para Postar (Baseado Nos Seus Dados)
python C:\Users\renat\skills\instagram\scripts\analyze.py --best-times
## Top Posts Por Engajamento
python C:\Users\renat\skills\instagram\scripts\analyze.py --top-posts --limit 10
## Tendências De Crescimento
python C:\Users\renat\skills\instagram\scripts\analyze.py --growth --period 30
Buscar Posts Recentes Com Uma Hashtag
python C:\Users\renat\skills\instagram\scripts\hashtags.py --search "artificialintelligence" --limit 25
Top Posts De Uma Hashtag
python C:\Users\renat\skills\instagram\scripts\hashtags.py --top "tecnologia"
Info Da Hashtag (Contagem De Posts)
python C:\Users\renat\skills\instagram\scripts\hashtags.py --info "marketing"
## Criar Template
python C:\Users\renat\skills\instagram\scripts\templates.py --create --name "promo" --caption "Nova promoção: {produ