doodle top mobile

Social Media Plugin for Grok Bot

Automate social media posting across 30+ platforms. Postiz is an official Grok Bot plugin, so your always-on Bots can schedule, publish, and manage your social media presence from their own cloud computer.

View DocsMarketplace

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

doodle left mobiledoodle right mobile

Get Started in Seconds

Grok Bot

# In any Bot chat, add the Postiz plugin
/add-plugin postiz

# Store POSTIZ_API_KEY as a Bot secret when prompted.
# Your Bot can now run Postiz on its cloud computer:

# 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

1

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"}'
2

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
3

Manage & Analyze

List, filter, and manage your scheduled posts. Track performance with platform and post-level analytics. Build batch workflows to schedule entire content campaigns programmatically.

Management & Analytics

# List scheduled posts
postiz posts:list

# Get platform analytics (last 30 days)
postiz analytics:platform <id> -d 30

# Get analytics for a specific post
postiz analytics:post <post-id> -d 7

# 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

What is Grok Bot?

Grok Bot is the always-on AI teammate product from xAI and Cursor. You create named Bots, give each one a job, and they work 24/7 on their own persistent cloud computer โ€” with a browser, a filesystem, and a terminal โ€” pinging you only when they need approval.

Grok Bot is not the Grok chatbot. Grok is the assistant you chat with on X and grok.com. Grok Bot is a separate app for delegating real, multi-step work โ€” like running your social media with Postiz.

๐Ÿ’ป

Own Cloud Computer

Every Bot gets a persistent cloud machine with a terminal. Postiz runs there, so posts go out even when your laptop is closed.

๐Ÿ”

Routines

Turn any task into a routine that runs on a schedule. Your Bot drafts, schedules, and reports on social content without being asked twice.

๐Ÿ›ก๏ธ

Approvals Built In

Bots ask before changing external systems. Review the posts your Bot prepared in Postiz, approve, and it publishes.

How Postiz Works with Grok Bot

Postiz is listed on the Grok Bot plugin marketplace. Add it to a Bot and the Postiz skill, CLI, and command reference are installed on its cloud computer โ€” no manual setup.

  • โœ“Type /add-plugin postiz in a Bot chat, or add it from the Plugins sidebar
  • โœ“Store your POSTIZ_API_KEY as a Bot secret when prompted
  • โœ“The Bot reads the bundled SKILL.md and learns every Postiz command
  • โœ“Works in every Bot on your shared workspace, on desktop and iPhone

Grok Bot

# 1. Add the plugin to your Bot
/add-plugin postiz

# 2. Store your Postiz API key
#    as a secret when prompted

# 3. Ask your Bot to verify
You: List my connected Postiz channels

Bot: Running postiz integrations:list
  - X (Twitter)  @postiz
  - LinkedIn     Postiz
  - Reddit       u/postiz
  All Postiz commands are ready.

Post With Grok Bot

Message your Bot what to post โ€” it connects to Postiz, discovers your integrations, and handles the entire publishing workflow on its own cloud computer.

๐Ÿง 

Chat Workflow

Natural language commands

Tell your Bot what to post in natural language, from the desktop app or your iPhone. It connects to Postiz, discovers your accounts, uploads media, and schedules posts โ€” then asks you to approve before anything goes live.

Grok Bot

You: Post my blog article to Twitter,
  LinkedIn, and Reddit with the cover
  image, schedule for tomorrow at 9am

Bot: On it. Here's the plan:
  1. Found your integrations via Postiz
  2. Uploading cover image
  3. Drafting 3 platform-specific posts

  Ready for approval:
  - X (Twitter): tomorrow 9:00 AM
  - LinkedIn: tomorrow 9:00 AM
  - Reddit (r/programming): tomorrow 9:00 AM
  Approve to schedule?
๐Ÿง 

Routines

Recurring work on a schedule

Save any task as a routine. Your Bot runs it on a schedule from its cloud computer, drafting and publishing content while you are offline.

Grok Bot routine

Routine: daily-social-posts
Schedule: Weekdays at 8:00 AM

Instructions:
  Check ~/content/drafts on your cloud
  computer for new posts. Schedule
  them to all my social platforms for
  noon today via Postiz. Move published
  drafts to ~/content/published and
  send me a summary.

# Every weekday your Bot will:
#   1. Read the drafts folder
#   2. Format each post per platform
#   3. Schedule via Postiz
#   4. Report back in your chat

Why Grok Bot + Postiz

  • โœ“Official plugin โ€” one command install from the marketplace
  • โœ“Always on โ€” Bots keep posting from the cloud while you are away
  • โœ“Terminal access โ€” runs Postiz CLI commands directly
  • โœ“Routines โ€” automate recurring social media workflows
  • โœ“Cross-post to multiple platforms in a single request
  • โœ“Human in the loop โ€” approvals before anything is published

SKILL.md (bundled in the plugin)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms
metadata:
  grok-bot:
    plugin: postiz
    secrets:
      - POSTIZ_API_KEY
    binaries:
      - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

Also Works with Claude Code

Postiz Agent is a CLI tool โ€” it works with any AI agent that can run shell commands, including Anthropic's Claude Code.

C

Claude Code

Anthropic's agentic coding tool

Claude Code reads the SKILL.md file to learn all available Postiz commands. It autonomously discovers your integrations, uploads media, composes posts with platform-specific settings, and schedules content across all your connected platforms.

Claude Code

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

Claude Code 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"

Command Reference

CommandDescription
postiz integrations:listList 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:createCreate and schedule a new post
postiz posts:listList all scheduled and published posts
postiz posts:delete <id>Delete a scheduled post
postiz analytics:platform <id>Get analytics for an integration/channel
postiz analytics:post <id>Get analytics for a specific post
postiz upload <file>Upload media and get a reusable URL

Start automating today

Add the Postiz plugin and let Grok Bot handle social media posting across all your platforms.

Ready to get started?

Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.

Grow your social media presence with Postiz.