Back to Skills
antigravityBusiness & Marketing

instagram

Integracao completa com Instagram via Graph API. Publicacao, analytics, comentarios, DMs, hashtags, agendamento, templates e gestao de contas Business/Creator.

Documentation

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

ÁreaScriptsO que faz
Setupaccount_setup.py, auth.pyConfigurar conta, OAuth, token
Publicaçãopublish.py, schedule.pyPublicar foto/vídeo/reel/story/carrossel, agendar
Comunidadecomments.py, messages.pyComentários, DMs, menções
Analyticsinsights.py, analyze.pyMétricas, melhores horários, top posts
Hashtagshashtags.pyPesquisa e tracking
Inteligênciatemplates.py, analyze.pyTemplates de conteúdo, tendências
Infraexport.py, serve_api.py, run_all.pyExportar, dashboard, sync
Leituraprofile.py, media.pyPerfil, 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

Use Cases

  • 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