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