← Back to Skills Marketplace
snoopyrain

Boring Facebook Publisher

by snoopyrain · GitHub ↗ · v1.0.4 · MIT-0
cross-platform ✓ Security Clean
141
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install boring-facebook-publisher
Description
Publish posts to Facebook Pages using Boring. Use when the user says 'post to Facebook', 'publish on FB', 'schedule Facebook post', 'manage Facebook schedule...
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 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 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 appears to do what it says: it posts to Facebook Pages via the Boring service. Before installing: (1) Understand that your 'MCP Connector' URL contains an embedded auth token and grants Boring access to act on your Pages — do not paste it in public channels. (2) Media files you provide (local or URLs) will be uploaded to Boring's Google Cloud Storage and transmitted to Facebook; avoid uploading highly sensitive files. (3) Verify the Boring service (boring.aiagent-me.com) and its privacy/security policies and consider using a page/account with limited permissions for initial testing. (4) Note the registry metadata mismatch (it lists no primary credential while the SKILL.md requires the MCP link) — ask the publisher to clarify how the connector is supplied/stored if you need stronger assurance. If you are uncomfortable with third-party hosting of media or with handing an embedded token to a connector, do not install or use this skill.
Capability Analysis
Type: OpenClaw Skill Name: boring-facebook-publisher Version: 1.0.4 The skill bundle provides instructions for an AI agent to interact with the 'Boring' MCP service (boring.aiagent-me.com) to manage Facebook Page posts. The workflow involves listing accounts, uploading media to the service's Google Cloud Storage, and calling publishing functions, all of which are consistent with the stated purpose of social media management. No evidence of malicious intent, prompt injection, or unauthorized data exfiltration was found.
Capability Assessment
Purpose & Capability
The skill's stated purpose (publish/schedule Facebook Page posts) matches the runtime instructions (list accounts, upload media, publish/schedule). However, registry metadata lists no primary credential while the SKILL.md requires an MCP Connector link (a URL that embeds an auth token); this is a metadata inconsistency but not a functional mismatch — the MCP link is the actual credential the skill needs.
Instruction Scope
Instructions are scoped to posting workflows (list accounts, prepare media, publish/schedule, manage scheduled posts). They explicitly require uploading local files or remote URLs to Boring's Google Cloud Storage so media is publicly accessible for Facebook — this is expected for a publishing service but is a privacy/data-flow concern because local files are transmitted off your device to a third party.
Install Mechanism
No install spec or code files are included (instruction-only). This minimizes disk write/execution risk; there is nothing to download or run locally from unknown URLs.
Credentials
The skill requests no environment variables or local secrets, but it does require an MCP Connector link which embeds an auth token and functions as the credential. That is proportional to the stated purpose, but the registry claims 'no primary credential' which contradicts the SKILL.md. Treat the MCP link like a password.
Persistence & Privilege
The skill is not always-enabled and does not request elevated platform privileges. Model-driven autonomous invocation is allowed (the platform default) but not, by itself, an extra red flag here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install boring-facebook-publisher
  3. After installation, invoke the skill by name or use /boring-facebook-publisher
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
- Added a Security & Data Handling section explaining MCP link credential safety, media upload handling, and data flow. - Documented new metadata "requires" configuration for MCP Connector link in the skill header. - Clarified that the MCP link contains an embedded auth token and must be treated like a password. - Emphasized there are no local API keys or environment variables required. - No changes to usage or API—documentation and security clarification only.
v1.0.3
- Clarified the `InvalidApiKey` error solution: now states MCP link may be invalid and to regenerate it at boring.aiagent-me.com Settings. - No other changes to features or documentation detected.
v1.0.2
- Updated setup instructions: no API key or Python install required; now uses MCP link as a Connector. - Prerequisite steps simplified: sign up with Google, connect Facebook, copy/paste MCP link. - Metadata revised: now references homepage and removes obsolete config. - API usage, workflow steps, and examples remain unchanged.
v1.0.0
Initial release of boring-facebook-publisher. - Publish and schedule text, photo, album, and video posts to Facebook Pages via Boring. - Supports listing Facebook accounts, preparing/posting media, and managing scheduled posts. - Provides guidance on API usage, prerequisites, permissions, and error handling. - Detailed workflow and examples included. - Requires BORING_API_KEY and connection to a Facebook Page.
Metadata
Slug boring-facebook-publisher
Version 1.0.4
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Boring Facebook Publisher?

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

How do I install Boring Facebook Publisher?

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

Is Boring Facebook Publisher free?

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

Which platforms does Boring Facebook Publisher support?

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

Who created Boring Facebook Publisher?

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

💬 Comments