Back to Everything Claude Code

Social Publisher (SocialClaw)

skills/social-publisher/SKILL.md

2.0.02.6 KB
Original Source

Social Publisher (SocialClaw)

Connects Claude Code to SocialClaw for agent-driven social media publishing across 13 platforms through a single workspace API key.

When to Activate

  • publish content to X, LinkedIn, Instagram, TikTok, or other platforms
  • schedule a post campaign across multiple platforms at once
  • upload media for use in social posts
  • validate a post schedule before going live
  • monitor publishing run status and delivery analytics

Setup

bash
# Required: workspace API key from https://getsocialclaw.com/dashboard
export SC_API_KEY="<workspace-key>"

# Verify access
printf 'header = "Authorization: Bearer %s"\n' "$SC_API_KEY" |
  curl -sS -K - https://getsocialclaw.com/v1/keys/validate

# Install CLI (optional but recommended)
npm install -g [email protected]
socialclaw login --api-key <workspace-key>

Core Workflow

1. List connected accounts

bash
socialclaw accounts list --json

If not connected:

bash
socialclaw accounts connect --provider x --open
socialclaw accounts connect --provider linkedin --open

2. Upload media (optional)

bash
socialclaw assets upload --file ./image.png --json
# → { "asset_id": "..." }

3. Build schedule.json

json
{
  "posts": [
    {
      "provider": "x",
      "account_id": "<account-id>",
      "text": "Post text here",
      "scheduled_at": "2026-06-01T10:00:00Z"
    }
  ]
}

4. Validate before publishing

bash
socialclaw validate -f schedule.json --json

5. Publish

bash
socialclaw apply -f schedule.json --json
# → { "run_id": "..." }

6. Monitor

bash
socialclaw status --run-id <run-id> --json
socialclaw posts list --json

Supported Providers

ProviderKey
X (Twitter)x
LinkedIn profilelinkedin
LinkedIn pagelinkedin_page
Instagram Businessinstagram_business
Instagram standaloneinstagram
Facebook Pagefacebook
TikToktiktok
YouTubeyoutube
Redditreddit
WordPresswordpress
Discorddiscord
Telegramtelegram
Pinterestpinterest

Security

  • Outbound requests go to getsocialclaw.com only
  • Provider OAuth is in the SocialClaw dashboard — no per-provider secrets exposed to the agent
  • SC_API_KEY is a workspace-scoped key
  • x-api — direct X/Twitter API operations
  • social-graph-ranker — network analysis for outreach targeting

Source