SuperAPI AI 工具集

pendpost

pendpost 是一个免费、开源(MIT)、本地优先的社交媒体规划工具,采用「AI 智能体起草 + 人工审批门禁」的工作方式。它让 AI 智能体起草并排期发布内容,覆盖 Instagram、Facebook、LinkedIn、YouTube、X、Telegram、Discord、Mastodon、Nostr,以及 WordPress 和 Ghost 长文博客;Reddit、Pinterest、TikTok 和 Google Business Profile 处于 beta 阶段。它是 MCP 原生工具:智能体可以起草、做文案检查、排期并入队帖子,但未经人工批准不会发布。它面向开发者、代运营机构和懂技术的独立创业者,强调本地运行、无需注册账号,并内置防封号断路器、品牌文案检查(humanizer 反 AI 写作痕迹)和诚实的平台原生排期说明。数据保存在本机 data/ 目录,凭据仅存放在自己的 .env 中,默认绑定 127.0.0.1,不向官方回传数据。

访问官网

工具介绍

pendpost 是一个面向 AI 智能体工作流的社交媒体规划与排期工具,采用免费、开源(MIT)、本地优先、MCP 原生的设计。它的定位不是「带智能体的排期器」,而是一层围绕「智能体 + 人」协作流程构建的运营层。

一、用途 让 AI 智能体起草并排期社交媒体帖子,但发布前必须经过人工审批,避免把账号密钥直接交给智能体,也避免账号被平台标记。适用于希望智能体干活、但自己保留最终发布决定权的开发者、代运营机构和技术型独立创业者。

二、主要能力

  1. 人工审批门禁:每个帖子带有审批状态(draft、approved、rejected),采用 fail-closed 设计——没有审批的帖子不会发布。plan_create_post 始终创建草稿,只有 approve_post 或 reject_post 能改变状态。默认审批人是用户本人,auto-approve 仅限所有者且可撤销。
  2. 防封号断路器:Meta 错误 368(动作封锁)会触发断路器,暂停 Meta 通道且不自动恢复;健康探测在被封锁期间不发送任何 Graph 流量;节奏上限会推迟突发内容而非丢弃;还提供通道暂停的 kill switch。
  3. Humanizer 品牌文案检查:发布前按 rules.json 中可编辑的规则检查文案,humanizer 层会标记英文中的 AI 写作痕迹。错误会阻止发布,警告仅为提示。
  4. 诚实的原生排期:支持原生排期的平台(Facebook 预定帖子、YouTube publishAt)即使电脑关机也能按时发布;Instagram、LinkedIn、X 没有原生排期,需要 pendpost 运行中才能发布,可部署在常开主机上。
  5. 双界面:Web 仪表盘与任意 MCP 客户端驱动同一套契约,并通过一致性测试保证两边能力对等。
  6. 本地化:仪表盘、摘要和通知支持英文或瑞士德语(de-CH,含正确变音符号与 24 小时制瑞士日期),可在设置中切换。

三、使用方式

  • 单行命令、无需设置:无需账号、无需注册,pendpost 本地运行并立即启动;首次运行会附带一个示例「Acme Launch」活动(位于 data/plans),可立即看到真实内容。平台在 Setup 中连接前处于「已启用但未认证」状态,发布只会等待连接而不会伪造。
  • Claude Desktop:安装每个 GitHub release 附带的 pendpost .mcpb 包,它会自动启动 npx -y pendpost --stdio 并在同一进程中打开审批仪表盘。
  • 任意 stdio MCP 客户端:pendpost 通过原生 stdio 提供 MCP,客户端会自动启动服务器。
  • 高级/开发(HTTP 传输):pendpost 也在 /mcp 通过 streamable-HTTP 提供 MCP,需要先通过 npx pendpost 启动服务器。
  • 平台连接:在 Setup 页复制 AI 提示词配合 Claude for Chrome 可让智能体驱动各平台开发者门户的 OAuth 流程;所有登录/授权环节由用户本人完成,凭据由 CLI 在本地生成,不经过智能体或聊天。

