socialclaw

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"