---
name: davepoon/socialclaw
source: https://app.decimal.ai/s/davepoon-socialclaw@1/SKILL.md
source_sha256: 241d3bd68d51
---

# SocialClaw

SocialClaw is a workspace-scoped social publishing service at `https://getsocialclaw.com`.

This skill teaches Claude Code how to:
- Validate a workspace API key and confirm SocialClaw access
- Connect and disconnect social accounts via browser OAuth
- Upload media assets and get SocialClaw-hosted delivery URLs
- Validate, preview, apply, and inspect scheduled posts and campaigns
- Inspect account capabilities, publish settings, analytics, and workspace health

## Runtime Requirements

- `SC_API_KEY` — workspace API key from the SocialClaw dashboard
- CLI (optional): `npm install -g socialclaw`
- Active trial or paid plan required for CLI/API execution

## Quick Start

```bash
# Get a workspace API key
open https://getsocialclaw.com/dashboard

# Set it in your environment
export SC_API_KEY="<workspace-key>"

# Or use the CLI
socialclaw login --api-key <workspace-key>

# List connected accounts
socialclaw accounts list --json

# Upload media and schedule a post
socialclaw assets upload --file ./image.png --json
socialclaw validate -f schedule.json --json
socialclaw apply -f schedule.json --json
```

## Supported Providers

X, LinkedIn (profile + page), Instagram (Business + standalone), Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest

## Install as Skill

```bash
npx skills add ndesv21/socialclaw
```

## Key Commands

```bash
socialclaw login                                          # Authenticate with workspace API key
socialclaw accounts list --json                          # List connected accounts
socialclaw accounts connect --provider x --open          # Connect X account
socialclaw assets upload --file ./image.png --json       # Upload media
socialclaw validate -f schedule.json --json              # Validate schedule
socialclaw apply -f schedule.json --json                 # Apply schedule / create run
socialclaw status --run-id <id> --json                   # Check run status
socialclaw posts list --json                             # List posts
socialclaw analytics post --post-id <id> --json          # Post analytics
socialclaw workspace health --json                       # Workspace health
```

## Links

- GitHub: https://github.com/ndesv21/socialclaw
- Dashboard: https://getsocialclaw.com/dashboard
- npm: https://www.npmjs.com/package/socialclaw