clinstagram

What This Skill Does

Clinstagram is a powerful, hybrid Instagram command-line interface designed for integration into AI agent workflows. It provides a bridge between the official Meta Graph API and the private instagrapi API, allowing agents to perform tasks ranging from simple analytics gathering to complex social media management. The skill features three distinct compliance modes—official-only, hybrid-safe, and private-enabled—allowing users to balance the safety and stability of official API usage against the deep-access features of private automation. It supports a comprehensive feature set including posting photos, videos, and reels, managing DMs, tracking stories, analyzing performance metrics, and handling interactions like liking and commenting.

Installation

You can install the clinstagram skill by running the following command in your terminal:

pip install clinstagram

After installation, ensure you connect your accounts using clinstagram auth connect-ig or clinstagram auth connect-fb for official access, or clinstagram auth login for private API access. Always verify your session status first with clinstagram --json auth status.

Use Cases

1. Automated Content Distribution: Agents can monitor a local directory for media assets and automatically push them to an Instagram business account as reels or carousel posts.
2. Customer Engagement: The skill allows for programmatic management of DMs and comments, enabling agents to respond to customer queries or moderate spam based on sentiment analysis.
3. Market Research: Businesses can use the agent to pull hashtag analytics, track competitor post performance, and maintain a history of audience engagement data in JSON format.
4. Account Growth: By utilizing the --enable-growth-actions flag, agents can automate follower management and interaction loops according to specified business logic.

Example Prompts

1. "Check my Instagram status and list the most recent comments on my latest post."
2. "Search for the hashtag #AIArt, find the top post, and share it to my stories."
3. "Analyze the engagement metrics for my last five posts and suggest the best time to upload a new reel."

Tips & Limitations

• Compliance First: Always use clinstagram config mode official-only or hybrid-safe when working with business accounts to prevent shadowbans or policy violations. Private-enabled mode should be treated as high-risk.
• Global Flags: Remember that global flags like --json or --account must be placed immediately after the clinstagram command and before the subcommand due to internal parser limitations.
• Error Handling: Always programmatically check the exit_code returned in the JSON output. If code 2 appears, your session has expired and needs re-authentication. If code 3 appears, implement a backoff timer based on the retry_after field.