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. - 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.