Openclaw Skill

核心用法

PostFast 是一个 SaaS 型社交媒体管理 API，通过单一密钥即可调度 TikTok、Instagram、Facebook、X (Twitter)、YouTube、LinkedIn、Threads、Bluesky、Pinterest、Telegram 及 Google Business Profile 的内容发布。核心工作流包括：获取已连接账号列表 → 上传媒体至 S3（三步流程：获取签名 URL → PUT 上传 → 使用 key 创建帖子）→ 创建定时/草稿帖子 → 查询或删除已排期内容。

API 支持丰富的平台专属功能：Instagram Reels/Story/轮播、TikTok 隐私控制与合拍设置、YouTube Shorts 与自定义缩略图、LinkedIn 文档帖（PDF/PPT 轮播）、X 的引用推文与自动首评、Pinterest 画板绑定、Google Business Profile 的三种帖子类型（标准/活动/优惠）等。批量请求单次最多 15 条帖子，跨平台发布时共享 controls 配置。

显著优点

• 覆盖全面：11 个主流平台一站式管理，减少多工具切换成本
• SaaS 免运维：无需自托管，7 天免费试用即可上手
• 媒体流程标准化：统一的三步上传机制适配各平台格式要求
• 企业级功能：支持客户免注册连接账号（connect-link）、草稿模式、发布后自动首评、数据分析（曝光/互动/覆盖）
• 灵活排期：支持精确到秒的 UTC 时间调度，批量操作提升效率

潜在缺点与局限性

• 平台限制严格：X (Twitter) API 仅 5 帖/账号/天；Google Business Profile 单图限制、1500 字符上限、帖子 6 个月自动过期
• 媒体上传门槛：必须通过 PostFast S3 中转，不支持外部直链
• 依赖平台 API 稳定性：各平台政策变更（如 X API 收费策略）可能影响功能
• 缩略图/封面限制多：YouTube 需手机验证频道、Instagram Reel 封面仅 JPEG、Facebook Reel 不支持时间戳封面等细节繁琐
• 速率限制复杂：全局限制（60/分、300/小时、2000/天）与端点限制（发帖 350/天）叠加，需精细控制调用频率

适合人群

• 社交媒体运营团队与 MCN 机构
• 需要为多客户管理账号的代运营服务商
• 希望将内容发布自动化集成到现有工作流的技术团队
• 跨平台营销活动的批量执行场景

常规风险

• 认证风险：API 密钥格式特殊（pf-api-key 非标准 Authorization: Bearer），易因 header 名称错误导致 403；密钥重新生成会永久失效旧密钥
• 排期失败：未严格校验平台字符限制（如 X 280 字符、TikTok 视频 3-10 分钟）会导致发布失败
• 数据残留：媒体上传后若未使用，key 可能存在于 S3；删除帖子不影响已上传的媒体文件
• 账号关联：单一 API key 管理多客户账号时，需通过工作区隔离避免权限混淆

核心用法

PostFast是一个纯文档型MCP Skill，通过调用官方API实现跨平台社交媒体管理。用户需先注册PostFast账号（7天免费试用），获取API Key并配置环境变量POSTFAST_API_KEY。

基础工作流：
1. 调用/social-media/my-social-accounts获取已连接的社交账号UUID
2. 纯文本帖子：直接POST到/social-posts，指定content、scheduledAt（ISO 8601 UTC）和socialMediaId
3. 含媒体帖子：需完成3步上传（获取signed URL → PUT上传到S3 → 使用key创建帖子）
4. 跨平台发布：在posts数组中包含多个平台条目，共享controls配置

高级功能：

• 平台专属控制：TikTok隐私设置、Instagram Reels封面、YouTube缩略图、LinkedIn文档附件、Pinterest画板、Google Business Profile位置等
• 草稿与定时：支持status: "DRAFT"保存草稿，或精确排期到秒级
• 首条评论：支持X/Instagram/Facebook/YouTube/Threads的自动首评（适合放链接CTA）
• 数据分析：通过/social-posts/analytics获取已发布帖子的曝光、互动等指标
• 客户账号连接：生成免注册连接链接，让客户端自主授权社交账号

显著优点

| 维度 | 优势 |

|------|------|

| **覆盖广度** | 支持11个平台：TikTok、Instagram、Facebook、X、YouTube、LinkedIn、Threads、Bluesky、Pinterest、Telegram、Google Business Profile |

| **架构安全** | SaaS模式，敏感操作在PostFast服务端完成，Agent不接触社交账号密码 |

| **零运维成本** | 无需自建服务器、维护IP信誉、处理平台API变更 |

| **功能深度** | 支持TikTok合拍/拼接设置、YouTube Shorts、Instagram试用Reel、LinkedIn文档轮播等高级功能 |

| **开发者友好** | 提供50+完整JSON示例，涵盖所有主流场景 |

潜在缺点与局限性

1. 平台限制硬性约束

• X (Twitter) API严格限制：每个账号每天仅5条帖子
• Google Business Profile：仅1张图片、无视频、内容1500字符限制、帖子6个月自动过期
• TikTok标准帖子必须含视频（图片仅支持轮播格式）

2. 依赖外部SaaS

• 需持续付费订阅PostFast服务（免费试用后）
• 服务可用性完全依赖PostFast平台稳定性
• 平台API政策变更需等待PostFast适配

3. 媒体上传流程繁琐

• 必须完成3步上传（signed URL → S3 PUT → 引用key），无法直接使用外部URL
• 大视频上传可能受网络和S3限制

4. 速率限制

• 全局：60/分钟、2000/天
• 发帖：350/天
• 分析数据：350/小时
• 客户连接链接：50/小时

5. 部分功能平台受限

• firstComment不支持TikTok、Pinterest、Bluesky、LinkedIn
• LinkedIn个人账号无法获取分析数据
• YouTube自定义缩略图需手机号验证

适合人群

• 社交媒体运营团队：需要统一管理多平台内容日历
• 营销代理机构：为客户批量管理账号，可利用"连接链接"功能让客户自主授权
• 内容创作者：希望提前规划一周/一月内容，自动定时发布
• 跨境电商/本地商家：需要同步管理Google Business Profile和主流社交平台
• 开发集成者：需要快速嵌入社交发布功能，不愿自建基础设施

常规风险

| 风险类型 | 说明 | 缓解建议 |

|----------|------|---------|

| **凭证泄露** | API Key从环境变量读取，若.env文件误提交可能暴露 | 将.env加入.gitignore，定期轮换Key |

| **平台封号** | 违反X等平台的发帖频率限制可能导致社交账号受限 | 严格监控X账号的5条/天限制，分散到多个账号 |

| **内容合规** | 自动化发布可能涉及版权、虚假信息等问题 | 建立内容审核流程，利用`status: "DRAFT"`预审核 |

| **数据隐私** | 帖子内容、分析数据流经PostFast服务器 | 审阅PostFast隐私政策，敏感行业评估数据本地化要求 |

| **排期失误** | `scheduledAt`时区或格式错误导致意外立即发布或失败 | 统一使用UTC时间，发布前用`GET /social-posts`复核日程 |

| **媒体上传失败** | S3上传中断或Content-Type不匹配导致帖子创建失败 | 验证PUT返回200后再调用创建接口，实施重试机制 |