核心用法
x-poster 是一款基于 OpenTweet API 的自动化 X（Twitter）管理工具，让用户无需手动登录平台即可完成完整的社群媒体工作流程。核心功能涵盖：
- 即时与排程发布：支援
publish_now立即发布或scheduled_date排程，单次最多处理 50 则 bulk posts - 串文（Thread）管理：可建立多推文串文，支援每则推文独立附加媒体（
thread_media二维数组结构） - 媒体处理：内建上传端点（JPG/PNG/GIF/WebP/MP4/MOV），需先上传取得 URL 后再嵌入推文
- 社群功能：支援发布至 X Community，可控制是否同步分享给追踪者
- 数据分析：提供帐户总览、最佳发布时间、追踪者成长预测、单则推文互动数据（Advanced 方案）
认证方式：Bearer Token（OPENTWEET_API_KEY），所有请求需附加 Authorization: Bearer $OPENTWEET_API_KEY 表头。
显著优点
1. 完整自动化：从草稿、排程到发布、数据分析的全流程 API 化，适合建置无人值守的内容管道
2. 批次效率高：单次 50 则 bulk create/schedule，配合 batch-schedule 可快速部署整周内容
3. 串文媒体支援：thread_media 的二维数组设计，让每则推文可独立配置 0-N 张图片，优于多数单一层级媒体绑定的方案
4. 数据驱动决策：best-times 与 growth 预测端点，协助找出最佳发布时机与追踪里程碑预测
5. 即时状态回馈：发布成功回传 x_post_id 与真实 url，便于后续追踪与验证
潜在缺点与局限性
- 订阅门槛：排程与发布功能需 active subscription，仅建立草稿免费；互动分析（tweet engagement）锁定 Advanced 方案
- 不可逆操作：发布后无法透过 API 撤回或编辑，需严格遵循 "确认后再发布" 的安全流程
- 日期限制严格：
scheduled_date必须为 ISO 8601 未来时间戳，过去时间会直接被拒 - 媒体前置流程：必须先上传取得 URL 才能创建推文，无法单请求直接附档，增加步骤复杂度
- 速率与额度限制：Pro 方案每日 1,000 请求/60 则推文，大规模自动化需升级 Advanced
- 第三方依赖：服务稳定性完全取决于 OpenTweet 平台，非官方 X API，存在服务中断或政策变动风险
适合人群
- 社群媒体管理者（SMM）：需管理多帐号、排程大量内容的代理商或品牌方
- 内容创作者：Podcaster、Newsletter 作者、知识型网红，希望将内容自动同步至 X
- 自动化开发者：建置 n8n/Zapier/Make 工作流程，或开发自有 CMS 整合的工程师
- 数据导向行销团队：需追蹤互动率、优化发布时间、预测追踪者成长的营运人员
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **误发布风险** | `publish_now` 或 `/publish` 一旦执行无法撤回 | 强制二次确认流程，显示推文预览与 Post ID |
| **排程冲突** | 批次操作中可能误将未来排程推文立即发布 | 明确区分 "publish now" vs "schedule" 意图，检查 `scheduled_date` 存在性 |
| **API 密钥外泄** | Bearer Token 若遭泄露，攻击者可完全控制帐号 | 使用环境变数注入，定期轮换密钥，最小权限原则 |
| **速率限制触发** | 高频操作易触发 429，导致当日服务中断 | 实作指数退避（exponential backoff），监控 `X-RateLimit-Remaining` |
| **订阅状态变动** | 订阅到期未察觉导致排程任务失败 | 每次操作前呼叫 `/me` 验证 `subscription.has_access` 与 `limits.remaining_posts_today` |
| **平台政策风险** | OpenTweet 非官方 X API，可能受 X API 政策变动影响 | 分散风险，保留官方 X API 作为备用方案 |