Instagram Graph API toolkit

Overview

Community Python toolkit for profile/media reads, local SQLite analytics, exports and publication previews. The bundled integration uses Facebook Login, graph.facebook.com and a linked Facebook Page; it does not implement the separate Instagram Login flow. API v21.0, metrics, permissions, quotas and media specifications are historical examples: verify current Meta documentation for the selected account and API version before use.

When to Use

Use for an explicitly requested Instagram account workflow or inspection of these scripts. Prefer an available service connector for supported tasks. An Instagram mention alone does not authorize account changes, OAuth, uploads, publishing or messages.

Workflow

1. Read the relevant scripts and references. Use an isolated environment and review dependencies before installing scripts/requirements.txt. Commands below run from this skill directory.
2. For an authorized account connection, configure your own Meta app and the exact redirect URI, then run python3 scripts/auth.py --setup. This opens a browser and requests the listed OAuth scopes. The local database stores token and app secret in plaintext, protected by local permissions, outside the skill source (AAS_INSTAGRAM_DATA_DIR or the per-user application data directory in config.py). Do not commit or share this directory, its backups or exports.
3. Inspect python3 scripts/auth.py --status, then request only the reads needed. Read commands may attempt token renewal and persist fetched data. Token renewal can fail or require reauthorization; it is not guaranteed unattended. --revoke only deactivates the local account; revoke provider access through Meta separately.
4. Review output and partial failures. Sync reads one page per resource, not the entire account. Check current permissions, account ownership and retention policy before collecting comments or conversations.

Examples