social-publisher

name	social-publisher
description	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.
origin	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
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

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

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