Skip to content
Back to search

socialclaw

MarketplaceWorks with Claude CodeGitHub

Social media scheduling CLI and OpenClaw skill for AI agents posting to X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, and Pinterest.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ndesv21--socialclaw/badge.svg)](/listings/ndesv21--socialclaw)

HTML

<a href="/listings/ndesv21--socialclaw"><img src="/api/listings/ndesv21--socialclaw/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install -g socialclaw
socialclaw login
socialclaw accounts list --json

**Install as an AI agent skill** (Claude Code, Cursor, Cline, Codex, and more):

npx skills add ndesv21/socialclaw

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 58 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "socialclaw",
  3. "owner": {
  4. "name": "SocialClaw",
  5. "email": "support@getsocialclaw.com"
  6. },
  7. "metadata": {
  8. "description": "Social media scheduling and publishing for AI agents on X, LinkedIn, Instagram, Facebook, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, and Pinterest."
  9. },
  10. "plugins": [
  11. {
  12. "name": "socialclaw",
  13. "source": {
  14. "source": "url",
  15. "url": "https://github.com/ndesv21/socialclaw.git"
  16. },
  17. "description": "Social media scheduling and publishing for AI agents",
  18. "version": "0.1.22",
  19. "author": {
  20. "name": "SocialClaw"
  21. },
  22. "homepage": "https://getsocialclaw.com",
  23. "repository": "https://github.com/ndesv21/socialclaw",
  24. "license": "MIT",
  25. "keywords": [
  26. "social-media",
  27. "scheduling",
  28. "publishing",
  29. "agents",
  30. "mcp",
  31. "model-context-protocol",
  32. "agentic-ai",
  33. "claude-code",
  34. "codex",
  35. "x",
  36. "twitter",
  37. "linkedin",
  38. "instagram",
  39. "facebook",
  40. "tiktok",
  41. "discord",
  42. "telegram",
  43. "youtube",
  44. "reddit",
  45. "wordpress",
  46. "pinterest"
  47. ],
  48. "category": "productivity",
  49. "tags": [
  50. "social-media",
  51. "scheduling",
  52. "publishing",
  53. "agents"
  54. ]
  55. }
  56. ],
  57. "version": "0.1.22"
  58. }
