From hive
Manage Instagram Business account - publish posts/reels/stories/carousels, view insights, manage comments, search hashtags. Use when user needs to post content, check performance, or moderate comments on Instagram.
npx claudepluginhub skywalking-dev/hiveThis skill is limited to using the following tools:
Manage Instagram Business account via Python CLI.
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Manage Instagram Business account via Python CLI.
INSTAGRAM_TOKEN in .env (Meta access token with instagram_basic, instagram_content_publish, instagram_manage_comments, instagram_manage_insights)INSTAGRAM_ACCOUNT_ID in .env (Instagram Business account ID from Graph API)# Profile info
python scripts/instagram_handler.py profile
# List recent posts
python scripts/instagram_handler.py media
python scripts/instagram_handler.py media --limit 10
# Get post details
python scripts/instagram_handler.py media-get 17895695123456789
# Publish photo
python scripts/instagram_handler.py publish-photo "https://example.com/image.jpg" --caption "New post!"
# Publish Reel
python scripts/instagram_handler.py publish-video "https://example.com/video.mp4" --caption "Check this out"
# Publish carousel
python scripts/instagram_handler.py publish-carousel '[{"type":"IMAGE","url":"https://..."},{"type":"IMAGE","url":"https://..."}]' --caption "Swipe!"
# Stories
python scripts/instagram_handler.py stories
python scripts/instagram_handler.py publish-story --image-url "https://example.com/story.jpg"
# Comments
python scripts/instagram_handler.py comments 17895695123456789
python scripts/instagram_handler.py comment-reply 17895695123456789 "Thanks!"
python scripts/instagram_handler.py comment-hide 17895695123456789
# Insights
python scripts/instagram_handler.py insights
python scripts/instagram_handler.py insights --period week
python scripts/instagram_handler.py media-insights 17895695123456789
# Hashtags
python scripts/instagram_handler.py hashtag-search "marketing"
python scripts/instagram_handler.py hashtag-top 17843853986123456
# Mentions
python scripts/instagram_handler.py mentions
All publishing is 2-step (container → publish):
Videos poll for processing up to 60s. If timeout, publish manually from Meta Business Suite.
| Type | Format | Max Size | Aspect Ratio |
|---|---|---|---|
| Photo | JPEG, PNG | 8MB | 1:1, 4:5, 1.91:1 |
| Reel | MP4, MOV | 1GB | 9:16 (vertical) |
| Story | JPEG/MP4 | 8MB/100MB | 9:16 |
| Carousel | Mix | Per item | Per item |
day, week, days_28, month, lifetime
impressions, reach, follower_count, profile_views, website_clicks, email_contacts
impressions, reach, engagement, saved, shares, video_views (for Reels)
{
"success": true,
"data": { ... }
}
| Error | Cause | Fix |
|---|---|---|
190 | Invalid/expired token | Refresh INSTAGRAM_TOKEN |
9004 | Image URL not accessible | Ensure public URL, no auth required |
36003 | Video processing failed | Check format/size, retry |
10 | Permission denied | Check token scopes |
4 | Rate limit | Wait and retry (200 calls/user/hour) |