🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Boring Social Media Publisher

by @snoopyrain

Publish social media posts to multiple platforms at once. Use when the user says 'post to social media', 'publish everywhere', 'cross-post', 'share on all pl...

Versionv1.0.0
Downloads297
TERMINAL
clawhub install boring-social-media-publisher

πŸ“– About This Skill


name: boring-social-media-publisher description: "Publish social media posts to multiple platforms at once. Use when the user says 'post to social media', 'publish everywhere', 'cross-post', 'share on all platforms', 'publish to Facebook and Instagram', or wants to distribute content across Facebook, Instagram, Threads, YouTube, TikTok, or X simultaneously." version: 1.0.0 metadata: openclaw: emoji: "πŸš€" homepage: https://boring-doc.aiagent-me.com/getting-started/mcp.html requires: config: - MCP Connector link from boring.aiagent-me.com (contains embedded auth token)

Boring Social Publisher

Publish content to multiple social media platforms with a single message. Powered by Boring β€” a unified social media publishing API.

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 your social accounts β€” link Facebook Pages, Instagram Business, Threads, YouTube, TikTok, or X accounts via OAuth 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 into Claude settings as a Connector β€” no install, no API key needed

    Workflow

    When the user wants to publish content across platforms, follow these steps:

    Step 1: Get Available Accounts

    Call boring_list_accounts to see which platforms the user has connected. Show them a summary:

  • Account name and platform
  • Connection status
  • Step 2: Confirm Content and Platforms

    Ask the user:

  • What content to post (text, images, videos)
  • Which platforms to target (or "all")
  • Whether to publish now or schedule for later
  • Step 3: Prepare Media (if needed)

    If the user provides local files or URLs:

  • Local files: Use boring_upload_file with file_path to upload and get a public URL
  • External URLs: Use boring_upload_from_url to re-host the media on Boring's cloud storage
  • Google Drive links: Pass directly β€” Boring handles Google Drive URLs automatically
  • Step 4: Adapt Content Per Platform

    Automatically adjust content for each platform's requirements:

    | Platform | Text Limit | Media Required | Notes | |----------|-----------|----------------|-------| | Facebook | No strict limit | No | Supports text, photo, album (2-10), video | | Instagram | 2,200 chars | Yes | Photo, carousel (2-10), Reels (video 9:16) | | Threads | 500 chars | No | Text, photo, carousel (2-20), video | | YouTube | Title: 100, Desc: 5,000 | Yes (video) | Text format: Title\n\nDescription | | TikTok | 2,200 chars | Yes (video or photos) | Video or photo carousel (up to 35) | | X | 280 chars | No | Text, up to 4 images or 1 video |

    Important adaptations:

  • Truncate text to fit platform limits
  • Skip Instagram if no media is available (media is mandatory)
  • For YouTube: format text as Video Title\n\nDescription text here
  • For Threads: split long content into a thread if over 500 chars using boring_publish_thread
  • Step 5: Publish

    For each selected platform, call boring_publish_post with:

  • account_id: from the account list
  • platform: the platform name
  • text: adapted content
  • media_urls: array of media URLs (if any)
  • scheduled_at: ISO 8601 datetime if scheduling (e.g., 2025-12-25T10:00:00Z)
  • Step 6: Report Results

    After publishing, summarize:

  • Which platforms succeeded with post IDs
  • Which platforms failed and why
  • If scheduled, show the scheduled time and post IDs
  • Scheduling

    To schedule posts for later:

  • Add scheduled_at parameter with ISO 8601 format: 2025-12-25T10:00:00Z
  • Use boring_list_scheduled_posts to view queued posts
  • Use boring_cancel_scheduled_post to cancel before publish time
  • Error Handling

    | Error | Solution | |-------|----------| | InvalidApiKey | MCP link may be invalid β€” regenerate it at boring.aiagent-me.com Settings | | TokenExpired | Ask user to reconnect the account at boring.aiagent-me.com | | MediaRequired | Instagram/TikTok require media β€” skip or ask user for an image | | TextTooLong | Truncate or split content for the platform | | RateLimitExceeded | Wait and retry (check retry_after field) | | AccountDisabled | Account was disconnected β€” reconnect at dashboard |

    Example Usage

    User: "Post 'Just launched our new product!' with this image to all my accounts"

    Agent workflow: 1. boring_list_accounts β†’ finds Facebook, Instagram, Threads accounts 2. boring_upload_from_url (if image is a URL) β†’ gets hosted URL 3. boring_publish_post to Facebook with text + image 4. boring_publish_post to Instagram with text + image 5. boring_publish_post to Threads with text + image 6. Report: "Published to 3 platforms successfully"

    Documentation

    Full API docs: boring-doc.aiagent-me.com

    βš™οΈ Configuration

    1. Sign up at boring.aiagent-me.com with Google 2. Connect your social accounts β€” link Facebook Pages, Instagram Business, Threads, YouTube, TikTok, or X accounts via OAuth 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 into Claude settings as a Connector β€” no install, no API key needed