---

name: instagram

description: Instagram platform integration. Post content, manage stories, view insights, and engage with followers.

metadata: {"clawdbot":{"emoji":"📸","always":true,"requires":{"bins":["curl","jq"]},"primaryEnv":"INSTAGRAM_ACCESS_TOKEN"}}

---

Instagram 📸

Instagram platform integration for posting, stories, insights, and engagement.

When to Use ✅

• User wants to post content to Instagram
• User asks for Instagram insights or analytics
• User wants to manage Instagram stories
• User asks about Instagram comments or engagement
• User says "use instagram skill"

When NOT to Use ❌

• Posting to Twitter/X → Use bird skill instead
• Posting to LinkedIn → Use LinkedIn API directly
• General social media strategy → This is execution only, not strategy
• Creating content/images → Use image generation first, then this for posting
• Facebook posting → Different platform, different API

Edge Cases

• "Post to social media" → Ask: Which platform? Instagram, Twitter, LinkedIn?
• "Show my analytics" → Ask: For which platform? Instagram = yes
• "Create an Instagram post" → If they mean create content, generate it first, then use this to post

Setup

export INSTAGRAM_ACCESS_TOKEN="your_access_token"

Capabilities

• Post photos/videos to feed
• Publish stories
• View account insights and analytics
• Manage comments (view, respond, delete)
• Follower analytics
• Hashtag research

Workflow

Post Content

1. Ensure image/video URL is publicly accessible
2. Create media container with caption
3. Publish the container
4. Verify post is live

View Insights

1. Query insights endpoint
2. Parse metrics (reach, impressions, engagement)
3. Format for display

Success Criteria

• Content posted successfully
• Insights retrieved and formatted
• Comments managed without errors