Instagram Poster Skill
Automated Instagram posting via Meta Graph API.
Quick Start
bash
# Post with image python scripts/run.py --post "Caption here" --image "https://example.com/image.jpg" --hashtags "business,automation" # Get insights python scripts/run.py --insights --days 7 # Verify setup python scripts/verify.py
Setup
1. Requirements
- •Instagram Business Account (connected to Facebook Page)
- •Facebook Page with Admin access
2. Get Credentials
- •Go to Facebook Developers
- •Create an App
- •Add "Instagram" product
- •Generate access token with permissions:
- •
instagram_basic - •
instagram_content_publish - •
pages_read_engagement
- •
- •Get your Instagram Business Account ID
3. Configure Environment
Add to .env:
code
META_ACCESS_TOKEN=your_access_token_here INSTAGRAM_ACCOUNT_ID=your_instagram_account_id_here GRAPH_API_VERSION=v18.0
Features
Posting
- •Image posts with captions
- •Hashtag optimization (up to 30)
- •Approval workflow (default)
- •Rate limiting (25 posts/day, 5/hour)
Analytics
- •Engagement metrics
- •Reach and impressions
- •Follower growth
- •Best performing content
Hashtag Strategy
- •Instagram: Use 20-30 relevant hashtags
- •Mix of popular and niche tags
- •Industry-specific tags
- •Trending tags when relevant
Approval Workflow
Posts create files in Vault/Pending_Approval/:
- •Review caption and image
- •Edit hashtags as needed
- •Move to
Vault/Approved/to publish
Rate Limits
- •Daily: 25 posts
- •Hourly: 5 posts
Verification
Run: python scripts/verify.py
Expected: ✓ posting-instagram valid