affaan-m/social-publisher

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

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

Files1

1 files · 1.0 KB

Select a file to preview

Overall Score

72/100

Grade

B

Good

Safety

75

Quality

70

Clarity

78

Completeness

65

Summary

This skill enables AI agents to schedule and publish social media content across 13 platforms (X, LinkedIn, Instagram, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest, Facebook, and more) via the SocialClaw API. The agent can list connected accounts, upload media, build schedules, validate posts, publish campaigns, and monitor delivery status — all scoped to a single workspace API key.

Detected Capabilities

environment variable read (SC_API_KEY)outbound API requests (getsocialclaw.com)local file read (schedule.json, image uploads)JSON parsing and generationCLI tool execution (socialclaw)authentication via API key bearer token

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

publish social mediaschedule cross-platform postssocialclaw apimulti-platform campaignsupload social media assetsmanage social accountsmonitor post delivery

Risk Signals

INFO

Environment variable read for API key (SC_API_KEY)

Setup section

INFO

Outbound HTTPS requests to getsocialclaw.com (curl, CLI)

Core Workflow sections 1-6

WARNING

API key exposed in curl command example

Setup section: 'curl -sS -H "Authorization: Bearer $SC_API_KEY"'

WARNING

No documented validation of API key scope or rate limits

Security section and Setup

Referenced Domains

External domains referenced in skill content, detected by static analysis.

getsocialclaw.com

Use Cases

Publish social media posts across multiple platforms simultaneously
Schedule content campaigns with specified timestamps
Upload and manage media assets for use in social posts
Validate post schedules before publishing to catch errors
Monitor publishing run status and delivery analytics across platforms
Manage connected social media accounts for a workspace
Build and execute single-platform posts via agent workflow

Quality Notes

Positive: Clear, well-structured workflow with 6 sequential steps — agents can follow linearly
Positive: Comprehensive provider list (13 platforms) with consistent key naming
Positive: Security section explicitly documents scope boundaries (workspace key, no per-provider secrets)
Positive: Related skills referenced for common workflows (x-api, social-graph-ranker)
Negative: No error handling guidance — what if validation fails? What if a platform is unreachable?
Negative: No example of actual schedule.json with real provider keys (uses placeholders only)
Negative: Setup section shows curl command with literal API key in documentation — could lead to credential exposure if copy-pasted
Negative: No mention of rate limits, daily quotas, or platform-specific constraints
Negative: Asset upload returns asset_id but no guidance on how to reference it in schedule.json (missing details)
Negative: No guidance on what account_id format to use or how to retrieve it from 'accounts list'

Model: claude-haiku-4-5-20251001Analyzed: May 25, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

social-publisher

Social Publisher (SocialClaw)