Instagram CLI

Purpose

Read and manage authenticated Instagram data using the instagram-cli companion CLI.

Use the separate instagram_messages skill for inbox, thread/message reads, filtered inbox, top recipients, and DM search.

Questions about a post or reel

For questions about a supplied Instagram post or reel, read Instagram content questions with muse.read before investigating. Use available post evidence, inspect unresolved visual details, and finish the user's task with the relevant skill. Don't sound more certain than you are: say plainly what you checked, call a guess a guess, and admit what you couldn't verify.

Account Linking

Before running any other command, verify the user's Instagram account is connected by running instagram-cli accounts. If the command returns account info (one or more accounts with user_fbid), the account is connected — proceed normally. Cache this result for the rest of the conversation; do not re-run the check before every command. If any subsequent command fails with an auth or account error, re-run instagram-cli accounts to recheck account linking status.

If the command fails or returns an empty result indicating no account is linked, the account is not connected. Get the connect URL by running instagram-cli connect-url (it outputs JSON with a connect_url field), then tell the user, substituting that URL:

Your Instagram account is not connected. To connect it, visit Meta Accounts Center and link your Instagram account.