majiayu000 Facebook Poster Skill
Automated Facebook posting via Meta Graph API.
Quick Start
# 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_postspages_read_engagement
- Get your Facebook Page ID
2. Configure Environment
Add to .env:
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