diff --git a/README.md b/README.md index 318c65679..889d2359b 100644 --- a/README.md +++ b/README.md @@ -289,6 +289,7 @@ Pre-built workflow skills for 78 SaaS apps via [Rube MCP (Composio)](https://com - [Instagram Automation](./instagram-automation/) - Automate Instagram: posts, stories, comments, media, and business insights. - [LinkedIn Automation](./linkedin-automation/) - Automate LinkedIn: posts, profiles, companies, images, and comments. - [Reddit Automation](./reddit-automation/) - Automate Reddit: posts, comments, subreddits, voting, and moderation. +- [SocialClaw](./socialclaw/) - Schedule and publish social media posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via SocialClaw. One workspace API key for campaigns, media upload, and analytics. - [TikTok Automation](./tiktok-automation/) - Automate TikTok: video uploads, queries, and creator management. - [Twitter Automation](./twitter-automation/) - Automate Twitter/X: tweets, search, users, lists, and engagement. - [YouTube Automation](./youtube-automation/) - Automate YouTube: videos, channels, playlists, comments, and subscriptions. diff --git a/socialclaw/SKILL.md b/socialclaw/SKILL.md new file mode 100644 index 000000000..bd9b42a94 --- /dev/null +++ b/socialclaw/SKILL.md @@ -0,0 +1,117 @@ +--- +name: socialclaw +description: Schedule and publish social media posts across 13 platforms via SocialClaw. Use when the user wants to connect social accounts, upload media, apply a post schedule, or publish to X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, or Pinterest through the SocialClaw API. +license: MIT +--- + +# SocialClaw + +## When to Use This Skill + +Use this skill when you need to: +- **Schedule posts** across multiple social platforms at once +- **Publish content** to X, LinkedIn, Instagram, Facebook Pages, TikTok, YouTube, Reddit, WordPress, Pinterest, Discord, or Telegram +- **Upload media** (images, video) for use in social posts +- **Validate and apply** a post schedule before publishing +- **Monitor publishing runs** and check delivery status + +## What This Skill Does + +1. **Authenticates** with the SocialClaw workspace API (`SC_API_KEY`) +2. **Lists connected accounts** across all supported providers +3. **Uploads media assets** and returns asset IDs for post attachment +4. **Validates** a `schedule.json` file for errors before publishing +5. **Applies** the schedule, creating a run with a unique `run_id` +6. **Monitors** run status and per-post delivery results + +## Setup + +```bash +# Required: workspace API key from https://getsocialclaw.com/dashboard +export SC_API_KEY="" + +# Verify access +curl -sS -H "Authorization: Bearer $SC_API_KEY" https://getsocialclaw.com/v1/keys/validate + +# Optional: install CLI +npm install -g socialclaw +socialclaw login --api-key +``` + +## Core Workflow + +### 1. List connected accounts +```bash +socialclaw accounts list --json +``` +If no accounts are connected, the user must connect via the dashboard: +```bash +socialclaw accounts connect --provider x --open +socialclaw accounts connect --provider linkedin --open +``` + +### 2. Upload media (if needed) +```bash +socialclaw assets upload --file ./image.png --json +# Returns: { "asset_id": "..." } +``` + +### 3. Build schedule.json +```json +{ + "posts": [ + { + "provider": "x", + "account_id": "", + "text": "Post content here", + "scheduled_at": "2026-06-01T10:00:00Z" + } + ] +} +``` + +### 4. Validate +```bash +socialclaw validate -f schedule.json --json +``` + +### 5. Publish +```bash +socialclaw apply -f schedule.json --json +``` + +### 6. Monitor +```bash +socialclaw status --run-id --json +socialclaw posts list --json +``` + +## Supported Providers + +| Provider | 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 | + +## Security + +- Outbound requests go to `getsocialclaw.com` only +- Provider OAuth is handled in the SocialClaw dashboard — no provider secrets exposed to the agent +- The `SC_API_KEY` is a workspace-scoped key only + +## Source + +- GitHub: https://github.com/ndesv21/socialclaw +- npm: https://www.npmjs.com/package/socialclaw +- Dashboard: https://getsocialclaw.com/dashboard