SuperAPI AI 工具集

bird

通用与其它

查看项目

更新于 10-16 07:14

技能介绍

bird 是一个使用 GraphQL 与 Cookie 认证的 X/Twitter 命令行工具,用于读取、搜索、发帖和互动。

用途与安装:可通过 npm install -g @steipete/bird 安装,macOS 也可用 brew install steipete/tap/bird,或用 bunx @steipete/bird whoami 一次性运行。

认证:采用 Cookie 认证,可用 --auth-token / --ct0 直接传入,或用 --cookie-source 读取浏览器 Cookie;运行 bird check 查看当前有效来源,Arc/Brave 需配合 --chrome-profile-dir <path>。

主要能力:账号方面支持 whoami、check、query-ids --fresh;读取支持 read、thread、replies;时间线支持 home、--following、user-tweets、mentions;搜索支持 search 及分页参数;另有 news/trending、lists、list-timeline;书签与点赞支持 bookmarks、likes、unbookmark;社交关系支持 following、followers、about;互动支持 follow、unfollow;发帖支持 tweet、reply,并可带 --media 与 --alt 上传最多 4 张图片或 1 个视频。

输出与分页:可用 --json、--json-full、--plain、--no-emoji、--no-color、--quote-depth;支持分页的命令包括 replies、thread、search、bookmarks、likes、list-timeline、following、followers、user-tweets,可用 --all、--max-pages、--cursor、--delay 控制。

配置与排错:配置文件为 ~/.config/bird/config.json5 或项目内 ./.birdrc.json5,并支持 BIRD_TIMEOUT_MS、BIRD_COOKIE_TIMEOUT_MS、BIRD_QUOTE_DEPTH 等环境变量;如遇 404 可运行 bird query-ids --fresh,Cookie 提取失败可检查浏览器登录状态或更换 --cookie-source。

限制:发帖更容易触发速率限制,若被阻止建议改用浏览器工具;其他平台支持情况与更细的限额资料暂未提供。