Skip to content

Add: socialclaw — multi-platform social media scheduling and publishing skill #914

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ndesv21 wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Add: socialclaw — multi-platform social media scheduling and publishing skill #914

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
117 changes: 117 additions & 0 deletions socialclaw/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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="<workspace-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 <workspace-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": "<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 <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
Loading