← Back to Skills Marketplace
snoopyrain

Facebook Publisher

by snoopyrain · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
213
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install facebook-publisher
Description
Publish posts to Facebook Pages. Use when the user says 'post to Facebook', 'publish on FB', 'schedule Facebook post', 'manage Facebook scheduled posts', or...
README (SKILL.md)

Boring Facebook Publisher

Publish and schedule posts to Facebook Pages. Powered by Boring.

Security & Data Handling

  • MCP link is a credential: Your MCP Server URL (https://boring.aiagent-me.com/mcp/t/xxxxx...) contains an embedded authentication token. Treat it like a password — do not share it publicly.
  • Token scope: The embedded token grants publish access to your connected social media accounts. It can create posts, upload media, and manage scheduled posts on the platforms you have connected. It cannot access your social media passwords or modify account settings.
  • Token storage: The token is stored server-side in Boring's database (MongoDB on DigitalOcean). It is never written to your local filesystem. You can regenerate or revoke it anytime at boring.aiagent-me.com/settings.
  • Data flow: Analytics queries are sent from Boring's server (Google Cloud, us-central1) to the platform's API on your behalf. Only performance metrics are retrieved — no content is uploaded or modified.
  • No local credentials: No local API keys, environment variables, or secrets are needed. All auth is embedded in the MCP link.
  • Third-party service: This skill relies on Boring, an open-source social media management tool. Source code: github.com/snoopyrain.

Prerequisites

  1. Sign up at 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: "\x3Cfacebook_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

Usage Guidance
This skill delegates Facebook publishing to a third‑party service (boring.aiagent-me.com) via an MCP link that contains an embedded auth token. Before installing: (1) Verify you trust boring.aiagent-me.com and inspect the linked open‑source repo if possible; confirm the MCP link domain is correct and not a phishing variant. (2) Treat the MCP link like a password — do not paste it in public chat or share it. (3) Be aware the token can publish and upload media to your Pages; provide it only for Pages you control and be prepared to revoke it if you see unexpected activity. (4) Understand that using local files or Google Drive links will transmit that content to the Boring service; avoid sending sensitive files. (5) If you need stronger assurance, test on a throwaway Page/account and verify the connector's privacy/security documentation and ability to revoke tokens. If you want, I can suggest checks to validate the Boring service's code and hosting before you proceed.
Capability Analysis
Type: OpenClaw Skill Name: facebook-publisher Version: 1.0.1 The skill is a legitimate integration for the 'Boring' social media management platform (boring.aiagent-me.com), designed to publish and schedule Facebook posts. It operates by instructing the agent to use specific MCP tools (e.g., boring_publish_post, boring_list_accounts) provided by an external MCP server. The documentation is transparent about security, explaining that authentication is handled via an embedded token in the MCP URL and that data is stored on the service's backend. No evidence of malicious intent, prompt injection, or unauthorized data access was found in SKILL.md or _meta.json.
Capability Assessment
Purpose & Capability
The skill is an instruction-only bridge to the Boring (boring.aiagent-me.com) MCP connector for publishing to Facebook Pages. Requesting an MCP connector link (which embeds an auth token for the third‑party service) is coherent with the stated purpose of creating and scheduling page posts.
Instruction Scope
The SKILL.md explicitly instructs the agent to call functions like boring_list_accounts, boring_upload_file (with local file_path), boring_upload_from_url, and boring_publish_post. Asking to upload local files is reasonable for media posting, but the skill metadata does not explicitly declare local file access; users should expect the agent to read user-provided local files and to send them to the third‑party service. The doc also accepts Google Drive links and remote URLs as media sources; those could expose content to Boring when used.
Install Mechanism
No installation or third‑party downloads are required—this is an instruction-only skill. Nothing is written to disk by the skill itself (per manifest).
Credentials
No local environment variables or platform credentials are requested; instead the skill requires an MCP Connector link that contains an embedded auth token. That token grants publish rights to connected social accounts (a powerful capability) which is proportionate to publishing functionality but should be treated like a password and only supplied to services you trust.
Persistence & Privilege
always:false (not force‑included). The skill does not request persistent system privileges or claim to modify other skills or agent settings. Autonomous invocation is allowed (platform default) but not a unique escalation here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install facebook-publisher
  3. After installation, invoke the skill by name or use /facebook-publisher
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Add detailed Security & Data Handling
v1.0.0
- Initial release of facebook-publisher skill. - Publish and schedule text, photo, album, or video posts to Facebook Pages. - Manage Facebook scheduled posts: list, schedule, cancel, and confirm posts. - No local credentials required; uses MCP Connector link for authentication. - Supports media uploads (photos, videos) and provides error handling guidance. - See full workflow and usage instructions in documentation.
Metadata
Slug facebook-publisher
Version 1.0.1
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 2
Frequently Asked Questions

What is Facebook Publisher?

Publish posts to Facebook Pages. Use when the user says 'post to Facebook', 'publish on FB', 'schedule Facebook post', 'manage Facebook scheduled posts', or... It is an AI Agent Skill for Claude Code / OpenClaw, with 213 downloads so far.

How do I install Facebook Publisher?

Run "/install facebook-publisher" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Facebook Publisher free?

Yes, Facebook Publisher is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Facebook Publisher support?

Facebook Publisher is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Facebook Publisher?

It is built and maintained by snoopyrain (@snoopyrain); the current version is v1.0.1.

💬 Comments