SuperAPI AI 工具集

xitter

编程与开发

查看项目

更新于 10-16 02:32

技能介绍

用途:在终端通过官方 X/Twitter API 完成发帖、回复、引用推文、搜索推文、读取时间线、查询用户及其关注者/关注列表、点赞、转推、查看提及与书签等操作。该技能不内置独立 CLI,而是安装并使用上游 x-cli。

安装与升级:uv tool install git+https://github.com/Infatoshi/x-cli.git;升级用 uv tool upgrade x-cli;用 x-cli --help 验证。

凭据:需从 X 开发者门户获取 X_API_KEY、X_API_SECRET、X_BEARER_TOKEN、X_ACCESS_TOKEN、X_ACCESS_TOKEN_SECRET 五个值。前两者标识应用,Bearer 用于应用级读取,后两者让 CLI 以用户身份执行写入与需认证操作。门户中需将用户认证权限设为 Read and write,并在启用写权限后重新生成访问令牌与密钥。x-cli 从 ~/.config/x-cli/.env 读取凭据,可软链接到 ~/.hermes/.env 或单独创建该文件并 chmod 600。

常用命令:x-cli tweet post/get/delete/reply/quote/search/metrics;x-cli user get/timeline/followers/following;x-cli me mentions/bookmarks/bookmark/unbookmark;x-cli like、x-cli retweet。输出模式支持 -j(机器可读)、-p、-md、-v,建议提取字段时用 -j,需要时间戳或指标时加 -v。

限制:X 官方 API 对多数实际使用并非免费,常需付费或预付费开发者权限;失败多为套餐或权限问题。403 oauth1-permissions 需在启用读写后重新生成访问令牌。X 对程序化回复限制较多,引用推文通常比回复更可靠。存在按端点的速率限制与冷却窗口。若在 ~/.hermes/.env 轮换令牌,需确保 ~/.config/x-cli/.env 仍指向当前文件。建议优先使用官方 API 而非 cookie/会话抓取。