Postiz Agent

Social Media CLI for AI Agents

Automate social media posting across 30+ platforms. Built for AI agents like Claude and OpenClaw to schedule, publish, and manage your social media presence from the command line.

View Docs ClawHub

Please make sure there is always a human in the loop.

Get Started in Seconds

Terminal

# Install globally
npm install -g postiz

# Set your API key
export POSTIZ_API_KEY=your_api_key

# List your connected platforms
postiz integrations:list

# Create your first post
postiz posts:create \
  -c "Hello from Postiz Agent!" \
  -s "2025-01-01T12:00:00Z" \
  -i "your-integration-id"

Built for Automation

🤖

AI Agent Ready

Every command outputs structured JSON. Designed for LLMs and automation pipelines to parse, plan, and execute social media workflows.

🌐

30+ Platforms

Post to Twitter/X, LinkedIn, Reddit, Instagram, YouTube, TikTok, and 22 more platforms from a single CLI.

🧵

Threads & Comments

Create threaded posts with multiple comments, each with their own media. Automatic conversion to platform-native threads.

📷

Rich Media Support

Upload and attach images, videos, audio, and documents. Supports PNG, JPG, MP4, MOV, PDF, and many more formats.

📅

Scheduled Posting

Schedule posts with precise timestamps, create drafts for review, and batch schedule entire content campaigns.

⚙️

Platform-Specific Settings

Dynamic discovery of platform features like Reddit flairs, YouTube playlists, Pinterest boards, and LinkedIn company pages.

How It Works

Discover Integrations

List all your connected social media accounts and discover platform-specific features like subreddit flairs and YouTube playlists.

Discovery

postiz integrations:list

# Get platform settings
postiz integrations:settings <id>

# Fetch platform-specific data
postiz integrations:trigger <id> getFlairs \
  -d '{"subreddit":"programming"}'

Create Posts

Compose posts with content, media, comments, and platform-specific settings. Use simple CLI flags for quick posts or JSON files for complex campaigns.

Post Creation

# Simple post
postiz posts:create \
  -c "Check out our new feature!" \
  -m "screenshot.png" \
  -s "2025-01-15T09:00:00Z" \
  -i "twitter-id,linkedin-id"

# Complex post from JSON
postiz posts:create --json campaign.json

Manage & Scale

List, filter, and manage your scheduled posts. Build batch workflows to schedule entire content campaigns programmatically.

Management

# List scheduled posts
postiz posts:list

# Filter by date range
postiz posts:list \
  --startDate "2025-01-01T00:00:00Z" \
  --endDate "2025-01-31T23:59:59Z"

# Upload media for reuse
postiz upload video.mp4

One Command, Every Platform

Post to multiple platforms simultaneously, each with their own media and platform-specific settings.

Terminal

# Post to multiple platforms at once
postiz posts:create \
  -c "Launching our new feature today!" \
  -m "banner.png" \
  -s "2025-03-01T09:00:00Z" \
  -i "twitter-id,linkedin-id,facebook-id"

# Post with threaded comments
postiz posts:create \
  -c "Main announcement post" -m "hero.png" \
  -c "First follow-up comment" -m "demo.gif" \
  -c "Links and resources" \
  -s "2025-03-01T09:00:00Z" \
  -i "twitter-id,reddit-id"

# Post with platform-specific settings
postiz posts:create \
  -c "Check out this tutorial" \
  -m "video.mp4" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"New Tutorial","type":"text"}}]}' \
  -i "reddit-id"

# Batch schedule a week of content
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Day $day content" \
    -s "2025-03-0${day}T09:00:00Z" \
    -i "twitter-id,linkedin-id"
done

Works With Your AI Agent

Postiz Agent outputs structured JSON and ships with a SKILL.md file, making it a natural fit for AI agents that can execute CLI commands.

Claude

by Anthropic

Use Postiz Agent directly from Claude Code as a CLI tool. Claude reads the SKILL.md file to understand all available commands, then autonomously discovers your integrations, composes posts, and schedules content across platforms.

Claude Code

> Schedule a tweet for tomorrow morning
  announcing our new feature, attach
  the screenshot from ./assets/launch.png

Claude will automatically run:
  postiz integrations:list
  postiz upload ./assets/launch.png
  postiz posts:create \
    -c "We just launched..." \
    -m "uploaded-url" \
    -s "2025-03-02T09:00:00Z" \
    -i "twitter-id"

🦀

OpenClaw

Open-source AI agent

Postiz Agent ships with built-in OpenClaw support. Install the CLI globally and OpenClaw automatically discovers it as a skill, letting it schedule posts, manage campaigns, and handle multi-platform publishing on your behalf.

OpenClaw

> Post my blog article to Twitter,
  LinkedIn, and Reddit with a summary
  and the cover image

OpenClaw will automatically run:
  postiz integrations:list
  postiz upload ./cover.png
  postiz posts:create \
    -c "New blog post: ..." -m "url" \
    -s "2025-03-01T10:00:00Z" \
    -i "twitter-id,linkedin-id,reddit-id"

Why AI Agents Love Postiz

✓Every command returns structured JSON for easy parsing
✓Built-in SKILL.md provides full command documentation
✓Discovery workflow lets agents explore available platforms
✓Platform-specific tools (flairs, playlists, boards) are dynamically queryable
✓No SDK needed — any agent that can run CLI commands works

SKILL.md (auto-discovered)

name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms
allowed-tools: Bash(postiz:*)

# Agents read this file to learn:
# - Available commands
# - Required environment variables
# - Workflow patterns
# - Platform-specific settings

Command Reference

Command	Description
`postiz integrations:list`	List all connected social media accounts
`postiz integrations:settings <id>`	Get platform-specific settings schema
`postiz integrations:trigger <id> <method>`	Trigger platform tools (flairs, playlists, etc.)
`postiz posts:create`	Create and schedule a new post
`postiz posts:list`	List all scheduled and published posts
`postiz posts:delete <id>`	Delete a scheduled post
`postiz upload <file>`	Upload media and get a reusable URL

30+ Supported Platforms

Connect once, post everywhere. Postiz Agent supports all major social networks and publishing platforms.

Twitter/XLinkedInLinkedIn PageRedditInstagramFacebookThreadsYouTubeTikTokPinterestDiscordSlackMastodonBlueskyTelegramMediumDev.toHashnodeWordPressDribbbleTwitchKickLemmyFarcasterNostrVKGoogle My BusinessListMonkMoltbookSkoolWhop