phoroth 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: {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"
```bash
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.py
Referê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 enprojectnment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.