核心用法
x-oauth-api 是一个基于官方 X API v2 的 CLI 工具，支持通过 OAuth 1.0a 认证直接与 X（原 Twitter）平台交互。主要功能包括：
- 发布推文：
x post "内容"，支持回复、引用和媒体附件 - 创建话题串：
x thread "第一条" "第二条" ...自动串联多条推文 - 账号管理：
x me查看当前账号信息，x delete <id>删除推文 - 提及与搜索：
x mentions和x search（需 Basic+ 付费层级）
显著优点
1. 官方直连：不依赖第三方代理，数据不经过中间服务器，隐私可控
2. 免费层级友好：基础发布、删除、账号查询功能完全免费
3. 标准 OAuth 1.0a：使用官方认证流程，Token 由用户自行管理
4. 透明计费：X 官方定价清晰，无隐藏费用
潜在局限
- 功能分层严格：搜索、提及获取、媒体上传等核心功能需 Basic+ 层级（$100/月），免费层级仅限于「写」操作
- 环境变量敏感：需妥善保管 4 组 OAuth 凭证，泄露即导致账号风险
- Rate Limit 较严：发布限制 200 条/15 分钟，自动化场景易触发限流
- 无内容审核过滤：直接发布，需用户自行把控内容合规性
适合人群
- 需要程序化管理 X 账号的内容创作者、社交运营团队
- 构建自动化工作流（如 AI Agent 联动发帖）的开发者
- 注重数据隐私、不愿使用第三方 Twitter 客户端的用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 凭证泄露 | OAuth Token 若写入日志或代码仓库，可能导致账号被盗用 |
| 误操作发布 | CLI 直接执行，无二次确认，测试环境易误发正式账号 |
| 限流封禁 | 高频发布可能触发 X 平台风控，导致临时或永久限制 |
| 付费陷阱 | 误调用搜索/媒体接口将直接报错，需明确区分免费/付费边界 |
配置要点
需从 X Developer Portal 获取并配置 4 项环境变量：X_API_KEY、X_API_SECRET、X_ACCESS_TOKEN、X_ACCESS_TOKEN_SECRET，且务必确保无尾随换行符。