用途
x-api 用于通过 X（Twitter）官方 API（OAuth 1.0a）发布推文。当你需要发推、发布更新或推送内容时使用它。相比基于 Cookie 的 bird tweet 发布方式（会被机器人检测拦截），官方 API 访问更可靠。
该技能主要面向前述“发布”场景。对于读取操作（时间线、搜索、提及），资料明确建议改用 bird CLI——它是免费的，且读取效果良好。
主要能力
- 通过官方 API 发布推文。
- 支持多行推文文本。
- 发布成功后返回推文 URL。
- 使用 OAuth 1.0a 认证。
使用方式
1. 获取 API 凭据
- 前往 https://developer.x.com/en/portal/dashboard
- 创建 Project 和 App
- 将 App 权限设置为 Read and Write
- 在“Keys and tokens”标签页获取以下密钥：
- API Key（Consumer Key）
- API Key Secret（Consumer Secret）
- Access Token
- Access Token Secret
2. 配置凭据
方式 A：环境变量
export X_API_KEY="your-api-key" export X_API_SECRET="your-api-secret" export X_ACCESS_TOKEN="your-access-token" export X_ACCESS_SECRET="your-access-token-secret"
方式 B：配置文件 ~/.clawdbot/secrets/x-api.json
{ "consumerKey": "your-api-key", "consumerSecret": "your-api-secret", "accessToken": "your-access-token", "accessTokenSecret": "your-access-token-secret" }
3. 安装依赖
npm install -g twitter-api-v2
发布推文
x-post "Your tweet text here"
或使用完整路径：
node /path/to/skills/x-api/scripts/x-post.mjs "Your tweet text here"
支持多行推文：
x-post "Line one
Line two
Line three"
成功时返回推文 URL。
适用场景
- 需要向 X 发布单条或多行文本推文。
- 对发布可靠性有要求，希望绕过机器人检测的场景。
- 需要官方 API 访问而非 Cookie 方式。
限制
- 免费层：每月 1500 条发布（需要在 X 开发者门户中有额度）。
- Basic 层（每月 100 美元）：更高限额。
- 读取、搜索和监控不建议使用本技能，资料建议改用 bird CLI（免费）：
bird home # Timeline bird mentions # Mentions bird search "query" # Search bird user-tweets @handle # User's posts bird read <tweet-url> # Single tweet
故障排查
- 402 Credits Depleted：在 X 开发者门户 → Dashboard 添加额度。
- 401 Unauthorized：重新生成 Access Token（确保先设置好 Read+Write 权限）。
- No credentials found：设置环境变量或创建配置文件（见上文“配置凭据”）。