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:
- Run
accounts:list to get account IDs — the id field is required by all other commands
- Filter by platform with
--network <platform> if needed
- 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.