Social cli

Skill social-cli/social-cli-skill/social-cli

Install

npx -y skills add social-cli/social-cli-skill --skill social-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Social media automation for AI agents — post, schedule, analyze, and manage across 15 platforms via CLI or MCP server.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

4.8 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it

Social CLI — Social Media Automation for AI Agents

Automate social media posting across 15 platforms. Every command outputs structured JSON. MCP-native — plug into Claude, Cursor, ChatGPT, or any agent runtime.

Setup

# Install
npm install -g social-cli

# Set credentials
export SOCIAL_CLI_API_KEY=sk_your_api_key_here
export SOCIAL_CLI_API_URL=https://backend.socialcli.xyz

# Verify
social-cli auth:check

Available Commands

Accounts

social-cli accounts list — List all connected social media accounts
social-cli accounts health — Check token validity of all accounts
social-cli accounts connect <platform> — Get OAuth URL to connect a platform
social-cli accounts disconnect <accountId> — Disconnect an account
social-cli accounts bluesky <handle> <appPassword> — Connect Bluesky via credentials

Posts

social-cli posts create -c <content> -p <platform> -a <accountId> [options] — Create/schedule a post
social-cli posts list [--status <status>] [--platform <platform>] [--limit <n>] — List posts
social-cli posts get <postId> — Get post details
social-cli posts delete <postId> — Delete a post
social-cli posts retry <postId> — Retry a failed post
social-cli posts stats — Get post counts by status
social-cli posts validate -c <content> -p <platform> -a <accountId> — Validate before posting

Media

social-cli upload <filePath> — Upload a local file, returns publicUrl for use in posts
social-cli upload:url — Get a raw presigned upload URL

Queue

social-cli queue list — Show posting queue schedule
social-cli queue set --slots <json> --timezone <tz> — Set queue schedule
social-cli queue next — Get next queue slot time
social-cli queue preview [--count <n>] — Preview upcoming queue times

Profile

social-cli profile get — Get your workspace profile
social-cli profile update [--name <name>] [--description <desc>] — Update profile

Analytics

social-cli analytics [--platform <platform>] [--limit <n>] [--page <n>] — Get post analytics
social-cli facebook-insights --account <accountId> — Get Facebook Page insights

Usage

social-cli usage — Get plan usage stats

Post Creation Examples

# Publish immediately to Twitter
social-cli posts create \
  -c "Hello from Social CLI!" \
  -p twitter \
  -a <accountId> \
  --now

# Schedule for a specific time
social-cli posts create \
  -c "Scheduled post content" \
  -p twitter \
  -a <accountId> \
  --schedule "2025-06-01T09:00:00Z"

# Post with image (upload first)
social-cli upload ./photo.jpg
# → returns: { "publicUrl": "https://..." }
social-cli posts create \
  -c "Post with image!" \
  -p twitter \
  -a <accountId> \
  --media "https://..." \
  --media-type image \
  --now

# Post to multiple platforms
social-cli posts create \
  -c "Cross-platform post!" \
  -p twitter -a <twitterAccountId> \
  -p instagram -a <instagramAccountId> \
  --now

# Add to queue
social-cli posts create \
  -c "Queued post" \
  -p twitter \
  -a <accountId> \
  --queue

MCP Server

Social CLI also ships as an MCP server for direct agent integration:

{
  "mcpServers": {
    "social-cli": {
      "url": "https://backend.socialcli.xyz/mcp/social-cli",
      "auth": "Bearer ${SOCIAL_CLI_API_KEY}"
    }
  }
}

35+ tools available via MCP: posting, scheduling, inbox, analytics, queue management, and more.

AI Agent Workflow

1. social-cli accounts list          → discover accountIds
2. social-cli upload ./image.png     → get publicUrl for media
3. social-cli posts create ...       → create/schedule post
4. social-cli posts list             → verify post was created
5. social-cli analytics              → check performance

Output Format

All commands output JSON:

{
  "status": "SUCCESS",
  "message": "...",
  "data": { ... }
}

Errors:

{
  "status": "ERROR",
  "message": "...",
  "data": null
}

Supported Platforms

Twitter/X, Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Reddit, Telegram, Discord, Bluesky, Snapchat, WhatsApp, Google Business, Threads

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Gives 0 of the 12 instructions most mcp tooling skills give in ~1.1k tokens

Counted across 638 of the 750 authors here whose files we hold, read 2026-08-07

Create ten complex or independent read-only evaluation questionsin 69 of 638, across 15 files
Test servers using MCP Inspectorin 61 of 638, across 19 files
Provide actionable error messages with specific next stepsin 54 of 638, across 12 files
Prioritize comprehensive API coverage over specific workflows or workflow toolsin 54 of 638, across 12 files
Use TypeScript and Streamable HTTP for remote servers or clientsin 54 of 638, across 8 files
Define structured output schemas where possiblein 50 of 638, across 8 files
Use Zod or Pydantic for input schemasin 47 of 638, across 5 files
Fetch MCP specification pages with markdown suffixin 46 of 638, across 4 files
Load framework documentation using WebFetchin 45 of 638, across 3 files
Verify each evaluation answer independentlyin 45 of 638, across 3 files
Implement API client with authentication and paginationin 45 of 638, across 3 files
Define input schemas with validationin 27 of 638, across 9 files

Said here and by no other author read

install the package globally
verify authentication credentials
list connected accounts before posting
upload media files before creating posts
validate posts before creating them
verify posts were created by listing them

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.