social-publisher

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
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 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

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

Related Skills

• x-api — direct X/Twitter API operations
• social-graph-ranker — network analysis for outreach targeting

Source

• npm: npm install -g socialclaw@0.1.12
• Dashboard: SocialClaw dashboard