SocialClaw CLI
SocialClaw is a CLI, MCP and skill for posting to 11 social networks: the agent validates, schedules and inspects posts.
- 109 ★ on the repository
- Last commit
Broad access
Why this level
- The agent publishes posts as your social accounts.
- The workspace API key and bot tokens give access to the accounts.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/socialclawDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent publishes posts as your social accounts.
- The workspace API key and bot tokens give access to the accounts.
This is third-party code. Review the repository files before installing.
What it does
SocialClaw connects an agent to a workspace at `getsocialclaw.com` where social accounts are linked. The CLI uploads media, validates a schedule, previews a campaign and applies it, then inspects posts, attempts, analytics and account health. It supports X, Facebook Pages, Instagram, LinkedIn, Pinterest, TikTok, Discord, Telegram, YouTube, Reddit and WordPress. The bundled MCP server exposes 17 validation-first tools, and retries are guarded by idempotency keys. Claude Code has a plugin and a `/socialclaw` command, and other agents install the skill with `npx skills add ndesv21/socialclaw`.
Who it is for. Social media managers and marketers who let an agent prepare and monitor posts across several networks.
Good fit when
- An agent validates next week schedule before posting.
- One piece goes to LinkedIn, Telegram and WordPress with different captions.
- After posts go live you need a delivery and analytics report.
- A failed post is deleted from the network by its id.
- Media files are uploaded in one command and attached to a campaign.
Not a fit when
- You need a tool without a paid plan: an API key is not enough and the workspace needs a trial or paid plan.
- You want to publish without SocialClaw accounts: the service is hosted at `getsocialclaw.com`.
- You need sign-in without Google.
Example request
Validate the schedule in `schedule.json`, show a campaign preview and apply it only after my approval.Limitations
The CLI works against a hosted service with a workspace API key. A key alone is not enough: an active trial or paid plan is required, otherwise commands return `plan_required` or `subscription_*`. Sign-in goes through Google, networks connect by browser OAuth, and Discord and Telegram through a webhook or bot token. The agent publishes as your accounts, so run `validate` and `campaigns preview` first. The install is global and Node.js is required.
How to disable. Run `npm uninstall -g socialclaw`, remove the plugin or the `~/.claude/commands/socialclaw.md` file and revoke the key in the SocialClaw dashboard.
FAQ
How do I enable MCP mode?
In Claude Code run `claude mcp add socialclaw --env SOCIALCLAW_API_KEY=sc_live_your_key -- npx -y socialclaw mcp`. If `socialclaw login --api-key` was run, the variable is optional.
What does `plan_required` mean?
The workspace has no active trial or paid plan. Enable one at `getsocialclaw.com/pricing` or in the dashboard.
How do I check a schedule without publishing?
`socialclaw validate -f schedule.json --json` and `socialclaw campaigns preview -f schedule.json --json` publish nothing. `socialclaw apply` does.
Can I delete a published post?
For supported networks yes: `socialclaw posts delete --post-id <id> --json`.
How do I install it as a skill instead of a CLI?
Run `npx skills add ndesv21/socialclaw`. Claude Code also has a plugin: `/plugin marketplace add ndesv21/socialclaw`, then `/plugin install socialclaw@socialclaw`.
Discussion
No questions or reviews yet.
Related
CLI toolsTen Claude Code skills for small business social media: brand, calendar, captions, visuals and a monthly performance review
The sau CLI and skills for Claude Code and Codex: publish videos, articles and images to Douyin, Bilibili, YouTube, Instagram and more
A Claude Code plugin for social posting, scheduling, analytics and account linking through the hosted PostPeer MCP.
The openquok CLI and skills give an agent social post scheduling, media upload and directory submission checks.
A social content skill: learns your voice, plans content, writes posts and, after confirmation, publishes through your logged-in Chrome
MCP server of the OpenPost social scheduler: an agent reviews the calendar and accounts, drafts, schedules and publishes posts and triages comments
README in short
The repository holds the `socialclaw` npm package, a skill bundle for OpenClaw and ClawHub, a Claude Code plugin and docs on providers and schedules. The service runs through a hosted API.