核心功能
x-poster 是一个通过 OpenTweet REST API 实现 X (Twitter) 自动化的综合工具，提供完整的社交媒体内容管理能力：
主要功能模块
- 推文发布：支持即时发布（
publish_now）或两步式创建-发布流程，单条或批量创建（最多50条） - 线程管理：原生支持多推文线程，可为每条推文独立配置媒体
- 媒体处理：支持 JPG/PNG/GIF/WebP（最大5MB）和 MP4/MOV（最大20MB）上传，通过
media_urls和thread_media参数关联 - 定时调度：ISO 8601 格式未来日期调度，支持批量排程（
batch-schedule） - 社区功能：可发布至 X Community，控制是否同步到关注者
- 数据分析：提供账户概览、最佳发布时间、粉丝增长追踪、互动指标（Advanced 计划）等多维度分析
工作流程设计
工具强制要求操作前调用 GET /api/v1/me 验证订阅状态（subscription.has_access）和当日剩余配额（limits.remaining_posts_today），避免无效请求。响应处理强调必须解析实际 JSON 返回值，禁止伪造数据。
显著优点
1. 功能完整性：覆盖从内容创建到效果分析的全链路，减少多工具切换
2. 批量效率：50条/请求的批量操作适合内容日历规划
3. 数据驱动：最佳发布时间和增长预测功能辅助运营决策
4. 线程友好：thread_media 的嵌套数组设计支持复杂多媒体线程
局限性与风险
- 订阅门槛：调度和发布功能需付费订阅，免费版仅限草稿创建
- 速率限制：Pro 计划 60请求/分钟、1000/天；Advanced 提升至 300/分钟、10000/天
- 平台依赖：完全依赖 OpenTweet 中间层，非官方 X API，存在服务稳定性风险
- 数据隐私：需将 API 密钥托管至
OPENTWEET_API_KEY环境变量 - 功能分层：推文互动分析等高级功能仅限 Advanced 计划（403 错误）
适用人群
- 个人创作者寻求自动化发布工作流
- 社交媒体经理管理多账户内容日历
- 营销团队需要批量调度和基础数据分析
安全注意事项
- 密钥泄露风险：Bearer Token 模式需严格保护
OPENTWEET_API_KEY - 第三方信任：OpenTweet 作为非官方代理，需评估其数据处理和合规政策
- 发布不可逆：即时发布操作（
publish_now或publish端点）无二次确认机制