Instagram Poster Skill

Automated Instagram posting via Meta Graph API.

Quick Start

# 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

1. Go to Facebook Developers
2. Create an App
3. Add "Instagram" product
4. Generate access token with permissions:
   • instagram_basic
   • instagram_content_publish
   • pages_read_engagement
5. Get your Instagram Business Account ID

3. Configure Environment

Add to .env:

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

References

• Instagram Graph API
• Content Publishing