JSPM – socialclaw@0.1.11

Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (socialclaw) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

SocialClaw is a 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.

It is the public home for the SocialClaw CLI and agent skill bundle.

This repo is the public integration surface for SocialClaw:

the npm CLI package
the OpenClaw/ClawHub skill bundle
the Claude Code plugin (skills/socialclaw/) and marketplace (.claude-plugin/)
the Claude Code command file installed by socialclaw install --claude
public usage docs and examples

Supported providers currently include:

X
Facebook Pages
Instagram Business
Instagram standalone professional accounts
LinkedIn profile
LinkedIn page
Pinterest
TikTok
Discord
Telegram
YouTube
Reddit
WordPress

The hosted SocialClaw service lives at:

https://getsocialclaw.com

Install

npm install -g socialclaw
socialclaw --help
social --help

Authentication and access

Running socialclaw login without an API key opens the hosted dashboard so the user can:

sign in with Google
connect social accounts
create or copy a workspace API key
activate a trial or paid plan for CLI/API access

Important:

the CLI works against a deployed SocialClaw workspace via API key auth
an API key alone is not enough for agent execution; the workspace must also have an active trial or paid plan
if a command returns plan_required or subscription_*, send the user to https://getsocialclaw.com/pricing or https://getsocialclaw.com/dashboard

Quick start

socialclaw login
socialclaw login --api-key <workspace-key> --base-url https://getsocialclaw.com
socialclaw accounts list --json
socialclaw accounts capabilities --provider pinterest --json
socialclaw accounts connect --provider pinterest --open
socialclaw accounts connect --provider discord --webhook-url <webhook-url> --json
socialclaw accounts connect --provider telegram --bot-token <bot-token> --chat-id @yourchannel --json
socialclaw assets upload --file ./image.png --json
socialclaw campaigns preview -f schedule.json --json
socialclaw validate -f schedule.json --json
socialclaw apply -f schedule.json --json
socialclaw workspace health --json
socialclaw usage --json

Claude Code

Plugin install (recommended)

Install as a proper Claude Code plugin from inside Claude Code:

/plugin marketplace add ndesv21/socialclaw
/plugin install socialclaw@socialclaw

This installs the /socialclaw:socialclaw skill and enables auto-invocation — Claude will use SocialClaw automatically when you ask about scheduling, posting, or managing social accounts.

Command file install (alternative)

socialclaw install --claude

That copies the bundled command file into ~/.claude/commands/socialclaw.md and registers /socialclaw.

What the CLI covers

workspace API key login and hosted dashboard bootstrap
browser OAuth connect plus manual Discord/Telegram connect
hosted asset upload and deletion
schedule validation, campaign preview, apply, inspect, clone, and draft publishing
post, run, attempt, analytics, job, usage, and health inspection
Claude Code command installation through socialclaw install --claude

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/catalog discovery, plus pin/account analytics. Product, collection, and idea surfaces should be treated as capability-gated or beta rather than assumed for every workspace.

Skills and plugin

The OpenClaw-compatible skill bundle lives in skill/. Publish that folder to ClawHub for OpenClaw/ClawHub agent discovery.

The Claude Code plugin lives in skills/socialclaw/ with the marketplace manifest at .claude-plugin/.

Publishing

Bump the version with npm version — it automatically syncs the version into .claude-plugin/plugin.json and .claude-plugin/marketplace.json and stages the changes:

npm version patch   # or minor / major
git push && git push --tags
npm publish --access public

To sync reference files manually after editing skill/references/:

npm run sync:references

Notes

Users connect accounts inside the hosted SocialClaw dashboard.
The dashboard and API live at https://getsocialclaw.com.
The npm package ships the CLI, skill docs, Claude Code plugin, and command asset.

socialclaw