How do I install the Instagram skill?

Run npx skillmds@latest add anhvu1107/instagram in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Instagram skill do?

ALWAYS use this when the request matches Instagram: Integracao completa com Instagram via Graph API. It is listed under AI & ML on SkillMD.

Is Instagram safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Instagram?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Instagram free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Instagram?

anhvu1107 (@anhvu1107) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Instagram by anhvu1107 — Agent Skill

Name: Instagram
Author: anhvu1107

Skill: Instagram Integration

Selective Reading Rule

Start with:

references/usage-routing.md
references/quality-checklist.md

Then load only the inherited docs, scripts, assets, or examples that match the user's actual task.

Selective Reading Rule

Start with:

references/senior-master-standard.md

Then load only the references, scripts, assets, or examples needed for the user's actual task.

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

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 API
references/publishing_guide.md — Specs de mídia (dimensões, formatos, tamanhos)
references/rate_limits.md — Rate limits detalhados e estratégias
references/account_types.md — Diferenças Business vs Creator, migração
references/permissions.md — Scopes OAuth necessários por feature
references/setup_walkthrough.md — Guia passo-a-passo de setup do Meta App
references/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 analysis
telegram - Complementary skill for enhanced analysis
whatsapp-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.

Instagram

File contents

Skill: Instagram Integration

Selective Reading Rule

Selective Reading Rule

Overview

When to Use This Skill

Do Not Use This Skill When

How It Works

Resumo Rápido

Localização

Configuração Inicial

Foto (Aceita Arquivo Local — Faz Upload Automático Via Imgur)

Vídeo

Reel

Story

Carrossel (2-10 Imagens)

Criar Como Rascunho (Não Publica Imediatamente)

Aprovar Rascunho Para Publicação

Listar Comentários De Um Post

Responder A Um Comentário

Deletar Comentário

Ver Menções

Comentários Não Respondidos

Métricas De Um Post Específico

Métricas Da Conta (Últimos 7 Dias)

Buscar E Salvar Insights De Todos Os Posts Recentes

Buscar Posts Recentes Com Uma Hashtag

Top Posts De Uma Hashtag

Info Da Hashtag (Contagem De Posts)

Ver Perfil

Listar Posts Recentes

Detalhes De Um Post

Status Da Autenticação

Sync Completo (Busca Perfil + Mídia + Insights + Comentários)

Sync Parcial

"Me Mostra Meus Analytics"

"Qual O Melhor Horário Para Postar?"

"Responde Esse Comentário"

"Sincroniza Tudo"

"Abre O Dashboard"

Referências

Best Practices

Common Pitfalls

Related Skills

Limitations

Related skills

Frequently asked questions

How do I install the Instagram skill?

What does the Instagram skill do?

Is Instagram safe to use?

Which AI agents work with Instagram?

Is Instagram free to use?

Who published Instagram?