名称： x-api
描述： 使用官方 API 通过 OAuth 1.0a 向 X (Twitter) 发布内容。在需要发推文、发布更新或发布内容时使用。可绕过基于 cookie 的方法（如 bird CLI）所面临的速率限制和机器人检测。

x-api 🐦

使用官方 API (OAuth 1.0a) 向 X 发布内容。

何时使用

• 发布推文（基于 cookie 的 bird tweet 会被机器人检测拦截）
• 需要可靠的官方 API 访问

对于读取操作（时间线、搜索、提及），请使用 bird CLI——它是免费的，并且在读取方面表现良好。

设置

1. 获取 API 凭证

1. 访问 https://developer.x.com/en/portal/dashboard
2. 创建一个项目和应用
3. 将应用权限设置为 读取和写入
4. 从 "Keys and tokens" 选项卡获取你的密钥：
   • API 密钥 (Consumer Key)
   • API 密钥密文 (Consumer Secret)
   • 访问令牌 (Access Token)
   • 访问令牌密文 (Access Token Secret)

2. 配置凭证

选项 A：环境变量

export X_API_KEY="你的-api-key"
export X_API_SECRET="你的-api-secret"
export X_ACCESS_TOKEN="你的-access-token"
export X_ACCESS_SECRET="你的-access-token-secret"

选项 B：配置文件 位于 ~/.clawdbot/secrets/x-api.json

{
  "consumerKey": "你的-api-key",
  "consumerSecret": "你的-api-secret",
  "accessToken": "你的-access-token",
  "accessTokenSecret": "你的-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 开发者门户中充值积分）
• 基础层级（$100/月）：更高的限制

读取操作（使用 bird）

对于读取、搜索和监控——请使用 bird CLI：

bird home                    # 时间线
bird mentions                # 提及
bird search "查询词"         # 搜索
bird user-tweets @用户名     # 用户的帖子
bird read <推文-url>         # 单条推文

故障排除

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

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

未找到凭证：设置环境变量或创建配置文件（参见上方的设置步骤）