# Social Instagram Report

> Instagram analytics report — queries profile stats, recent posts, engagement rates, insights for all connected accounts. Generates HTML report. Use when user says 'instagram report', 'instagram metrics', or any reference to Instagram performance analysis.

- Skill: `evolution-foundation/social-instagram-report` (Agent Skill)
- Install (CLI): `npx skillmds@latest add evolution-foundation/social-instagram-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/evolution-foundation/social-instagram-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: evolution-foundation (https://skillmd.com/u/evolution-foundation)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/evolution-foundation/social-instagram-report

---


# Instagram Report — Profile Analytics

Routine that pulls data from Instagram via `/int-instagram` and generates an HTML performance report.

**Always respond in English.**

## Workflow

### Step 1 — Collect data from all accounts

Para cada conta Instagram configurada:

```bash
python3 {project-root}/.claude/skills/int-instagram/scripts/instagram_client.py summary
python3 {project-root}/.claude/skills/int-instagram/scripts/instagram_client.py recent_posts [account] 20
python3 {project-root}/.claude/skills/int-instagram/scripts/instagram_client.py account_insights [account]
```

### Step 2 — Compare with previous period

Read previous report from `workspace/social/reports/instagram/` if it exists. Calculate deltas de seguidores, engagement, impressões.

### Step 3 — Analyze

Per account:
1. **KPIs:** followers, media count, average engagement rate
2. **Period posts:** published, likes, comments, engagement
3. **Top post:** best performance
4. **Content type:** Reels vs Image vs Carousel — which performs better
5. **Account insights:** impressions, reach, profile views (if available)

### Step 4 — Generate HTML

Use template `.claude/templates/html/custom/social-analytics-report.html` with `{{REPORT_TYPE}}` = "Instagram".

### Step 5 — Save

```
workspace/social/reports/instagram/[C] YYYY-MM-DD-instagram-report.html
```

### Step 6 — Telegram

Notify: followers per account + average engagement + best post

