X Api

核心用法

x-api 提供官方 X (Twitter) API 写入能力，专为发布推文场景设计。相比基于 cookie 的 bird CLI 方案，本技能使用 OAuth 1.0a 认证，有效规避了平台针对非官方客户端的机器人检测和速率限制问题。

显著优点

• 可靠性高：官方 API 通道，稳定性优于逆向工程方案
• 绕过限制：不受 bird tweet 面临的 bot 检测拦截影响
• 成本可控：免费 tier 提供 1,500 条/月发文额度
• 配置灵活：支持环境变量与配置文件双模式凭证管理
• 输出友好：成功时返回可直接访问的推文 URL

潜在缺点与局限性

• 凭证门槛：需注册 X Developer Portal 创建 Project/App，流程较繁琐
• 权限要求：必须手动设置 App 权限为 Read and Write，否则报 401
• 额度消耗：免费 tier 需预充值 credits，耗尽后需付费 ($100/mo Basic)
• 功能单一：仅支持写入，读取场景需搭配 bird CLI 使用
• 依赖管理：需全局安装 twitter-api-v2 npm 包

适合人群

• 需要稳定、批量发布推文的开发者与自动化运营者
• 对 bird 方案的 bot 拦截感到困扰的技术用户
• 已有 X 开发者账号、愿意维护 API 凭证的专业用户

常规风险

• 凭证泄露风险：Access Token 拥有写权限，需妥善保管
• 账号封控：API 滥用仍可能触发平台风控
• 成本突增：未监控 credits 消耗可能导致服务中断
• 单点故障：依赖 npm 包 twitter-api-v2 的维护状态

核心用法

x-api 是一个专精于 X/Twitter 内容发布 的轻量级工具，通过官方 API 解决传统 Cookie 方案（如 bird CLI）被机器人检测拦截的问题。用户需在 X Developer Portal 创建应用并获取 API Key、API Secret、Access Token 及 Access Token Secret 四组凭证，通过环境变量或 ~/.clawdbot/secrets/x-api.json 配置后即可使用 x-post 命令发推。

典型工作流：

• 发布场景：x-post "推文内容" —— 支持多行文本，成功返回推文链接
• 读取场景：切换至 bird CLI（免费、无额度限制）完成时间线浏览、搜索、提及查看等操作

该设计体现了功能分离的合理性：写操作走付费 API 确保稳定性，读操作用逆向方案节省成本。

显著优点

1. 可靠性优先：OAuth 1.0a 官方通道规避了 Cookie 方案的 bot 检测与速率限制，适合自动化工作流
2. 配置灵活：支持环境变量与配置文件双模式，便于 CI/CD 与本地开发切换
3. 依赖精简：仅依赖 twitter-api-v2（官方推荐 SDK），无冗余第三方库
4. 透明可审计：86 行代码量极低，MIT 开源协议，功能边界清晰
5. 合规就绪：CLS-Certify 全面扫描 S+ 评级，GDPR/CCPA 合规，无敏感数据收集

潜在局限

• 成本门槛：免费 tier 限 1,500 帖/月，超出需购买 $100/月 Basic 套餐或充值 credits
• 凭证维护：401 错误需手动在 Portal 重生成 Token，权限设置（Read + Write）易遗漏
• 功能单一：仅限发布，无编辑、删除、线程管理等功能
• 平台绑定：完全依赖 X API 政策，费率与权限可能随平台调整

适合人群

• 需要稳定自动化发推的开发者、运营团队、Bot 作者
• 已有 X Developer Portal 账号且愿意承担 API 成本的组织
• 对 Cookie 方案封号风险敏感的专业用户
• 追求代码极简、安全可审计的技术洁癖者

常规风险

• 402 Credits Depleted：免费额度耗尽导致服务中断，需监控用量并设置告警
• 凭证泄露：环境变量或 JSON 配置若权限设置不当（如 world-readable），存在密钥暴露风险
• OAuth Token 失效：X 平台侧策略变更或账号异常可能导致授权失效，需预留重认证机制
• 内容合规：自动化发布内容仍需遵守 X 平台规则及当地法规，API 通道不豁免内容审核