111 ndesv21

socialclaw Skill

在 X、LinkedIn、Instagram、Facebook 主页、TikTok、YouTube、Reddit、Pinterest、WordPress、Discord 和 Telegram 上排期和发布社交媒体帖子。用于发帖、排期、发布到社交媒体,或查看帖子状态和分析数据时。

安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。

查看源码

技能指令原文(SKILL.md)

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.