\r \r

Facebook Page Publisher\r

\r Manage your Facebook Page directly from an AI agent. Create posts, upload photos, schedule content, view analytics, and moderate comments -- all through natural language.\r \r

Required Environment Variables\r

\r

• FB_PAGE_ID — The numeric ID of your Facebook Page\r
• FB_ACCESS_TOKEN — A long-lived (non-expiring) Facebook Page Access Token with permissions: pages_manage_posts, pages_read_engagement, pages_manage_engagement\r \r

create_post\r

Create and immediately publish a text post to the Facebook Page.\r

• message (string, required): The text content of the post.\r \r

upload_photo_post\r

Upload a photo to the Facebook Page with an optional caption. The photo must be a publicly accessible URL.\r

• photo_url (string, required): A publicly accessible URL to the image file (JPEG, PNG, etc.).\r
• caption (string, optional): Text caption for the photo post.\r \r

schedule_post\r

Schedule a text post for future publication. Time must be at least 10 minutes ahead and no more than 6 months.\r

• message (string, required): The text content of the post.\r
• scheduled_time (string, required): ISO 8601 datetime (e.g., "2026-03-10T09:00:00").\r \r

get_page_insights\r

Retrieve engagement metrics (impressions, reach, engagement, views) for the Facebook Page.\r

• metric (string, optional): One of "impressions", "reach", "engagement", "views", or "all". Default: "all".\r
• period (string, optional): Time period: "day", "week", or "days_28". Default: "day".\r \r

get_recent_posts\r

Fetch the most recent posts from the Page with engagement statistics (likes, comments, shares).\r

• limit (integer, optional): Number of posts to retrieve (1-100). Default: 10.\r \r

delete_post\r

Delete a specific post from the Facebook Page. This action is irreversible.\r

• post_id (string, required): The full post ID (format: pageId_postId).\r \r

get_post_comments\r

Retrieve comments on a specific post.\r

• post_id (string, required): The full post ID (format: pageId_postId).\r
• limit (integer, optional): Number of comments to retrieve (1-100). Default: 25.\r \r

reply_to_comment\r

Reply to a comment on a post as the Page.\r

• comment_id (string, required): The ID of the comment to reply to.\r
• message (string, required): The reply message text.\r \r

Example Usage\r

\r

User: Post "We're hiring! Check our careers page." to my Facebook page.\r
Agent: I'll publish that now using create_post.\r
\r
User: Schedule a post for tomorrow at 9 AM saying "Flash sale starts now!"\r
Agent: I'll schedule that using schedule_post with the computed datetime.\r
\r
User: Show me my page insights for the past week.\r
Agent: I'll fetch that using get_page_insights with period="week".\r
```\r
\r
## Setup\r
\r
1. Set `FB_PAGE_ID` to your Facebook Page's numeric ID.\r
2. Set `FB_ACCESS_TOKEN` to a non-expiring Page Access Token.\r
3. Run with `uv run src/server.py`.\r