SuperAPI AI 工具集

postiz

营销与增长

查看项目

更新于 10-16 09:33

技能介绍

用途:作为 mktg 流程中的社交分发执行层,把已按平台适配好的文案投递到运行中的 postiz 实例所支持的渠道。技能本身不生成、不逐平台改写文案;长文来源应先经 content-atomizer 产出平台原生文案。Twitter/X 串文交由 typefully 处理。

主要能力:先检查 catalog 是否注册与配置,再读取已连接渠道标识并缓存;支持单条内容多平台分发,也支持把 content-atomizer 的产出按文件批量发布。发布通过 mktg publish --adapter postiz 适配器完成,适配器负责限流、401/429 处理与标识解析;结果按渠道逐条返回,单渠道失败不影响其他渠道,可用 sent-marker 避免重复投递。

必要用法:激活时依次执行 mktg catalog info postiz --json --fields configured,missing_envs,auth.credential_envs,resolved_base 检查配置;用 mktg publish --adapter postiz --list-integrations --json 获取已连接渠道并缓存。环境变量为 POSTIZ_API_KEY(必需)与 POSTIZ_API_BASE(默认 https://api.postiz.com)。构造 publish.json 时 content 为原文,metadata.providers 填 postiz 原生标识(如 linkedin、linkedin-page、bluesky、reddit),不要填 integration.id 或平台显示名。先 mktg publish --adapter postiz --dry-run --input '<manifest>' --json 预览,确认后再用 --confirm 发布;manifest 顶层 name 作为 campaign 标识,sent-marker 写入 .mktg/publish/{campaign}-postiz.json。

适用场景:单条内容分发到一个或多个平台;将已原子化的博客/文章文案批量排期到多个渠道;在 social-campaign 编排中作为发布后端。

限制:不负责写稿、改稿与选平台组合;v1 仅创建草稿,metadata.mediaPaths 被忽略,图片支持在 v2;postiz 无幂等键与 webhook,重试前须查 sent-marker,否则会重复;X 串文建议改用 typefully;未连接的渠道会被快速失败并列出已连接清单;别名解析须在本技能层完成,适配器只做精确匹配。缺少配置、未注册 catalog 等情形会给出结构化错误与修复提示。