1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | postiz-agent |
| 作者/维护者 | Nevo David（gitroomhq / Postiz） |
| 来源链接 | https://github.com/gitroomhq/postiz-agent |
| 许可证 | AGPL-3.0（数据来自仓库 LICENSE 文件） |
| GitHub Stars | 387（数据来自 GitHub API） |
| Forks | 67（数据来自 GitHub API） |
| 最新版本 | postiz@2.0.15（npm，2026-06-02 发布，数据来自 npm registry） |
| 安装方式 | npm / npx skills add / ClawHub |
2. 功能介绍与亮点
Postiz Agent 是一个把社交媒体发布能力交给 agent 操作的命令行技能：通过 postiz CLI，agent 可以向 X、LinkedIn、Reddit、Instagram、Facebook、YouTube、TikTok、Pinterest、Discord、Slack、Bluesky、Mastodon 等 28+ 渠道创建、上传媒体、排程并发布内容，同时可拉取各平台的发文分析数据。
核心工作流分七步：认证 → 发现已连接账号 → 拉取渠道动态数据 → 上传媒体 → 创建帖子 → 追踪分析 → 补全缺失的发布记录。帖子默认以「草稿」状态创建，需要再执行一次显式命令（posts:status --status schedule）才会进入实际发布队列，这个两段式设计避免了 agent 一次调用就把内容直接推上线。
亮点：
- 背靠开源社交发布平台 Postiz（GitHub 3.4 万+ star、6300+ fork，AGPL-3.0 开源、可自托管），不是从零起步的新项目
- 提供 OAuth2 设备授权流程（无需手动填 client id/secret）与 API Key 两种鉴权方式
- 文档极为完整：798 行 SKILL.md、746 行 README，另附 QUICK_START、FEATURES、HOW_TO_RUN 等专项指南
- 官方声明该 CLI 是模型无关设计，“works with any LLM backend: Claude, GPT, Gemini, Llama, and more”
3. 适用场景
所属分类：集成与工作流自动化
适合需要用 agent 批量管理多平台社交媒体发布的开发者、内容运营团队与自媒体创作者——例如让 Claude Code 把一篇长文拆解成适配不同平台的多条帖子，统一排程发布；或者作为团队内容日历的执行层，把“写什么”留给人、把“发到哪、什么时候发”交给 agent 按指令执行。
4. 跨 Agent 兼容性
- Claude Code：原生支持。官方页面明确写明安装与用法：agent 读取 SKILL.md 自动发现可用命令，可通过
npx skills add gitroomhq/postiz-agent直接安装并使用 - OpenClaw：原生支持。官方提供专属安装命令
clawhub install nevo-david/postiz，且 SKILL.md 内置openclaw专属 metadata 字段（声明所需环境变量） - Codex：官方设有专属集成介绍页面，具体接入方式未验证
- Hermes Agent：官方设有专属集成介绍页面，具体接入方式未验证
5. 推荐理由
Postiz Agent 把一个已经过市场验证的开源社交发布产品，打包成了标准 Agent Skill：一条命令安装，agent 就能操作用户自己已连接的社交账号完成排程发布，且默认走“先建草稿、再显式排程”的两步流程，不会一次调用就把内容直接推上线。文档详尽，本地实测 CLI 可正常安装并执行核心命令。对于经常要往多个平台批量发布内容、又希望把“发布”这个动作交给 agent 处理的开发者和内容团队，这是目前少见的、专门为 agent 使用场景重新设计过交互方式的社交发布工具。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 母产品 Postiz 在 GitHub 拥有 3.4 万+ star、6300+ fork 的社区基础；postiz-agent 专属仓库 387 star；npm 包 postiz 近 30 天下载量约 5,853 次；第三方商业案例报道记录其“面向 AI Agent 场景重新定位”后月经常性收入从 2026 年 3 月的 2.1 万美元增长至 7 月的 14.5 万美元 |
| 可用性 | 8 | npm install -g postiz 或 npx skills add 一条命令安装；文档（SKILL.md/README/专项指南）齐全；在 Node v22 环境下实测安装并执行 --version/auth:status/--help，均正常返回；最近一次功能提交为 2026-06-02（约 2 个月前） |
| 安全性 | 8 | 逐项见下表 |
安全检查清单
| 检查项 | 结果 |
|---|---|
| ① Shell 命令权限范围 | allowed-tools 限定为 Bash(postiz:*)，范围明确，不涉及任意 shell 执行 |
| ② 运行时联网外发 | 向用户自己已连接的社交账号发布内容，是该技能的核心功能，过程透明、无隐蔽外发 |
| ③ 凭据存储方式 | OAuth2 凭据保存在本地 ~/.postiz/credentials.json，或经环境变量 POSTIZ_API_KEY 传入，文档写明 |
| ④ 可疑指令 | 全文（SKILL.md 798 行 + README 746 行）未发现 prompt injection 或隐蔽指令迹象 |
| ⑤ 作者/组织信誉 | 母产品为知名开源项目，作者身份（Nevo David，gitroomhq）可查，未见刷星或自我造假迹象 |
| ⑥ License | AGPL-3.0，明确 |
| ⑦ 最近维护时间 | 最近一次功能提交 2026-06-02，约 2 个月前 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 覆盖平台 | 与 Postiz Agent 的差异 |
|---|---|---|---|
| Typefully Agent Skills（typefully/agent-skills，56★，MIT） | Typefully 官方出品的 agent 技能，专注草稿与排程 | X / LinkedIn / Threads / Bluesky / Mastodon 共 5 个平台 | 平台覆盖明显窄于 Postiz 的 28+，但对 X 长推文串的排版做了专项优化；依赖 Typefully 付费订阅 |
| Ayrshare（经 Rube MCP 接入） | 把 Ayrshare 的社交发布 API 封装成 MCP 服务 | 多平台 | 走的是 MCP 协议而非 Agent Skill 规范，安装方式是接入 MCP 网关，与直接装一个 SKILL.md 的路径不同 |
| Buffer | 主流商业排程工具 | 多平台 | 官方未提供面向 agent 的直接接入方式，需要 agent 先生成 CSV，再手工导入 Buffer 后台，无法在对话内闭环完成排程 |
8. 用户评价
该技能包本身在第三方平台尚未见到具名用户评价。其母产品 Postiz 自 2024 年 9 月起多次在 Hacker News 的 Show HN 版块发布，持续获得社区关注；行业案例报道 Superframeworks（2026-07-04 发布）记录该产品面向 AI Agent 场景重新定位后，月经常性收入从 2026 年 3 月的 2.1 万美元增长到 7 月的 14.5 万美元，年化收入约 200 万美元，由一位独立开发者维护。
9. 其他补充
官方强调该 CLI 为模型无关设计，理论上可配合任何能执行 bash 命令、读取 Markdown 指令的 agent 使用，不绑定单一厂商。同时提供 OAuth2 授权服务器的自托管选项（server/SERVER.md），适合对凭据托管位置有要求的团队。
10. 安装使用方式
# 方式一：npm 全局安装
npm install -g postiz
# 或 pnpm install -g postiz
# 方式二：作为 Claude Code 技能安装
npx skills add gitroomhq/postiz-agent
# 方式三：OpenClaw / ClawHub
clawhub install nevo-david/postiz鉴权（二选一）：
postiz auth:login # OAuth2 设备授权流程
export POSTIZ_API_KEY=your_api_key_here # 或使用 API Key安装后注意事项：需要先在 Postiz 平台（自托管或官方云服务）连接好目标社交账号，CLI 才能发现并调用这些集成；无需重启 agent，装完技能后在对话中直接用自然语言描述排程需求即可触发。
11. 注意事项
- GitHub 上有一个未解决的 issue（#9，2026-06-24 提出）报告在 Node 18-22 环境下所有命令都会因 ESM/CommonJS 依赖冲突而失败；在 Node v22.22.3 + npm 环境下实测
--version/auth:status/--help均正常执行，未复现该问题，可能与具体包管理器或依赖解析路径有关，建议安装后先自行验证一次 - 部分社交平台（如 Reddit）的服务条款可能限制第三方自动化发布工具的使用，存在账号被限制的风险，使用前请自行确认目标平台政策
- 许可证为 AGPL-3.0，若基于该 CLI 二次开发商业化产品需留意相应的开源义务
- 核心发布能力依赖用户自行在 Postiz 平台连接社交账号，CLI 本身不提供账号托管或获取