Claudegram

Claude + Instagram — your AI growth analyst.

Let Claude run your Instagram. Connect Instagram's Graph API to Claude and get a local analytics dashboard that reads every signal the 2026 algorithm actually ranks on — watch-time, skip-rate, sends/shares, saves, who you really reach — then have Claude tell you exactly what to post next. Free, open-source, runs on your machine. Your data never leaves your computer.

This is the open-sourced version of the dashboard I use to run @elijahaifl (≈100M views). Steal it.

What you get

• A local dashboard (dashboard.html) — KPI cards, post table sortable by any metric, category/format/time filters, best day+hour heatmap, the reach→profile→link funnel, follower growth, most-saved/most-shared, and a compare tab.
• Claude as your analyst — open the folder in Claude Code and ask "what should I post?" It reads your real numbers and gives you data-grounded next-post ideas in your voice. It will never post for you — drafts only.
• A sync engine (refresh.py) that pulls your posts + insights + ~30 days of account metrics and never forgets the daily history it has seen (Meta only serves ~30 days at a time).

Requirements

• Python 3.8+ (standard library only — nothing to pip install).
• An Instagram Business or Creator account linked to a Facebook Page.
• Claude Code — recommended (it does the setup for you). Not required; you can run the Python directly.

Quickstart (the easy way — let Claude do it)

1. Clone this repo and open the folder in Claude Code.
2. Say: "set me up."
3. Claude reads CLAUDE.md, runs the connect-instagram skill, and walks you through everything — making your account eligible, creating a Meta app, generating a long-lived token, finding your account id, and the first sync.
4. Open dashboard.html. Then ask Claude "what should I post this week?"

Quickstart (manual)

1. Eligibility: make your IG a Business/Creator account and link it to a Facebook Page you admin.
2. Token: create a Business app at developers.facebook.com, add the Instagram Graph API product, and in the Graph API Explorer generate a User token with instagram_basic, instagram_manage_insights, pages_show_list, pages_read_engagement. Exchange it for a long-lived token (full walkthrough in .claude/skills/connect-instagram/SKILL.md).
3. Set env vars (then open a new terminal):
   • Windows: setx INSTAGRAM_ACCESS_TOKEN "<token>"
   • macOS/Linux: export INSTAGRAM_ACCESS_TOKEN="<token>"
4. Find your account id: python setup.py → set INSTAGRAM_ACCOUNT_ID the same way.
5. Sync + open: python refresh.py, then open dashboard.html (or run open-dashboard.bat / sh open-dashboard.sh).

Keeping it fresh

Run python refresh.py before you post, or schedule it daily (Windows Task Scheduler / cron) so your long-term daily history keeps building. Long-lived tokens last ~60 days; the dashboard warns you before yours expires — just re-run the token steps.

Customizing

• Post categories: edit the CATEGORIES keyword rules at the top of refresh.py to match your niche.
• How many posts to track / re-fetch window: POST_LIMIT and REFETCH_DAYS in refresh.py.

Privacy

Everything runs locally. Your analytics live in data/ (gitignored) and your token lives only in environment variables — never written into this repo. It only reads your account; it cannot post.

License

MIT — do whatever you want with it.