README.md · README · 267 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="https://raw.githubusercontent.com/ndesv21/socialclaw/main/.github/readme/logo.png" alt="SocialClaw logo" width="112">
  3. </p>
  4. <h1 align="center">SocialClaw</h1>
  5. <p align="center">
  6. Social media scheduling CLI and OpenClaw skill for AI agents posting to X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, and Pinterest.
  7. </p>
  8. <p align="center">
  9. <a href="https://getsocialclaw.com"><strong>Official Website: getsocialclaw.com</strong></a> ·
  10. <a href="https://getsocialclaw.com/dashboard">Dashboard</a> ·
  11. <a href="https://www.npmjs.com/package/socialclaw">npm</a> ·
  12. <a href="https://github.com/ndesv21/socialclaw/tree/main/skill">Skill Bundle</a>
  13. </p>
  14. <p align="center">
  15. <picture>
  16. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/ndesv21/socialclaw/main/.github/readme/workflow-dark.png">
  17. <img src="https://raw.githubusercontent.com/ndesv21/socialclaw/main/.github/readme/workflow-light.png" alt="SocialClaw turns prompts, workflows, and AI agents into scheduled publishing, retries, inspection, and analytics across social channels." width="100%">
  18. </picture>
  19. </p>
  20. **[getsocialclaw.com](https://getsocialclaw.com) is the official SocialClaw website** — the hosted dashboard, API, and account sign-up all live there.
  21. This repo is the public home for:
  22. - the `socialclaw` npm CLI
  23. - the OpenClaw and ClawHub skill bundle
  24. - the Claude Code plugin and `/socialclaw` command asset
  25. - public usage docs, provider notes, and schedule examples
  26. ## Install
  27. ```bash
  28. npm install -g socialclaw
  29. socialclaw login
  30. socialclaw accounts list --json
  31. ```
  32. **Install as an AI agent skill** (Claude Code, Cursor, Cline, Codex, and more):
  33. ```bash
  34. npx skills add ndesv21/socialclaw
  35. ```
  36. ## What the CLI covers
  37. - workspace API key login and hosted dashboard bootstrap
  38. - browser OAuth connect plus manual Discord and Telegram connect
  39. - hosted asset upload and deletion
  40. - schedule validation, campaign preview, apply, inspect, clone, and draft publishing
  41. - post, run, attempt, analytics, job, usage, and health inspection
  42. - provider-side deletion for supported published posts
  43. - Claude Code command installation through `socialclaw install --claude`
  44. ## CLI at a glance
  45. ```bash
  46. socialclaw login
  47. socialclaw accounts list --json
  48. socialclaw assets upload --file ./image.png --json
  49. socialclaw validate -f schedule.json --json
  50. socialclaw apply -f schedule.json --json
  51. socialclaw posts delete --post-id <post-id> --json
  52. ```
  53. <details>
  54. <summary>Current help surface</summary>
  55. ```text
  56. ____ _ _ ____ _
  57. / ___| ___ ___(_) __ _| | / ___| | __ ___ __
  58. \___ \ / _ \ / __| |/ _` | | | | | |/ _` \ \ /\ / /
  59. ___) | (_) | (__| | (_| | | | |___| | (_| |\ V V /
  60. |____/ \___/ \___|_|\__,_|_| \____|_|\__,_| \_/\_/
  61. socialclaw login
  62. socialclaw accounts list --json
  63. socialclaw assets upload --file <path> --json
  64. socialclaw campaigns preview -f <schedule.(yaml|yml|json)> --json
  65. socialclaw validate -f <schedule.(yaml|yml|json)> --json
  66. socialclaw apply -f <schedule.(yaml|yml|json)> --json
  67. socialclaw posts get --post-id <id> --json
  68. socialclaw posts delete --post-id <id> --json
  69. socialclaw status --run-id <id> --json
  70. socialclaw analytics post --post-id <id> --json
  71. ```
  72. </details>
  73. ## Watch the Demo
  74. <p align="center">
  75. <a href="https://www.youtube.com/watch?v=Biy8saQqf44">
  76. <img src="https://raw.githubusercontent.com/ndesv21/socialclaw/main/.github/readme/socialclaw-demo-poster.png" alt="Watch the SocialClaw demo video" width="820">
  77. </a>
  78. </p>
  79. <p align="center">
  80. <sub>Click the image to open the demo video.</sub>
  81. </p>
  82. ## Built for Agent-Driven Publishing
  83. <p align="center">
  84. <img src="https://raw.githubusercontent.com/ndesv21/socialclaw/main/.github/readme/agent-social-banner.jpg" alt="SocialClaw connects AI agents to social publishing across major channels." width="100%">
  85. </p>
  86. ## Authentication and access
  87. Running `socialclaw login` without an API key opens the hosted dashboard so the user can:
  88. - sign in with Google
  89. - connect social accounts
  90. - create or copy a workspace API key
  91. - activate a trial or paid plan for CLI and API access
  92. Important:
  93. - the CLI works against a deployed SocialClaw workspace via API key auth
  94. - an API key alone is not enough for agent execution; the workspace must also have an active trial or paid plan
  95. - if a command returns `plan_required` or `subscription_*`, go to `https://getsocialclaw.com/pricing` or `https://getsocialclaw.com/dashboard`
  96. ## Quick start
  97. ```bash
  98. socialclaw login
  99. socialclaw login --api-key <workspace-key> --base-url https://getsocialclaw.com
  100. socialclaw accounts list --json
  101. socialclaw accounts capabilities --provider pinterest --json
  102. socialclaw accounts connect --provider pinterest --open
  103. socialclaw accounts connect --provider discord --webhook-url <webhook-url> --json
  104. socialclaw accounts connect --provider telegram --bot-token <bot-token> --chat-id @yourchannel --json
  105. socialclaw assets upload --file ./image.png --json
  106. socialclaw campaigns preview -f schedule.json --json
  107. socialclaw validate -f schedule.json --json
  108. socialclaw apply -f schedule.json --json
  109. socialclaw posts delete --post-id <post-id> --json
  110. socialclaw workspace health --json
  111. socialclaw usage --json
  112. ```
  113. ## Agent integrations
  114. ### MCP server
  115. The package ships a Model Context Protocol server. Any MCP client (Claude Code, Claude Desktop, Cursor, and others) gets 17 validation-first publishing tools over your connected workspace accounts: list accounts and capabilities, upload media, validate and preview schedules, apply with idempotency keys, publish drafts, and inspect posts, attempts, runs, analytics, usage, and health.
  116. Claude Code:
  117. ```bash
  118. claude mcp add socialclaw \
  119. --env SOCIALCLAW_API_KEY=sc_live_your_key \
  120. -- npx -y socialclaw mcp
  121. ```
  122. Claude Desktop, Cursor, and other JSON-configured clients:
  123. ```json
  124. {
  125. "mcpServers": {
  126. "socialclaw": {
  127. "command": "npx",
  128. "args": ["-y", "socialclaw", "mcp"],
  129. "env": {
  130. "SOCIALCLAW_API_KEY": "sc_live_your_key"
  131. }
  132. }
  133. }
  134. }
  135. ```
  136. If you have already run `socialclaw login --api-key <key>`, the server reuses the saved credentials and the `env` block is unnecessary. See [getsocialclaw.com/mcp](https://getsocialclaw.com/mcp) for the full tool list.
  137. ### Claude Code plugin
  138. Install the packaged Claude Code plugin from inside Claude Code:
  139. ```shell
  140. /plugin marketplace add ndesv21/socialclaw
  141. /plugin install socialclaw@socialclaw
  142. ```
  143. This installs the marketplace plugin from [`skills/socialclaw/`](./skills/socialclaw) with metadata from [`.claude-plugin/`](./.claude-plugin). It is the cleanest option if you want Claude to auto-invoke SocialClaw when a user asks to connect accounts, upload media, schedule posts, inspect delivery, or check analytics.
  144. ### Claude slash command and skill file
  145. If you want the explicit `/socialclaw` command instead of the full plugin flow:
  146. ```bash
  147. socialclaw install --claude
  148. ```
  149. That installs the bundled command file from [`skill/claude/socialclaw.md`](./skill/claude/socialclaw.md) into `~/.claude/commands/socialclaw.md`.
  150. Use this path when you want a lightweight Claude Code setup that:
  151. - exposes one clear SocialClaw command
  152. - keeps the workspace API key flow explicit
  153. - still lets Claude use the same hosted SocialClaw API and CLI workflow
  154. ### OpenClaw and ClawHub
  155. The OpenClaw-compatible skill bundle lives in [`skill/`](./skill).
  156. It is designed for OpenClaw and other compatible agent runtimes that can load a `SKILL.md`, work from a workspace API key, and call either:
  157. - the SocialClaw HTTP API directly
  158. - the `socialclaw` CLI as a client for the hosted service
  159. This is the bundle to publish to ClawHub for OpenClaw discovery.
  160. ### Other agents
  161. SocialClaw is not limited to one agent framework. The repo also includes an agent manifest in [`skill/agents/openai.yaml`](./skill/agents/openai.yaml), and the CLI works well for any runtime that can execute shell commands or make HTTP requests.
  162. That makes SocialClaw a good fit for:
  163. - Codex and terminal-native agent workflows
  164. - Claude Code via plugin or command file
  165. - OpenClaw and ClawHub skills
  166. - custom internal agents that need one stable publishing surface for social channels
  167. In practice, all of these share the same model:
  168. - connect customer accounts inside SocialClaw
  169. - create a workspace API key
  170. - upload media, validate, apply, inspect, analyze, and optionally delete supported posts through the hosted service
  171. ## Supported providers
  172. - X
  173. - Facebook Pages
  174. - Instagram Business
  175. - Instagram standalone professional accounts
  176. - LinkedIn profile
  177. - LinkedIn page
  178. - Pinterest
  179. - TikTok
  180. - Discord
  181. - Telegram
  182. - YouTube
  183. - Reddit
  184. - WordPress
  185. Pinterest is exposed as the `pinterest` provider in the public CLI and skill bundle. Its main publish target is board-centric, with support for standard pins, video pins, multi-image pins, board creation and section or catalog discovery, plus pin and account analytics. Product, collection, and idea surfaces should be treated as capability-gated or beta rather than assumed for every workspace.
  186. TikTok supports one video or one photo gallery per post. Photo galleries can include up to 35 images and expose `autoAddMusic` plus `photoCoverIndex`; selecting a specific TikTok song or sound is not available through TikTok's Content Posting API. For photo galleries, normalize images before upload, preferably to 1080x1920 JPEGs for vertical slides or another standard TikTok-compatible aspect/size. Oversized or unusual image dimensions may pass SocialClaw validation and initial TikTok acceptance, then fail later with `picture_size_check_failed`; reconcile photo posts after publish to confirm TikTok reports `PUBLISH_COMPLETE`.
  187. ## Publishing
  188. Bump the version with `npm version`:
  189. ```bash
  190. npm version patch
  191. git push && git push --tags
  192. npm publish --access public
  193. ```
  194. To sync reference files manually after editing `skill/references/`:
  195. ```bash
  196. npm run sync:references
  197. ```
  198. ## Notes
  199. - Users connect accounts inside the hosted SocialClaw dashboard.
  200. - The dashboard and API live at `https://getsocialclaw.com`.
  201. - The npm package ships the CLI, skill docs, Claude Code plugin, and command asset.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.