FrancoStino/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

npx skills add ndesv21/socialclaw

Or install the npm package directly:

npm install [email protected]

Configuration

Set your workspace API key:

export SOCIALCLAW_API_KEY=your_workspace_api_key

Get your API key at 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 Website: 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.