connect-instagram-developer-platform
Give the user's agents full control of their Instagram (DMs, comments, posts, stats, publishing) through a small CLI that talks to Meta's official Instagram API with the user's own Meta app: no third-party service, no monthly fee. Do every step yourself in Chrome AI with the dev-browser skill; the user only signs in, confirms their phone if Meta asks, and clicks "Allow". Talk to the user in their language, short messages, no jargon (never say "token", "OAuth", "scope" or "Graph API" to them; say "Instagram access" and "the key").
If you got this skill from a link instead of a local folder, install nothing else from the repo: download scripts/instagram.py with curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/connect-instagram-developer-platform/scripts/instagram.py -o <scratch>/instagram.py, and read another skill it names only when you reach it, from https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/<skill-name>/SKILL.md.
Never print, log or repeat the app secret, the access or what instagram.py keeps in ~/.config/instagram-cli/config.json. Browser scripts that read them write them straight to ~/.dev-browser/tmp/instagram-keys.json with writeFile and log only { saved: true }. Ask the user before you accept Meta's developer terms (step 3). Read each page with snapshotForAI() before clicking: Meta's dashboard speaks the user's language and moves its buttons often, so look for the meaning, not the exact words below.
-
Check the tools.
chrome-ai startanddev-browser --helpmust answer (otherwise runsetup-dev-browser), andpython3 --versionmust be 3.9 or newer. If~/.agents/skills/instagram-cli/already exists, runpython3 ~/.agents/skills/instagram-cli/scripts/instagram.py me: if it answers, tell the user Instagram is already connected and skip to step 10. -
Check the Instagram account, in a page named
connect-instagram. Openhttps://www.instagram.com/accounts/edit/: if Chrome AI is not signed in, ask the user to sign in there with the account to connect and say "done". The account must be professional (Creator or Business): Meta's API refuses personal accounts. Openhttps://www.instagram.com/accounts/convert_to_professional_account/(or Settings > Account type and tools): if it offers to switch, tell the user in one line it is free, changes nothing for their followers, and ask them to pick Creator (or Business) there. Note the @username. -
Become a Meta developer. Open
https://www.facebook.com: Meta developer accounts live on a Facebook account, so ask the user to sign in there if needed (the Facebook account they use for their Instagram, if they have one). Then openhttps://developers.facebook.com/async/registration/. If it shows the dashboard or "My Apps", they are already registered. Otherwise go through it: ask the user before you accept the terms, let them confirm their phone number or email with the code Meta sends (they type it), pick "Developer" as their role. -
Create the app: open
https://developers.facebook.com/apps/creation/. App name:<FirstName> Agentor anything short without "Instagram", "Insta", "IG", "Meta" or "Facebook" (Meta refuses those). Contact email: the account's. Use case: Manage messaging & content on Instagram (wording may vary: the one about Instagram messages and content). Business portfolio: "I don't want to connect a business portfolio yet". Create; Meta may ask for the Facebook password again: ask the user to type it. Read the app ID from the address (/apps/<app_id>/). -
Add the access: in the app, open the Instagram use case (left menu "Use cases" > Customize, or
https://developers.facebook.com/apps/<app_id>/use_cases/), go to API setup with Instagram login. In "Permissions" make sure these are added:instagram_business_basic,instagram_business_manage_messages,instagram_business_manage_comments,instagram_business_content_publish,instagram_business_manage_insights. Standard access is enough: the app only acts on the user's own account, so no Meta review. -
Link the Instagram account: in the same page, section "Generate access tokens", click Add account. A window opens on Instagram's sign-in: tell the user right away, in 3 short lines: in the Chrome AI window, sign in to
@<username>if asked; click Allow (or "Continue as ..."); come back and say "done". If Meta answers "Insufficient developer role", openhttps://developers.facebook.com/apps/<app_id>/roles/roles/, add the @username as Instagram Tester, then openhttps://www.instagram.com/accounts/manage_access/> Tester invites > Accept, and click Add account again. -
Read the keys. Back on "API setup with Instagram login", next to the linked account click Generate token; a dialog shows it after a "I understand" box (tick it). In section "Set up Instagram business login" (or "Business login settings"), read the Instagram app ID and the Instagram app secret (click Show; Meta may ask the Facebook password: ask the user). These are not the Facebook app ID and secret of App settings > Basic. In one browser script, save the three without logging them:
await writeFile("instagram-keys.json", JSON.stringify({ app_id, app_secret, access_token })); console.log(JSON.stringify({ saved: true, app_id }));