posting-facebook

name	posting-facebook
description	Post content to Facebook using Meta Graph API. Use when publishing Facebook posts, configuring posting schedule, managing post queue, or getting engagement insights. NOT when posting to Instagram (use posting-instagram instead).

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

1. Go to Facebook Developers
2. Create an App
3. Add "Pages" product
4. Generate access token with permissions:
   • pages_manage_posts
   • pages_read_engagement
5. 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

References

• Meta Graph API Docs
• Pages API