gitroomhq/postiz-agent

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

它是什麽

postiz-agent 是一个轻量级封装，让 AI 代理（ChatGPT、Claude、Gemini 等）能够在各种 AI 代理生态系统（Claude Code、Cursor、Gemini、Grok Build、DeepSeek Harness 等）中调用 Postiz CLI。底层的 Postiz CLI 会与 Postiz SaaS 平台沟通，该平台提供统一的 API，用于在数十个平台（Twitter/X、LinkedIn、Reddit、TikTok、Instagram、YouTube、Facebook 等）上排程并发布社交媒体贴文。

谁会使用它

开发 AI 助理工具的开发者：需要自动发布内容，例如一个能草拟推文并排程的 ChatGPT 插件。
产品团队：希望将 Postiz 作为内置“技能”整合到自己的 AI 代理平台（Claude Code、Cursor、Gemini 等）中。
进阶用户：已经在使用 Postiz CLI，并希望在不编写自定义胶水代码的情况下，从对话式 AI 中触发它。

核心组件（如 README 所述）

组件	功能
技能/CLI 整合	在主机代理中注册 `postiz` 技能。该技能将指令转发给全局安装的 `postiz` npm CLI（需另外安装）。
清单文件	为每个主机平台提供所需的插件清单（`.grok-plugin`、`.cursor-plugin`、`gemini-extension.json`、DeepSeek Harness 套件等）。
MCP 服务器注册	对于支持 MCP (Multi-Channel Publishing) 服务器的平台，插件会指向托管的 Postiz MCP 端点 (`https://mcp.postiz.com/mcp-oauth-dynamic`)。这处理了代理的 OAuth 流程与令牌存储。
Postiz CLI	真正的核心工具 – 负责验证（OAuth 设备流程或 API 密钥）、列出整合项目、上传媒体、创建/排程贴文、获取分析数据、执行 YouTube 剪辑等。所有指令皆输出 JSON，方便代理解析。

实际运作方式（示例流程）

安装技能 – 例如 npx skills add gitroomhq/postiz-agent 或通过 Cursor 市场。
验证 – 代理首次执行时，会开启浏览器进行 Postiz OAuth 设备流程并存储凭证。
代理调用技能 – 用户询问 AI：“为明天排程一条关于我们新功能的推文”。代理使用 postiz 技能来：
- 列出可用的 Twitter 整合项目 (postiz integrations:list)。
- 可能通过 postiz integrations:trigger 获取动态数据（例如热门标签）。
- 上传任何媒体 (postiz upload image.png)。
- 发出 postiz posts:create … 指令，包含内容、排程时间、整合 ID 与媒体 URL。
Postiz API 接收请求，将贴文排入队列，随后在选定的平台上发布。

仓库实际包含的内容

适用于多种 AI 代理生态系统的 插件清单。
关于如何在每个环境中安装技能的文档。
关于验证与使用底层 postiz CLI 的说明。
适用于 DeepSeek Harness 套件的 辅助脚本。

限制 / 注意事项

本仓库本身不实现任何 AI 模型；它仅将现有的代理连接到 Postiz 服务。
必须全局安装 postiz CLI (npm i -g postiz)，且用户必须拥有 Postiz 账号/API 密钥。
某些平台（TikTok、Instagram）要求媒体必须先上传到 Postiz；README 强调这是必要步骤。

总结

postiz-agent 是一组插件清单，将 Postiz 社交媒体自动化 CLI 作为技能公开给许多热门的 AI 代理平台，让这些代理能够以程序化方式在 28 个以上的社交网络上排程与管理贴文。