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。
主要能力包括:whoami、check、query-ids 等账号与认证命令;read、thread、replies 读取推文与对话;home、user-tweets、mentions 浏览时间线;search 搜索;news、trending 查看新闻与趋势;lists、list-timeline 管理列表;bookmarks、likes 处理书签与点赞;following、followers、about 查看社交关系;follow、unfollow 执行关注操作;tweet、reply 发布内容,并支持 --media 上传图片(最多 4 张)或 1 个视频及 --alt 替代文本。
支持分页(--all、--max-pages、--cursor、--delay)与输出选项(--json、--json-full、--plain、--no-emoji、--no-color、--quote-depth)。配置可写入 ~/.config/bird/config.json5 或 ./.birdrc.json5,也支持 BIRD_TIMEOUT_MS 等环境变量。
限制:发布操作更容易被限流,若被阻止建议改用浏览器工具;Query ID 过期出现 404 时可运行 bird query-ids --fresh;Cookie 提取失败需确认浏览器已登录 X 并尝试不同 --cookie-source。