x-api 🐦

使用官方API（OAuth 1.0a）向X发帖。

何时使用

• 发布推文（基于Cookie的bird tweet会被机器人检测拦截）
• 为了可靠性，需要使用官方API

对于读取（时间线、搜索、提及），请使用birdCLI工具——它免费且非常适合读取操作。

设置

1. 获取API凭证

1. 前往https://developer.x.com/en/portal/dashboard
2. 创建一个项目和应用程序
3. 将应用程序权限设置为读取和写入
4. 从"密钥和令牌"标签页获取你的密钥：
   • API密钥（消费者密钥）
   • API密钥秘密（消费者秘密）
   • 访问令牌
   • 访问令牌密钥

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"

成功时返回推文链接。

限制

• 免费层级：每月 1,500 条帖子（需在 X 开发者门户中拥有额度）
• 基础层级（100 美元/月）：更高限制

读取（使用 bird）

对于读取、搜索和监控——请使用bird命令行工具：

bird home                    # Timeline
bird mentions                # Mentions
bird search "query"          # Search
bird user-tweets @handle     # User's posts
bird read <tweet-url>        # Single tweet

故障排除

402 额度耗尽：在 X 开发者门户 → 仪表板中添加额度

401 未经授权重新生成访问令牌（请先确保已设置读取+写入权限）

未找到凭据：设置环境变量或创建配置文件（请参阅上方的“设置”说明）