Postiz Agents CLI - connect it to Claude / OpenClaw / etc, to schedule social media posts 🤖

Postiz Agent – AI 驱动的社交媒体自动化

它是什么 – 一个轻量级的包装器，允许大语言模型代理（ChatGPT、Claude、Gemini 等）调用 Postiz CLI，以便他们可以发现品牌的关联社交账户、获取平台特定数据，并在超过 28 个平台（Twitter/X、LinkedIn、Reddit、TikTok、Instagram、YouTube、Facebook 等）上安排或草拟帖子。该仓库提供了代理技能定义以及多个插件生态系统的清单（Claude Code、Cursor、Gemini、DeepSeek Harness、Grok Build 等）。

核心组件（如 README 所述）

组件	角色
Postiz CLI (`npm i -g postiz`)	Postiz API 的命令行客户端 – 处理 OAuth2/设备流登录、媒体上传、集成发现、帖子创建、分析、剪辑等。所有输出都是 JSON，便于代理解析。
代理技能 / 插件清单	向宿主环境（Claude Code、Cursor、Gemini、DeepSeek Harness、Grok Build 等）公开 `postiz` 技能的 JSON 文件。该技能只是将代理的自然语言请求转发给 Postiz CLI。
MCP 服务器集成	托管的 “Multi-Channel-Publishing” OAuth 端点（`https://mcp.postiz.com/mcp-oauth-dynamic`），技能在首次使用时进行认证 – 无需本地令牌。
安装辅助工具	一行命令（`npx skills add gitroomhq/postiz-agent`、`gemini extensions install …`、`dsh plugin …`），将技能注册到各自的生态系统中。

AI 代理如何使用它

发现集成 – postiz integrations:list → 关联账户的 JSON 列表（ID、提供商名称、组）。
获取平台限制和工具 – postiz integrations:settings <id> 或 postiz integrations:trigger <id> <method>（例如，获取 Reddit 标志、YouTube 播放列表、LinkedIn 公司）。
上传媒体 – postiz upload <file> 返回一个受信任的 URL，TikTok、Instagram、YouTube 等平台需要该 URL。
创建帖子 – postiz posts:create … 包含内容、媒体 URL、集成 ID、可选的复杂多平台草稿的 JSON 有效负载。
检查状态 / 分析 – postiz posts:list、postiz analytics:post、postiz analytics:platform。
解析缺失的 ID – 对于不立即返回帖子 ID 的平台（TikTok），使用 posts:missing + posts:connect。

所有步骤都由简单的 shell 命令驱动，使语言模型代理调用和解析变得轻而易举。

代理的主要功能

发现工作流 – 列出账户、读取每个提供商的模式、调用动态工具。
JSON 优先输出 – 每个 CLI 调用都返回机器可读的 JSON，非常适合 LLM 解析。
线程与评论 – 多个 -c 标志在支持的平台上创建线程帖子/评论。
媒体处理 – 强制上传步骤保证来自受信任域的 URL。
剪辑服务 – 将 YouTube 视频转换为带字幕的短视频，并跨频道自动草拟。
跨平台调度 – 一个命令可以同时针对多个集成 ID。
分析 – 检索参与度指标；内置对 “缺失” 帖子 ID 的处理。

谁可以使用？

开发 AI 助手的开发者 – 需要自动发布内容（例如，营销机器人、新闻摘要代理）。
将 Postiz 与 LLM 驱动的 IDE 集成的团队（Claude Code、Cursor） – 让 IDE 直接从代码中建议和安排社交媒体更新。
企业自动化管道 – 希望为 28 个以上社交网络提供统一 CLI，并可从任何兼容 LLM 的插件系统调用。

快速开始（代理端）

# 1. 在您的 LLM 环境中安装技能
npx skills add gitroomhq/postiz-agent   # Claude Code 等

# 2. 确保 Postiz CLI 已安装并登录
npm i -g postiz
postiz auth:login   # 设备流 OAuth

# 3. 代理脚本示例（伪代码）
integrations=$(postiz integrations:list | jq -r '.[] | select(.identifier=="twitter") .id')
media=$(postiz upload tweet.png | jq -r .path)
postiz posts:create -c "Hello world!" -m "$media" -s "$(date -Iseconds)" -i "$integrations"

底线

gitroomhq/postiz-agent 不是新的人工智能模型；它是一组插件清单和辅助脚本，让现有的 LLM 代理能够调用 Postiz 社交媒体自动化 CLI。它弥合了语言模型推理与在数十个平台上实际发布之间的差距，以 JSON 友好、即插即用的包提供发现、媒体处理、调度和分析功能。

gitroomhq/postiz-agent