simplified-cli

Simplified CLI — Social Media Automation for AI Agents

Agentic social media automation CLI for Simplified.com. Schedule and publish to 10 platforms simultaneously, analyze performance, process images, and generate AI images with 20+ models — JSON-native output designed for AI agents, LLM workflows, and automated pipelines.

What is Simplified CLI?

Simplified CLI is an open-source social media automation tool that lets AI agents and developers schedule posts, pull analytics, and generate AI images across 10 platforms (Instagram, TikTok, LinkedIn, YouTube, and more) — entirely from the command line.

Why Simplified CLI?

Feature	Simplified CLI	Buffer API	Hootsuite API
AI image generation	✅ 20+ models	❌	❌
Agentic / LLM-ready (JSON output)	✅	⚠️ partial	⚠️ partial
Video tools	✅	❌	❌
Platforms	10	6	10
Open source CLI	✅	❌	❌
Claude Code plugin	✅	❌	❌

Simplified CLI is the only social media scheduling tool built natively for agentic AI workflows — with JSON output, async task polling, and AI image generation built in.

Use Cases

• AI agents & LLM pipelines — autonomous social media posting driven by Claude, GPT, or any LLM via tool use
• Marketing automation — bulk scheduling, cross-platform posting, and performance analytics from CI/CD or cron
• Content teams — generate AI images, remove backgrounds, and publish in a single pipeline
• Developers — scriptable social media API for custom automation workflows
• Claude Code users — install as a plugin and manage social media directly from your AI coding assistant
• OpenClaw users — run Simplified CLI commands directly from your open-source AI agent via shell tool use

Installation

npm (global)

npm install -g simplified-cli

Claude Code plugin

/plugin marketplace add celeryhq/simplified-cli
/plugin install simplified-cli

Setup

Get your API key from Simplified.com → Settings → API Keys, then export it:

export SIMPLIFIED_API_KEY=your_api_key_here

Agentic Workflows & LLM Integration

All commands print JSON to stdout. Errors go to stderr with a non-zero exit code — making Simplified CLI a reliable tool for agentic pipelines, LLM tool use, and autonomous social media workflows.

Discovery workflow for AI agents:

1. Run accounts:list to get account IDs — the id field is required by all other commands
2. Filter by platform with --network <platform> if needed
3. Use posts:create, analytics:*, or image:* with the discovered IDs

Async image workflow:

• Without --wait: returns {"task_id":"..."} immediately
• With --wait: blocks until done (timeout: 120 s), prints final result JSON to stdout
• Manual poll: simplified image:task --id <task_id>
• Status values: pending → completed / success (result ready) or failed

Commands

Accounts

# List all connected accounts
simplified accounts:list

# Filter by platform
simplified accounts:list --network instagram

Supported platforms: facebook · instagram · linkedin · tiktok · tiktokBusiness · youtube · pinterest · threads · google · bluesky

Response key fields: id (use in --accounts / -a), name, type (platform name)

---

Social Media Scheduling

# Queue a post
simplified posts:create -c "Hello world!" -a "ACCOUNT_ID" --action add_to_queue

# Publish to multiple platforms simultaneously
simplified posts:create -c "Launch day!" -a "INSTAGRAM_ID,LINKEDIN_ID,BLUESKY_ID" --action add_to_queue

# Schedule a post
simplified posts:create -c "Launching soon!" -a "ACCOUNT_ID" --action schedule \
  --date "2026-04-01 09:00"  # format: YYYY-MM-DD HH:MM, timezone: UTC (override with --timezone)

# Save as draft
simplified posts:create -c "Work in progress" -a "ACCOUNT_ID" --action draft

# Post with media
simplified posts:create -c "Check this out" -a "ACCOUNT_ID" --action add_to_queue \
  --media "https://example.com/image.jpg"

# Complex post from JSON file (multi-platform, platform-specific settings)
simplified posts:create --json post.json

Actions: add_to_queue · schedule (requires --date "YYYY-MM-DD HH:MM") · draft

Platform-specific settings (--additional): Pass a JSON string for per-platform options (Instagram postType/channel, TikTok privacyStatus, YouTube post.title, etc.). See skills/simplified-cli/references/PLATFORM_GUIDE.md for all options.