Facebook Poster Skill
Automated Facebook posting via Meta Graph API.
Quick Start
bash
# Post content (requires approval) python scripts/run.py --post "Your post content here" # Post with link python scripts/run.py --post "Check this out!" --link "https://example.com" # Get insights python scripts/run.py --insights --days 7 # Verify setup python scripts/verify.py
Setup
1. Get Meta Access Token
- •Go to Facebook Developers
- •Create an App
- •Add "Pages" product
- •Generate access token with permissions:
- •
pages_manage_posts - •
pages_read_engagement
- •
- •Get your Facebook Page ID
2. Configure Environment
Add to .env:
code
META_ACCESS_TOKEN=your_access_token_here FACEBOOK_PAGE_ID=your_page_id_here GRAPH_API_VERSION=v18.0
Features
Posting
- •Text posts with optional links
- •Approval workflow (default)
- •Rate limiting (25 posts/day, 5/hour)
- •Audit logging
Analytics
- •Page impressions
- •Engagement metrics
- •Fan growth
- •Post performance
Approval Workflow
Posts create files in Vault/Pending_Approval/:
- •Review and edit content
- •Move to
Vault/Approved/to publish - •Or delete to reject
Rate Limits
- •Daily: 25 posts
- •Hourly: 5 posts
Enforced automatically by MCP server.
Verification
Run: python scripts/verify.py
Expected: ✓ posting-facebook valid