socialclaw

# SocialClaw — Social Media Publisher

## Overview

SocialClaw is an agent-first social media publishing skill that lets you schedule and publish posts across 13 platforms using a single workspace API key. No per-platform OAuth setup required — one key covers everything.

## When to Use

- Use when the user wants to plan, schedule, or publish a social media campaign across multiple platforms.
- Use when the user has a SocialClaw workspace API key and wants one workflow for X, LinkedIn, Instagram, Facebook, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, or Pinterest.
- Use when the user asks for social publishing automation that can validate schedules, attach media, and retrieve post performance metrics.

## Supported Platforms

- X (Twitter)
- LinkedIn (Profile + Page)
- Instagram (Business + Standalone)
- Facebook Pages
- TikTok
- Discord
- Telegram
- YouTube
- Reddit
- WordPress
- Pinterest

## Installation

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

Or install the npm package directly:

```bash
npm install socialclaw@0.1.12
```

## Configuration

Set your workspace API key:

```bash
export SOCIALCLAW_API_KEY=your_workspace_api_key
```

Get your API key at [getsocialclaw.com](https://getsocialclaw.com).

## Workflow

### Step 1: Create a Campaign

Define your campaign with target platforms, content, and schedule.

### Step 2: Upload Media (Optional)

Upload images or videos to attach to posts.

### Step 3: Validate Schedule

Confirm platform-specific timing rules are met (e.g., rate limits, posting windows).

### Step 4: Publish or Schedule

Publish immediately or schedule for a future time across all selected platforms simultaneously.

### Step 5: Analytics

Retrieve post performance metrics after publishing.

## Example Usage

```
/social-publishing

Create a campaign for our product launch:
- Platforms: X, LinkedIn, Instagram
- Message: "Excited to announce our new feature! Check it out at example.com #launch #product"
- Schedule: Tomorrow at 9am PST
```

## Source

GitHub: [ndesv21/socialclaw](https://github.com/ndesv21/socialclaw)
Website: [getsocialclaw.com](https://getsocialclaw.com)

## Limitations

- Requires a valid SocialClaw workspace API key; do not attempt publishing without explicit user-provided credentials.
- Treat every publish, schedule, delete, or account-changing action as state-changing: show the target platforms, content, media, and timing, then wait for explicit user confirmation before calling the service.
- Platform availability, rate limits, analytics fields, and scheduling behavior depend on the upstream SocialClaw service.
- This skill describes the publishing workflow; it does not replace platform-specific compliance, brand review, or legal approval before posting.