2026-05-25 14:11:05 -04:00

2.9 KiB

name, description, origin
name description origin
social-publisher Agent-driven scheduling and publishing of social media posts across 13 platforms via SocialClaw. Use when the user wants to publish to X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, or Pinterest — or when managing campaigns, uploading media, or monitoring post delivery status. community

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

# 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

# Install CLI (optional but recommended)
npm install -g socialclaw@0.1.12
socialclaw login --api-key <workspace-key>

Core Workflow

1. List connected accounts

socialclaw accounts list --json

If not connected:

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

2. Upload media (optional)

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

3. Build schedule.json

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

4. Validate before publishing

socialclaw validate -f schedule.json --json

5. Publish

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

6. Monitor

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

Supported Providers

Provider Key
X (Twitter) x
LinkedIn profile linkedin
LinkedIn page linkedin_page
Instagram Business instagram_business
Instagram standalone instagram
Facebook Page facebook
TikTok tiktok
YouTube youtube
Reddit reddit
WordPress wordpress
Discord discord
Telegram telegram
Pinterest pinterest

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