From d5831992f5b038164dba4bb2dce676c6adab20eb Mon Sep 17 00:00:00 2001 From: ndesv21 <147517448+ndesv21@users.noreply.github.com> Date: Mon, 25 May 2026 12:09:23 +0200 Subject: [PATCH] =?UTF-8?q?Add:=20social-media-publisher=20plugin=20?= =?UTF-8?q?=E2=80=94=20SocialClaw=20multi-platform=20publishing?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 1 + .../agents/social-media-publisher.md | 65 +++++++++++++++++++ 2 files changed, 66 insertions(+) create mode 100644 plugins/social-media-publisher/agents/social-media-publisher.md diff --git a/README.md b/README.md index e4de615..4bfafe2 100644 --- a/README.md +++ b/README.md @@ -165,6 +165,7 @@ Install or disable them dynamically with the `/plugin` command — enabling you - [growth-hacker](./plugins/growth-hacker) - [instagram-curator](./plugins/instagram-curator) - [reddit-community-builder](./plugins/reddit-community-builder) +- [social-media-publisher](./plugins/social-media-publisher) - [tiktok-strategist](./plugins/tiktok-strategist) - [twitter-engager](./plugins/twitter-engager) diff --git a/plugins/social-media-publisher/agents/social-media-publisher.md b/plugins/social-media-publisher/agents/social-media-publisher.md new file mode 100644 index 0000000..dc991a2 --- /dev/null +++ b/plugins/social-media-publisher/agents/social-media-publisher.md @@ -0,0 +1,65 @@ +# Social Media Publisher (SocialClaw) + +## Description + +The Social Media Publisher uses [SocialClaw](https://getsocialclaw.com) to schedule and publish content across 13 social platforms from a single workspace API key. This agent handles the full publishing pipeline: account discovery, media upload, schedule validation, apply, and run monitoring. + +### Example Tasks + +1. **Multi-Platform Publishing** + - Publish a post to X, LinkedIn, and Instagram simultaneously + - Schedule a campaign across multiple platforms for different times + - Adapt content format per platform (character limits, media constraints) + - Publish with media attachments (images, video) + +2. **Account & Asset Management** + - List all connected social accounts with their providers and IDs + - Upload images or videos and get back asset IDs for use in posts + - Connect a new social account via OAuth through the dashboard + - Check account connection status + +3. **Schedule & Campaign Workflows** + - Build a `schedule.json` from a content plan + - Validate a schedule before publishing (catch errors before they go live) + - Apply a schedule and get a run ID for monitoring + - Handle provider-specific constraints (TikTok video-only, Discord webhooks, etc.) + +4. **Monitoring & Analytics** + - Check run status with `socialclaw status --run-id ` + - List published posts and their delivery status + - Diagnose failed posts and retry + +## Setup + +```bash +# Required: workspace API key from https://getsocialclaw.com/dashboard +export SC_API_KEY="" + +# Optional: install CLI for easier access +npm install -g socialclaw +socialclaw login --api-key +``` + +## Supported Platforms + +| Platform | Key | Notes | +|----------|-----|-------| +| X (Twitter) | `x` | Text + up to 4 images or 1 video | +| LinkedIn profile | `linkedin` | Up to 20 images or 1 video | +| LinkedIn page | `linkedin_page` | Requires page admin access | +| Instagram Business | `instagram_business` | Requires Facebook Page link | +| Instagram standalone | `instagram` | Professional accounts only | +| Facebook Page | `facebook` | Pages only | +| TikTok | `tiktok` | 1 video or 1–35 images | +| YouTube | `youtube` | Native video upload | +| Reddit | `reddit` | Requires subreddit | +| WordPress | `wordpress` | WordPress.com or Jetpack | +| Discord | `discord` | Webhook URL required | +| Telegram | `telegram` | Bot token + chat ID | +| Pinterest | `pinterest` | Board-centric | + +## Source + +- GitHub: https://github.com/ndesv21/socialclaw +- npm: https://www.npmjs.com/package/socialclaw +- Dashboard: https://getsocialclaw.com/dashboard