SocialClaw

Schedule and publish social media posts through connected accounts using the hosted SocialClaw API. SocialClaw handles each network's OAuth, media rules, and publish logic, so this skill only needs a workspace API key.

When to Use

• The user wants to post or schedule content to social media
• The user wants to publish the same message to multiple platforms at once
• The user wants to check whether a scheduled post succeeded
• The user asks for post analytics

Supported Networks

X, LinkedIn (profile + page), Instagram (business + standalone), Facebook Pages, TikTok, YouTube, Reddit, Pinterest, WordPress, Discord, and Telegram.

Authentication

All requests go to https://getsocialclaw.com and send the workspace key:

Authorization: Bearer $SOCIALCLAW_API_KEY

Never hardcode the key — read it from the SOCIALCLAW_API_KEY environment variable.

Procedure

1. List connected accounts to get an account id: GET /v1/accounts
2. (optional) Check capabilities (media/text limits): GET /v1/accounts/{accountId}/capabilities
3. (optional) Upload media: POST /v1/assets/upload with { filename, contentType, contentBase64 } → returns a hosted URL to use as media_link
4. Validate before publishing (always): POST /v1/posts/validate with { schedule }
5. Schedule or publish: POST /v1/posts/apply with { schedule }. Omit publish_at to publish immediately.
6. Check status: GET /v1/posts/{postId}/attempts

Schedule document shape

{
  "timezone": "UTC",
  "posts": [
    {
      "account": "<accountId>",
      "name": "launch post",
      "description": "<the post text>",
      "publish_at": "2026-06-16T09:00:00Z",
      "media_link": "<optional hosted media URL>"
    }
  ]
}

Examples

List connected accounts:

curl -s https://getsocialclaw.com/v1/accounts \
  -H "Authorization: Bearer $SOCIALCLAW_API_KEY"

Validate, then schedule a post:

PAYLOAD='{"schedule":{"timezone":"UTC","posts":[{"account":"ACCOUNT_ID","name":"launch","description":"Hello from Hermes 🦅","publish_at":"2026-06-16T09:00:00Z"}]}}'

curl -s -X POST https://getsocialclaw.com/v1/posts/validate \
  -H "Authorization: Bearer $SOCIALCLAW_API_KEY" -H "Content-Type: application/json" -d "$PAYLOAD"

curl -s -X POST https://getsocialclaw.com/v1/posts/apply \
  -H "Authorization: Bearer $SOCIALCLAW_API_KEY" -H "Content-Type: application/json" -d "$PAYLOAD"

Alternative: hosted MCP or CLI

SocialClaw also exposes the same capabilities as tools:

• MCP: connect to the hosted streamable-HTTP server at https://getsocialclaw.com/mcp with Authorization: Bearer $SOCIALCLAW_API_KEY.
• CLI: npx -y socialclaw mcp (stdio MCP), or the socialclaw CLI after socialclaw login.

Network Calls

• https://getsocialclaw.com — SocialClaw REST API and hosted MCP. This is the only host contacted.

Notes & Limitations

• Always run validate before apply to catch provider-rule and media issues early.
• Each network has its own media type, text length, and account-model rules; the capabilities endpoint reports them.
• Publishing requires an active SocialClaw plan; listing tools/accounts works on a trial key.
• Accounts are connected once in the SocialClaw dashboard; this skill does not perform per-network OAuth.