x-api 🐦

使用官方 API（OAuth 1.0a）向 X 发布内容。

适用场景

• 发布推文（基于 Cookie 的 bird tweet 会被机器人检测机制拦截）
• 需要通过官方 API 保障稳定性和可靠性

对于读取操作（如时间线、搜索、提及），请改用 bird CLI —— 它免费且读取功能表现良好。

配置步骤

1. 获取 API 凭据

1. 访问 https://developer.x.com/en/portal/dashboard
2. 创建一个 Project 和 App
3. 将 App 权限设置为Read and Write（读取和写入）
4. 在“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 "你的推文正文"

或使用完整路径：

node /path/to/skills/x-api/scripts/x-post.mjs "你的推文正文"

支持多行推文：

x-post "第一行

第二行

第三行"

成功时返回该推文的 URL。

配额限制

• 免费版：每月 1,500 次发布（需在 X Developer Portal 中充值 Credits）
• 基础版（$100/月）：更高配额限制

读取操作（请使用 bird）

如需执行读取、搜索或监控等操作，请使用 bird CLI：

bird home                    # 时间线
bird mentions                # 提及
bird search "query"          # 搜索
bird user-tweets @handle     # 用户发布的推文
bird read         # 单条推文详情

故障排查

402 Credits Depleted（Credits 已耗尽）：请前往 X Developer Portal → Dashboard 充值 Credits

401 Unauthorized（未授权）：重新生成 Access Token（请先确认已启用 Read+Write 权限）

No credentials found（未找到凭据）：请设置环境变量或创建配置文件（参见上方“配置步骤”）