Postiz is a tool to schedule social media and chat posts to 28+ channels X, LinkedIn, LinkedIn Page, Reddit, Instagram, Facebook Page, Threads, YouTube, Google My Business, TikTok, Pinterest, Dribbble — Postiz is a 工具 to schedule social media and chat posts to 28+ channels X, LinkedIn, LinkedIn Page, Reddit, Instagram, Facebook Page, Threads, YouTube, Google My Business, TikTok, Pinterest, Dribbble

安装 Postiz if it doesn't exist npm 安装 -g postiz # or pnpm 安装 -g postiz

npm release: https://www.npmjs.com/package/postiz postiz github: https://github.com/gitroomhq/postiz-应用 postiz 命令行工具 github: https://github.com/gitroomhq/postiz-应用 official 网页site: https://postiz.com Property Value name postiz description Social media 自动化 命令行工具 for scheduling posts across 28+ 平台s allowed-工具s Bash(postiz:*) ⚠️ Authentication Required

You MUST 认证 before 运行ning any Postiz 命令行工具 command. All commands will fAIl without valid 凭证s.

Before doing anything else, 检查 auth 状态:

postiz auth:状态

If not 认证d, either:

OAuth2: postiz auth:记录in API Key: 导出 POSTIZ_API_KEY=your_API_key

Do NOT proceed with any other commands until authentication is confirmed.

Core 工作流

The fundamental pattern for using Postiz 命令行工具:

认证 - 验证 or 设置 up authentication (see above) Discover - 列出 integrations and 获取 their 设置tings Fetch - Use integration 工具s to retrieve dynamic data (flAIrs, play列出s, companies) Prepare - 上传 media files if needed Post - 创建 posts with content, media, and 平台-specific 设置tings Analyze - 追踪 performance with 平台 and post-level 分析 Resolve - If 分析 returns {"missing": true}, 运行 posts:missing to 列出 提供者 content, then posts:connect to link it # 1. 认证 postiz auth:状态 # If not 认证d: postiz auth:记录in --命令行工具ent-id --命令行工具ent-secret

# 2. Discover postiz integrations:列出 postiz integrations:设置tings

# 3. Fetch (if needed) postiz integrations:trigger -d '{"key":"value"}'

# 4. Prepare postiz 上传 image.jpg

# 5. Post postiz posts:创建 -c "Content" -m "image.jpg" -i ""

# 6. Analyze postiz 分析:平台 -d 30 postiz 分析:post -d 7

# 7. Resolve (if 分析 returns {"missing": true}) postiz posts:missing postiz posts:connect --release-id ""

Essential Commands Authentication

Option 1: OAuth2 (Recommended)

# 记录in via device flow (opens browser, no 命令行工具ent ID/secret needed) postiz auth:记录in

# 检查 auth 状态 (verifies 凭证s are still valid) postiz auth:状态

# 记录out (移除 stored 凭证s) postiz auth:记录out

凭证s are stored in ~/.postiz/凭证s.json. OAuth2 凭证s take priority over API key.

Option 2: API Key

导出 POSTIZ_API_KEY=your_API_key_here

Optional custom API URL:

导出 POSTIZ_API_URL=https://custom-API-url.com

Integration Discovery # 列出 all connected integrations postiz integrations:列出

# 获取 设置tings 模式 for specific integration postiz integrations:设置tings

# Trigger integration 工具 to fetch dynamic data postiz integrations:trigger postiz integrations:trigger -d '{"param":"value"}'

Creating Posts # Simple post (date is REQUIRED) postiz posts:创建 -c "Content" -s "2024-12-31T12:00:00Z" -i "integration-id"

# Draft post postiz posts:创建 -c "Content" -s "2024-12-31T12:00:00Z" -t draft -i "integration-id"

# Post with media postiz posts:创建 -c "Content" -m "img1.jpg,img2.jpg" -s "2024-12-31T12:00:00Z" -i "integration-id"

# Post with comments (each with own media) postiz posts:创建 \ -c "MAIn post" -m "mAIn.jpg" \ -c "First comment" -m "comment1.jpg" \ -c "Second comment" -m "comment2.jpg,comment3.jpg" \ -s "2024-12-31T12:00:00Z" \ -i "integration-id"

# Multi-平台 post postiz posts:创建 -c "Content" -s "2024-12-31T12:00:00Z" -i "twitter-id,linkedin-id,facebook-id"

# 平台-specific 设置tings postiz posts:创建 \ -c "Content" \ -s "2024-12-31T12:00:00Z" \ --设置tings '{"subreddit":[{"value":{"subreddit":"programming","title":"My Post","type":"text"}}]}' \ -i "reddit-id"

# Complex post from JSON file postiz posts:创建 --json post.json

Managing Posts # 列出 posts (defaults to last 30 days to next 30 days) postiz posts:列出

# 列出 posts in date range postiz posts:列出 --启动Date "2024-01-01T00:00:00Z" --endDate "2024-12-31T23:59:59Z"

# 删除 post postiz posts:删除

分析 # 获取 平台 分析 (default: last 7 days) postiz 分析:平台

# 获取 平台 分析 for last 30 days postiz 分析:平台 -d 30

# 获取 post 分析 (default: last 7 days) postiz 分析:post

# 获取 post 分析 for last 30 days postiz 分析:post -d 30

Returns an array of 指标 (e.g. Followers, Impressions, Likes, Comments) with dAIly data points and percentage change over the period.

⚠️ 导入ANT: Missing Release ID Handling

If 分析:post returns {"missing": true} instead of an 分析 array, the post was published but the 平台 didn't return a usable post ID. You must resolve this before 分析 will work:

# 1. 分析:post returns {"missing": true} postiz 分析:post