Automate Instagram Content Management

Instagram integration gives full control of an Instagram Business or Creator account through the Graph API: publishing, community management, analytics, hashtag research, and a local dashboard, all governed by rate limits, an audit log, and confirmation prompts before any action that touches public content. Setup scripts detect the connected account type, walk through OAuth authorization in a browser, and verify the connection via a profile check; if the account is personal, the setup script provides migration guidance to a Business or Creator account, which the Graph API requires for posting. Publishing covers photos (with automatic local-file upload via Imgur), videos, reels, stories, and 2-to-10-image carousels, plus a draft mode that holds a post for later approval and a scheduler that queues, lists, processes, or cancels future publications. Community tools list, reply to, or delete comments, surface mentions and unreplied comments, and send or read direct messages by conversation thread. Analytics fetch per-post and account-level metrics (including a rolling 7-day window), bulk-fetch insights across recent posts, and compute best posting times, top posts by engagement, and 30-day growth trends. Hashtag tools search recent posts by tag, surface a hashtag's top posts, and report a hashtag's post count. A template system stores reusable captions and hashtag sets with variable placeholders filled in at publish time, and everything can be exported to CSV or JSON or viewed through a FastAPI-served dashboard. The skill tracks Instagram's own rate limits automatically - 200 requests per hour, 25 publications per day, 30 unique hashtags per week, and 200 DMs per hour per account - warning at 90% of a limit and blocking the action with a wait-time estimate once it is exceeded. Every action that touches public content (publishing, deleting a comment, sending a DM, replying to or hiding a comment) returns its details and requires explicit confirmation before it executes, and every data-modifying action is written to a SQLite audit log with a timestamp, the action, its parameters, the result, and its confirmation status. The 60-day OAuth token refreshes automatically once it is within 7 days of expiring, with no manual step required.

Use it whenever the user mentions Instagram, IG, posting or publishing to Instagram, or Instagram reels or stories. Do not use it for tasks unrelated to Instagram, when a simpler and more specific tool already covers the request, or when the user just needs general-purpose assistance with no Instagram-specific expertise required. It also cannot perform actions the Graph API itself does not support: deleting already-published posts, editing captions after publishing, applying filters through the API, posting from a personal (non-Business/Creator) account, sending DMs outside the 24-hour window unless the user messaged first, or publishing photos in a format other than JPEG (the scripts auto-convert other formats).

Setup requires installing the script dependencies once, then completing OAuth authorization through a browser flow.

pip install -r C:\Users\renat\skills\instagram\scripts\requirements.txt

From there, inputs are per-action parameters - an image or video file and caption for publishing, a media or comment ID for community actions, a date and time for scheduling, or a hashtag string for research - and outputs are the resulting post, comment, message, metrics, or exported CSV/JSON file, plus the dashboard view at the local server's dashboard route.

Teams and creators running an Instagram Business or Creator account who want publishing, scheduling, comment and DM management, analytics, and hashtag research handled from one governed workflow instead of the native Instagram app, with automatic rate-limit tracking and an audit trail for every public action.