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)
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: {produto}! {desconto}% OFF" --hashtags "#oferta,#desconto,#promoção"
Listar Templates
python C:\Users\renat\skills\instagram\scripts\templates.py --list
Usar Template Em Um Post
python C:\Users\renat\skills\instagram\scripts\publish.py --type photo --image foto.jpg --template promo --vars produto="Tênis" desconto=30
## Ver Perfil
python C:\Users\renat\skills\instagram\scripts\profile.py --view
## Listar Posts Recentes
python C:\Users\renat\skills\instagram\scripts\media.py --list --limit 10
## Detalhes De Um Post
python C:\Users\renat\skills\instagram\scripts\media.py --details --media-id 12345
Exportar Analytics Para Csv
python C:\Users\renat\skills\instagram\scripts\export.py --type insights --format csv
Exportar Comentários
python C:\Users\renat\skills\instagram\scripts\export.py --type comments --format json
Exportar Tudo
python C:\Users\renat\skills\instagram\scripts\export.py --type all --format csv
Iniciar Dashboard Web
python C:\Users\renat\skills\instagram\scripts\serve_api.py
Acesse: Http://Localhost:8000/Dashboard
## Status Da Autenticação
python C:\Users\renat\skills\instagram\scripts\auth.py --status
## Sync Completo (Busca Perfil + Mídia + Insights + Comentários)
python C:\Users\renat\skills\instagram\scripts\run_all.py
## Sync Parcial
python C:\Users\renat\skills\instagram\scripts\run_all.py --only media insights
Rate Limits
A skill rastreia automaticamente os rate limits da API:
- 200 requests/hora por conta
- 25 publicações/dia por conta
- 30 hashtags únicas/semana por conta
- 200 DMs/hora por conta
Quando em 90% do limite, a skill emite warnings. Se exceder, bloqueia a ação e informa quanto tempo esperar.
Confirmações
Ações que afetam conteúdo público requerem confirmação:
- PUBLISH: Publicar foto/vídeo/reel/story/carrossel
- DELETE: Deletar comentário
- MESSAGE: Enviar DM
- ENGAGE: Responder comentário, ocultar comentário
O script retorna os detalhes da ação e pede confirmação antes de executar.
Audit Log
Todas as ações que modificam dados são logadas no banco SQLite (action_log table):
- Timestamp, ação, parâmetros, resultado, status de confirmação
- Consultar via:
python C:\Users\renat\skills\instagram\scripts\db.py
Token Auto-Refresh
O token OAuth (60 dias) é renovado automaticamente quando está a 7 dias de expirar. Sem intervenção manual necessária.
Limitações Da Api
Coisas que a Instagram Graph API não permite:
- Deletar posts já publicados
- Editar captions após publicar
- Aplicar filtros via API
- Postar de contas pessoais (só Business/Creator)
- DMs fora da janela de 24hrs (usuário precisa ter interagido primeiro)
- Fotos em formato diferente de JPEG (auto-conversão feita pelos scripts)
"Quero Publicar Uma Foto"
python C:\Users\renat\skills\instagram\scripts\publish.py --type photo --image foto.jpg --caption "Texto""Me Mostra Meus Analytics"
python C:\Users\renat\skills\instagram\scripts\run_all.py --only insights
python C:\Users\renat\skills\instagram\scripts\analyze.py --summary"Qual O Melhor Horário Para Postar?"
python C:\Users\renat\skills\instagram\scripts\analyze.py --best-times"Responde Esse Comentário"
python C:\Users\renat\skills\instagram\scripts\comments.py --reply --comment-id ID --text "Resposta""Sincroniza Tudo"
python C:\Users\renat\skills\instagram\scripts\run_all.py"Abre O Dashboard"
python C:\Users\renat\skills\instagram\scripts\serve_api.pyReferências
Consultar quando precisar de detalhes:
references/graph_api.md— Endpoints, parâmetros e responses da APIreferences/publishing_guide.md— Specs de mídia (dimensões, formatos, tamanhos)references/rate_limits.md— Rate limits detalhados e estratégiasreferences/account_types.md— Diferenças Business vs Creator, migraçãoreferences/permissions.md— Scopes OAuth necessários por featurereferences/setup_walkthrough.md— Guia passo-a-passo de setup do Meta Appreferences/schema.md— Schema do banco SQLite (ER diagram, campos, índices, queries)
Best Practices
- Provide clear, specific context about your project and requirements
- Review all suggestions before applying them to production code
- Combine with other complementary skills for comprehensive analysis
Common Pitfalls
- Using this skill for tasks outside its domain expertise
- Applying recommendations without understanding your specific context
- Not providing enough project context for accurate analysis
Related Skills
social-orchestrator- Complementary skill for enhanced analysistelegram- Complementary skill for enhanced analysiswhatsapp-cloud-api- Complementary skill for enhanced analysis
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.