boring-facebook-publisher

# Boring Facebook Publisher Publish and schedule posts to Facebook Pages. Powered by [Boring](https://boring-doc.aiagent-me.com). ## Security & Data Handling - **MCP link is a credential**: Your MCP Server URL contains an embedded authentication token. Treat it like a password — do not share it publicly. Regenerate anytime in Settings. - **Media uploads**: Local files or URLs are uploaded to Boring's Google Cloud Storage to make them accessible for publishing. Social media APIs require publicly accessible media URLs. - **Data flow**: Your content and media are sent from Boring's server to Facebook's API on your behalf via your connected OAuth token. - **No local credentials**: No local API keys or environment variables needed. All auth is embedded in the MCP link. ## Prerequisites 1. **Sign up** at [boring.aiagent-me.com](https://boring.aiagent-me.com) with Google 2. **Connect Facebook** — requires admin access to a Facebook Page 3. **Get your MCP link**: Go to **Settings** → copy your MCP Server URL (contains your auth token — treat it like a password) 4. **Add to Claude**: Paste the MCP link as a Connector — no install, no API key needed ## Workflow ### Step 1: List Facebook Accounts Call `boring_list_accounts` and filter for `facebook` platform accounts. Show the user their connected Pages. ### Step 2: Confirm Content Ask the user what to post. Facebook supports: | Type | Description | Media | |------|-------------|-------| | Text | Caption-only post | None | | Photo | Single image post | 1 image (JPG/PNG, max 4MB) | | Album | Multi-image post | 2-10 images | | Video | Video post | 1 video (MP4/MOV, max 1GB, max 240 min) | ### Step 3: Prepare Media If the user provides media: - **Local file**: `boring_upload_file` with `file_path` - **URL**: `boring_upload_from_url` with the URL - **Google Drive link**: Pass directly to `media_urls` ### Step 4: Publish or Schedule Call `boring_publish_post` with: ``` account_id: "<facebook_account_id>" platform: "facebook" text: "Your post content here" media_urls: ["https://...image.jpg"] (optional) scheduled_at: "2025-12-25T10:00:00Z" (optional, for scheduling) ``` **For immediate publish**: omit `scheduled_at` **For scheduling**: include `scheduled_at` in ISO 8601 format ### Step 5: Report Show the user: - Post ID and success confirmation - If scheduled: the scheduled time and post ID ## Managing Scheduled Posts - **View scheduled**: `boring_list_scheduled_posts` with `platform: "facebook"` - **Cancel**: `boring_cancel_scheduled_post` with the `scheduled_post_id` ## Facebook-Specific Notes - **Token**: Facebook Page tokens never expire — no re-authentication needed - **Data Access**: Valid for 90 days (auto-managed by Boring) - **Rate Limit**: 200 API calls/hour per Page - **Permissions**: `pages_manage_posts`, `pages_read_engagement` - **Aspect Ratio**: 16:9 or 9:16 recommended for videos ## Error Handling | Error | Solution | |-------|----------| | `InvalidApiKey` | MCP link may be invalid — regenerate it at boring.aiagent-me.com Settings | | `InvalidAccountId` | Run `boring_list_accounts` to get valid account IDs | | `MediaTooLarge` | Images max 4MB, videos max 1GB | | `PublishingFailed` | Check if Page permissions are correct at boring.aiagent-me.com | | `RateLimitExceeded` | Wait and retry — 200 calls/hour limit | ## Examples **Text post**: ``` boring_publish_post(account_id="abc", platform="facebook", text="Hello from Boring!") ``` **Photo post**: ``` boring_publish_post(account_id="abc", platform="facebook", text="Check this out!", media_urls=["https://example.com/photo.jpg"]) ``` **Schedule for tomorrow 9 AM UTC**: ``` boring_publish_post(account_id="abc", platform="facebook", text="Scheduled post!", scheduled_at="2025-12-26T09:00:00Z") ``` ## Documentation Full API docs: [boring-doc.aiagent-me.com](https://boring-doc.aiagent-me.com)