CLI - Autoposting

Post Publishing

Create, schedule, publish, retry, AI-rewrite, and AI-score posts across X, LinkedIn, YouTube, Instagram, and Threads.

Brand & Agent Management

Manage brands, platform connections, and AI-powered autonomous posting agents.

AI Content Generation

Generate ideas, create carousels, clip videos, and search knowledge bases with AI.

Built-in MCP Server

Run ap mcp to expose 55 tools to Claude Desktop, Cursor, or any AI agent.

Install

npm install -g @autoposting.ai/cli

Both autoposting and ap (short alias) are available after install.

Quick Start

# Authenticate
export AUTOPOSTING_API_KEY=sk-social-your-key

# Create and publish a post
ap posts create --brand my-brand --text "Hello world!" --platforms x,linkedin
ap posts publish <post-id>

# Set a default brand, then omit --brand everywhere
ap config set-context --brand my-brand
ap posts create --text "Launch day!" --platforms x,linkedin \
  --media ./hero.png --at 2026-07-01T09:00:00Z --account x=@myhandle

# Run an AI agent
ap agents run <agent-id>

# Generate content ideas
ap ideas generate --topic "AI trends" --count 5

# Health check
ap doctor

Command Domains

Domain	Commands	Description
Posts	10	Create (media, threads, per-account, scheduled, bulk), publish, schedule/unschedule, retry, AI-rewrite, AI-score
Brands	9	CRUD, platform auth status, default-account defaults
Agents	8	Create, run, toggle, view run history
Knowledge Base	7	Create, search, ingest URLs, list docs
Clips	6	Upload, import, render, manage video clips
Carousels	6	Create, AI-generate, convert to post draft
Webhooks	6	Create, test, manage event hooks
Auth	5	Device-code/browser login, profiles, switch, status
Ideas	4	AI-generate, enrich, manage ideas
Config	3	Default brand context (set/get/unset)
Billing	2	Plan status, credit balance
Workspaces	2	List, switch workspace
Usage	1	Publishing statistics
Utility	6	doctor, whoami, open, update, completion, mcp

Output Modes

Mode	When	Format
Interactive	TTY terminal	Tables, spinners, colors
JSON	`--json` or piped	Clean JSON for parsing
Quiet	`--quiet`	Errors only, no spinners

Global Flags

Flag	Description
`--api-key <key>`	Override API key
`--json`	JSON output
`--quiet`	Suppress non-essential output
`--format <type>`	`auto` (default — table on a terminal, JSON when piped), `table`, or `json`
`--jq <expr>`	Filter JSON output with a minimal jq expression (e.g. `.[].id`)
`--no-color`	Disable colors

Installation

Install, configure, and verify the CLI.

Commands

Full command reference with flags and examples.

MCP Server

Let AI assistants manage social media for you.

TypeScript SDK

Programmatic API access in Node.js.