Instagram Skill

Overview

Quick Install

curl -sSL https://canifi.com/skills/instagram/install.sh | bash

cp -r skills/instagram ~/.canifi/skills/

Setup

# First, ensure canifi-env is installed:
# curl -sSL https://canifi.com/install.sh | bash

canifi-env set INSTAGRAM_USERNAME "your-username"
canifi-env set INSTAGRAM_PASSWORD "your-password"

Privacy & Authentication

Option 1: Manual Browser Login (Recommended)

1. Complete the Browser Automation Setup using CDP mode
2. Login to the service manually in the Playwright-controlled Chrome window
3. Claude will use your authenticated session without ever seeing your password

Option 2: Environment Variables

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Capabilities

• Create and publish posts
• Upload and manage stories
• Like and comment on posts
• Follow/unfollow accounts
• Search users and hashtags
• View and respond to DMs (see instagram-dms)
• Access insights and analytics
• Save posts to collections

Usage Examples

Example 1: Create a Post

User: "Post this photo to Instagram with a caption about the sunset"
Claude: I'll create that Instagram post.
- Navigate to instagram.com
- Click create post
- Upload photo
- Write sunset caption with hashtags
- Publish post
- Confirm posted successfully

Example 2: Engage with Content

User: "Like the last 5 posts from @naturephotography"
Claude: I'll engage with those posts.
- Navigate to @naturephotography profile
- View recent posts
- Like last 5 posts
- Confirm engagement complete

Example 3: Check Insights

User: "Show me my Instagram insights for this week"
Claude: I'll pull your insights.
- Navigate to Insights section
- Gather this week's metrics
- Compile reach, engagement, followers
- Present analytics summary

Example 4: Search Hashtag

User: "Find top posts for #travelgram"
Claude: I'll search that hashtag.
- Navigate to hashtag search
- Search #travelgram
- Display top and recent posts
- Summarize engagement levels

Authentication Flow

1. Navigate to instagram.com via Playwright MCP
2. Enter username and password from canifi-env
3. Handle suspicious login verification (notify user)
4. Complete 2FA if enabled (notify user via iMessage)
5. Handle "Save Login Info" prompt
6. Verify feed access
7. Maintain session cookies

Error Handling

• Login Failed: Clear cookies, verify credentials
• Session Expired: Re-authenticate automatically
• 2FA Required: iMessage for verification code
• Suspicious Login: Notify user to verify via app
• Rate Limited: Wait and implement backoff
• Content Blocked: Check community guidelines
• Account Restricted: Notify user of temporary block
• Upload Failed: Check file format and size

Self-Improvement Instructions

1. Document new UI elements and flows
2. Add support for new content types
3. Log successful posting patterns
4. Update for reels and stories changes

Notes

• Instagram frequently updates UI
• Creator/Business accounts have more features
• Insights require Professional account
• Some features only available in mobile app
• Posting times affect engagement
• Hashtag limits: 30 per post
• Story content expires in 24 hours