Skip to content

proyecto26/instagram-ai-plugin

v0.1.0MIT

Drive your own Instagram account from the terminal with your browser session (no Graph API app, no Apify): sign in with cookies; read profiles, posts, comments and hashtags; publish photos, carousels, reels and stories, and comment and reply, as approved dry runs; and run content, audit, competitor research and ads workflows on real account data.

instagram

Drives the user's own Instagram account from the terminal through the same private endpoints instagram.com's web client uses, authenticated with the user's browser session cookies (no Graph API app, no Apify). Signs in via Chrome or imported cookies, reads profiles, posts, reels, comments, hashtags and search, computes account metrics, and publishes photos, carousels, reels and stories, edits captions and replies to comments (it never deletes), always as a dry run until the user approves. This skill should be used when the user says "post this to Instagram", "upload a reel", "publish a carousel", "log in to Instagram", "import my Instagram cookies", "post a story", "edit the caption on", "am I logged in to Instagram", "show my recent posts", "get stats for this post", "get this profile's posts", "reply to that comment", or mentions an instagram.com URL, even without saying "Instagram skill".

instagram-ads

Plans and evaluates paid campaigns that run on Instagram (Meta Ads with Instagram feed, Stories and Reels placements). It picks which organic posts to promote using real performance pulled through the user's web session, writes ad copy and creative briefs, sets up Andromeda-era campaign structure, and makes kill, keep and scale decisions from numbers the user pastes. This skill should be used when the user asks to "run Instagram ads", "boost this post", "which post should I promote", "write Instagram ad copy", "set up a Meta campaign for Instagram", "is my Instagram ad working", "when should I kill this ad", "creative testing for Reels ads", or mentions ROAS, CPA, CPM or partnership ads on Instagram.

instagram-audit

Audits an Instagram account from real data pulled with the user's own web session (no Apify, no Graph API app), covering profile conversion, format mix, cadence, best days and hours, caption length, hashtags, and outlier versus underperforming posts, with an honest note on what only Insights can show. This skill should be used when the user asks to "audit my Instagram", "why is my reach down", "which formats work best on my account", "best time to post", "which posts performed best", "review my Instagram profile", "score my bio", "analyze @someaccount", or "what's working on my Instagram", and whenever the user shares output from the plugin's audit command (saved audit JSON, "I already ran the audit") and wants it interpreted, even if they ask only "what should I post more of".

instagram-content

Plans and writes Instagram content (Reels scripts and hooks, carousels slide by slide, captions, Stories sequences, content pillars, weekly calendars, repurposing long-form into posts), lints it with bundled offline scorers, and hands approved posts to the instagram skill for publishing. This skill should be used when the user asks to "write a caption", "script a reel", "give me reel hooks", "make a carousel about", "plan my Instagram week", "content calendar for Instagram", "turn this blog post into Instagram posts", "give me post ideas", "what should I post this week", "make this sound less AI", or wants Instagram copy reviewed before posting.

instagram-research

Researches other Instagram accounts and hashtags through the user's own web session (no Apify) to build a swipe file of outlier posts (posts beating their own account's median by 3x or more), extract the hook formulas and formats behind them, and turn that into content ideas. This skill should be used when the user asks to "research competitors on Instagram", "what's working in my niche", "find viral reels about X", "build a swipe file", "reverse engineer this account", "analyze these creators", "check the