四、适用范围 当前已上线平台:Instagram、Facebook、LinkedIn、YouTube、X、Telegram、Discord、Mastodon、Nostr、WordPress、Ghost。Beta 阶段:Reddit、Pinterest、TikTok、Google Business Profile。

五、限制与说明

  • 无原生排期的平台需要 pendpost 保持运行才能按时发布。
  • pendpost 默认绑定 127.0.0.1(回环地址),不回传任何数据,密钥仅存在本机 .env(已 gitignore)。
  • 数据保存在本机 data/ 目录;可选 24/7 云服务会保存计划、加密令牌和审计记录,退订后经短暂安全窗口删除托管副本。
  • 隐私政策见 pendpost.com/privacy。
  • 完整参考文档见 docs.pendpost.com。
  • 由小团队兼职维护且处于早期阶段,可能存在粗糙边缘。
  • 采用 MIT 许可,版权所有 2026 Nomadik GmbH。

六、MCP 工具 所有能力均为 MCP 工具,仪表盘同步提供。只读工具不能发布;写入工具创建草稿并受上述审批规则约束。工具分组包括:读取与检查(plan_list、plan_get、account_status、assets_list、activity_log、validate_media、platform_validate、pendpost_health、publish_preview、brand_lint、generate_digest、config_get、clients_overview);撰写(plan_create_post、plan_update_post、plan_delete_post、campaign_create、campaign_set_active);审批(approve_post、reject_post);排期与发布(scheduler_set、publish_due_run、reschedule、unschedule、mark_posted、verify_post);封面与素材(set_cover、clear_cover、asset_upload、rename_asset、delete_asset);洞察与安全(fetch_insights、token_refresh、pendpost_record_block、health_recheck、meta_lane_set);配置与客户(config_set、client_create、client_update、client_archive、client_list、client_set_active)。权威数量与读写划分由 lib/mcp.mjs 推导并经 test/parity-check.mjs 校验。

七、架构简述 pendpost 是一个零依赖的 Node 进程(server.mjs),提供四个面:/api 的 REST API、/mcp 的 MCP 服务器(streamable-HTTP、JSON-RPC 2.0)、/media 对 data/ 下本地文件的 range 流式传输,以及 / 提供构建好的 React 仪表盘。后端逻辑在 lib/*.mjs。scripts/ 中有 14 个发布引擎,每平台一个(meta-social.mjs 处理 Facebook 和 Instagram),在排期触发或按需作为子进程运行并输出 JSON 信封。计划与状态为本地 JSON。工作区根目录(含 .env、config.json、state.json、data/)可通过 PENDPOST_ROOT 覆盖。配置可在 Setup 中完成,或将 .env.example 复制为 .env 只填写使用的平台。使用多客户时可在命令后附加 --client <client-id>。X(Twitter)支持 OAuth 1.0a(推荐,无需浏览器)和 OAuth 2.0 PKCE(浏览器)两种认证路径。

八、品牌文案检查规则 规则集位于 rules.json,直接编辑即可。每条规则包含 id、severity(error 阻止发布,warn 为提示)、matcher(正则或平台感知的内置项如 captionLength、hashtagCount、allCaps、brokenLink)和 hint。默认规则包含标记英文 AI 写作痕迹的 humanizer 规则(AI 词汇、破折号、否定式排比、机械三段式、填充与含糊、夸大促销语)。删除规则对象即禁用,追加对象即新增;工作区根目录的 rules.json 会覆盖默认规则。brand_lint 既是 MCP 工具也是仪表盘撰写器的检查面板。

九、反馈与支持 可通过仪表盘中的 Share feedback 链接、GitHub Discussions 或反馈 issue 表单提交意见;bug 或功能请求通过对应 issue 表单提交;更深入的提案可开 RFC。完整的支持渠道见 SUPPORT.md。