bird 是一个快速访问 X/Twitter 的命令行工具,使用 GraphQL 接口并通过 cookie 完成认证。
用途:在终端中读取推文、浏览时间线、搜索内容、管理书签与点赞、查看社交关系,以及执行关注、发帖等互动操作。
主要能力:
- 账号与认证:whoami 查看当前账号,check 查看凭据来源,query-ids --fresh 刷新 GraphQL 查询 ID 缓存。
- 阅读:read 或直接传 URL/ID 读取单条推文,thread 查看完整对话,replies 列出回复。
- 时间线:home 查看 For You,home --following 查看关注时间线,user-tweets 查看指定用户推文,mentions 查看提及。
- 搜索:search 支持关键词与高级语法,可配合 --all、--max-pages 分页。
- 新闻与趋势:news 获取 Explore 标签内容,支持 --ai-only、--sports、--with-tweets,trending 为其别名。
- 列表:lists、list-timeline 管理并读取列表。
- 书签与点赞:bookmarks、likes 支持分页、文件夹、父推文与回复链选项,unbookmark 取消书签。
- 社交图谱:following、followers、about 查看关注关系与账号信息。
- 互动与发帖:follow、unfollow、tweet、reply,支持 --media 上传图片或视频及 --alt 描述。
使用方式: 安装:npm install -g @steipete/bird,或 brew install steipete/tap/bird,或 bunx @steipete/bird whoami 免安装运行。 认证:使用 --auth-token / --ct0 直接传入 cookie,或用 --cookie-source 读取浏览器 cookie;Arc/Brave 需配合 --chrome-profile-dir。 配置:支持 ~/.config/bird/config.json5 或项目内 .birdrc.json5,也可用环境变量 BIRD_TIMEOUT_MS、BIRD_COOKIE_TIMEOUT_MS、BIRD_QUOTE_DEPTH。 输出:--json、--json-full、--plain、--no-emoji、--no-color 等选项便于脚本处理。
适用场景:自动化读取与搜索推文、监控提及与趋势、批量管理书签和关注、在终端快速发帖或回复。
限制:发帖更容易触发速率限制,若被阻止建议改用浏览器工具;cookie 提取失败时需确认浏览器已登录 X,或尝试其他 --cookie-source;查询 ID 过期会出现 404,可用 bird query-ids --fresh 刷新。媒体上传最多 4 张图片或 1 个视频。