bird（推特CLI工具）Skill 是什么？如何用命令行读推文与发推？

推特CLI工具Skill：用一条命令读推文、搜话题、发内容，把 X 接入你的工作流

它是什么：bird 是一个使用 GraphQL 与 cookie 认证的 X/Twitter 命令行界面工具，把「刷推、搜推、发推、看回复」全部搬到终端里。
怎么装：macOS 可 brew install steipete/tap/bird，任意平台可 npm install -g @steipete/bird，也可用 bunx @steipete/bird 免安装试跑。
认证方式：复用浏览器里已登录的 X cookie，无需申请官方 API Key，装完 bird check 和 bird whoami 即可确认是否生效。
能力范围：读单条推文、展开对话线程、看首页、关注和用户时间线、搜索、看新闻趋势、读书签与喜欢、看社交关系图、关注和取关、发推与回复、上传图片视频。
需要留意：发布类操作更容易触发平台速率限制，官方文档也明确提示发布需谨慎，被阻断时建议改用浏览器。

1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？

技能中文名：推特CLI工具Skill 技能英文名：bird 技能ID：13603 项目主页：https://bird.fast

这个技能要解决的问题很具体：X/Twitter 的日常操作几乎都被绑在浏览器里。想批量看某人的推文、想把搜索结果存成 JSON、想在脚本或 AI 助手的工作流里顺手抓一条推文内容，都得先打开网页、滚动页面、手动复制。而官方 API 又有申请门槛、配额与计费规则，对只想读一点公开信息的开发者来说太重。

bird 的思路是把这些操作变成标准命令：输入一条 URL 或 ID，输出结构化文本或 JSON。它用 GraphQL 请求配合 cookie 认证，也就是说，只要你浏览器里登录着 X，它就能以「你本人」的身份去读、去搜、去发，不需要另外申请开发者凭据。

一键安装的思路与步骤：

技能元数据里声明了 requires.bins: ["bird"]，意思很直接——技能本身是「壳」，真正干活的是系统里的 bird 可执行文件。所以安装分两步：先让 bird 进入系统 PATH，再让 AI 技能调用它。

确认前提：系统里需要有 Node.js 包管理器（npm、pnpm 或 bun 均可），或 macOS 上的 Homebrew；同时你的浏览器已登录 X 账号（cookie 认证依赖这一点）。
选择安装方式（以下命令均来自技能官方说明）：
- 跨平台通用：npm install -g @steipete/bird
- macOS 预编译二进制：brew install steipete/tap/bird
- 只想试一次、不污染全局环境：bunx @steipete/bird whoami
验证是否生效：先跑 bird check 查看当前使用的是哪个 cookie 源，再跑 bird whoami 看是否返回你登录的账户名。两条命令都能正常输出，说明认证链路已通。
交给 AI 技能调用：把技能挂载给助手后，你只需要说「帮我看看这条推文的完整对话」，助手就会调用 bird thread <url> 并把结果整理给你。

如果 bird check 报错，通常不是安装失败，而是 cookie 提取失败：先确认浏览器确实处于登录状态，再尝试不同的 --cookie-source；使用 Arc 或 Brave 这类 Chromium 派生浏览器时，需要指定 --chrome-profile-dir <路径>。具体的目录路径、更多平台安装包与最新版本信息，以官方说明为准。

2. 该技能的主要功能和特点

cookie 认证，绕开 API 申请：通过 --auth-token 和 --ct0 直接传入 cookie，或让工具自动从浏览器读取，bird check 随时能看到当前生效的凭据源。
读推文一应俱全：bird read <url或id> 读单条，bird <url或id> 是简写，bird thread 拉完整对话线程，bird replies 列出回复。
多条时间线覆盖：bird home 看推荐流、bird home --following 看关注流、bird user-tweets @handle -n 20 看指定用户的推文、bird mentions 看谁提到了你。
搜索支持高级语法：bird search "from:steipete" --all --max-pages 3，可以用搜索运算符加翻页，把结果一次性拉完。
新闻与趋势：bird news -n 10 从探索标签取 AI 策划内容，--ai-only、--sports、--with-tweets 可以细分主题，bird trending 是它的别名。
书签的精细读取：除了普通书签，还能按文件夹（--folder-id）取、带父推文（--include-parent）、只取作者自我回复链（--author-chain）或完整回复链（--full-chain-only）。
社交关系图：bird following / bird followers 查看关注与粉丝，bird about @handle 查账户来源与位置信息。
互动与发布：bird follow / bird unfollow 管理关注，bird tweet 发推、bird reply 回复，--media 支持最多 4 张图片或 1 个视频，并可用 --alt 补图片描述。
脚本友好：--json、--json-full（含原始 API 响应）、--plain（无 emoji 无颜色）、--no-color（或设 NO_COLOR=1），直接管道给 jq 或写进数据处理流程。
可配置：支持 ~/.config/bird/config.json5 全局配置与 ./.birdrc.json5 项目配置，也能用 BIRD_TIMEOUT_MS 等环境变量覆盖。

和「普通工具」比，它的差异点在于：输出结构化、可翻页、可脚本化。浏览器能做的事它基本都能做，但浏览器做不了「把 300 条搜索结果一次性变成 JSON 喂给分析脚本」。

3. 如何使用该技能？

第 1 步：确认身份。

bird check     # 看凭据源
bird whoami    # 看当前登录账户

第 2 步：读内容。 最常见的三种调用：

bird https://x.com/someone/status/1234567890    # 简写读取
bird thread https://x.com/someone/status/1234567890   # 完整对话
bird replies 1234567890 -n 20                   # 前 20 条回复

第 3 步：搜索与抓取。 例如想收集某位作者最近的公开内容：

bird search "from:steipete" --all --max-pages 3 --json

--all 表示翻完所有页，--max-pages 3 限制最多 3 页，--json 让输出可直接被程序解析。分页命令还支持 --cursor <cursor> 从上次位置继续，以及 --delay 1000 设置页间延迟，减少被限流概率。

第 4 步：读时间线与书签。

bird home --following -n 20
bird bookmarks -n 10 --include-parent
bird user-tweets @handle -n 20 --plain

第 5 步：发布与互动。 注意这里风险最高：

bird tweet "hello world"
bird reply 1234567890 "很有价值的讨论"
bird tweet "配图说明" --media image.png --alt "图片描述"
bird follow @handle

第 6 步：遇到问题先刷新查询 ID。 如果出现 404 类错误，说明 GraphQL 查询 ID 缓存过期：

bird query-ids --fresh

输出示例（说明）：默认输出是带 emoji 与颜色的可读文本，适合人看；加 --json 输出精简 JSON；加 --json-full 会包含原始 API 响应，适合排查字段缺失问题。--quote-depth n 控制 JSON 中引用推文的展开深度，默认是 1，避免嵌套过深。

4. 同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
bird（本技能）	cookie 认证的 X 命令行工具	读推文、线程、回复、时间线、搜索、新闻趋势、书签、社交图、发推与回复、媒体上传	需装 Node/npm 或 Homebrew，浏览器需登录 X；无需申请 API Key	终端内快速读推、脚本化抓取、AI 助手接入 X 信息	优势：装完即用、输出支持 JSON、命令覆盖广；不足：依赖浏览器 cookie，发布易触发速率限制
X 官方 API（v2）	平台官方接口	读写推文、用户、关注关系等，权限按套餐分层	需注册开发者账号、申请权限、管理密钥与配额，可能有费用，以官方说明为准	合规要求高的商业产品、需要稳定 SLA 的服务	优势：官方支持、稳定合规；不足：申请与配额门槛高，读写权限常常要额外层级
浏览器自动化脚本（如基于 Playwright 自写）	自建爬取与操作方案	模拟点击滚动，理论上网页能做的都能做	需自行编写与维护选择器，页面改版即失效	一次性数据采集、临时自动化	优势：无接口限制的错觉；不足：维护成本极高、稳定性差、易被风控识别
第三方语言 SDK（如 Python 生态的封装库）	面向开发者的编程库	以代码调用接口完成读写	需写代码、配置密钥或 cookie，学习成本中等	需要嵌入自有程序的深度集成	优势：灵活、可组合；不足：不能开箱即用，快速查看场景反而更慢

一句话选择建议：只想在终端里快速看和搜，选 bird；要做对外商业产品，走官方 API；要深度嵌进自家系统，选 SDK。

5. 该技能的典型应用场景与实际体验情况

场景一：开发者做信息速查。 你在写代码，同事丢来一条推文链接。以前要切窗口、等页面加载、被推荐流吸走十分钟；现在 bird <url> 一行命令出内容，bird thread <url> 直接看上下文。实际体验：上手几乎零成本，命令命名直观，bird check 与 bird whoami 几乎能排查掉大部分认证问题；唯一要注意的是首次运行时 cookie 源可能要试一两次。

场景二：内容运营做选题与竞品监测。 需要每天看某几个账号发了什么、某个话题下有什么讨论。用 bird user-tweets @handle -n 20 加 bird search "关键词" -n 10，再配合 --json 落到表格里做汇总。实际体验：批量取数比手动翻页快得多，翻页参数（--all、--max-pages、--delay）设计得比较克制，能自己控制节奏；建议给搜索加 --delay，避免短时间内请求过密。

场景三：AI 助手接入实时社交媒体信息。 挂载技能后，你可以直接问助手「帮我看看这个话题下大家怎么说」，助手调用 bird search 并做归纳。实际体验：这是该技能最有想象力的地方——把 X 变成一个可被调用的数据源。注意让助手默认加 --json，结构化输出更利于二次加工。

场景四：个人知识管理。 平时在 X 上收藏了一堆书签，用 bird bookmarks -n 10 --include-parent 把父推文一起拉下来，再配合 --folder-id 按文件夹整理，输出到自己的笔记系统。实际体验：--author-chain 和 --full-chain-only 这两个参数对「还原讨论全貌」特别有用，能省掉大量手动拼接。

需要提醒的注意事项：发布、关注等写操作风险高于读操作，官方说明中也明确提示「发布更可能被速率限制；如果被阻止，请使用浏览器工具」。频繁取消/关注也可能触发风控，建议把这些动作控制在低频、真实的使用节奏内。

6. 该技能能为用户带来的价值

把「切换成本」压到接近零：所有操作发生在终端或 AI 对话里，不需要反复切浏览器窗口，单个任务的操作步数从十几步降到一两行命令。
把非结构化信息变成结构化数据：--json / --json-full 让推文、线程、搜索结果可以直接进入脚本、表格和数据库，这是纯浏览器操作完全做不到的。
绕开 API 申请门槛：cookie 认证意味着不需要开发者账号、不需要等待审核，登录状态就是你的凭据，个人开发者和小团队的入门成本被显著降低。
为 AI 工作流补上「实时社交媒体」这一块拼图：AI 助手最大的短板之一是信息时效性，bird 让它能按需拉取当下的公开讨论。
长期价值在于可组合：命令是原子的、可管道化的，今天用来查一条推文，明天可以长成一套自动化监测脚本，而不需要重写工具链。

效率上的直观感受是：一次「搜索关键词 + 拉取三页结果 + 转成 JSON」的操作，手工在网页上完成通常要几分钟并伴随大量无关信息干扰，而在命令行里是一条命令、几秒钟的事。

7. 常见问题 FAQ

Q1：怎么安装？会不会很麻烦？ macOS 上最省事的是 brew install steipete/tap/bird，它会装预编译好的二进制文件；其他平台用 npm install -g @steipete/bird。如果只是想先试试，用 bunx @steipete/bird whoami 免安装跑一次。装完记得跑 bird check 和 bird whoami 验证。最新版本与支持平台以官方说明为准。

Q2：需要申请 X 的开发者 API 吗？收费吗？ 不需要申请开发者 API。bird 走的是 cookie 认证，复用你浏览器里已登录的 X 状态。至于工具本身的收费情况、以及 X 平台侧的账号权限要求，均以官方说明为准；本文不对价格做任何推断。

Q3：会不会有账号风险？ 读操作风险较低，但发布、关注、取关这类写操作更容易触发平台的速率限制，官方说明中也明确提示发布需谨慎、被阻断时改用浏览器。建议：不要高频批量发布，翻页时用 --delay 拉开间隔，把自动化控制在合理频率内。

Q4：报错了怎么办？ 分两类排查。出现 404 类错误，通常是 GraphQL 查询 ID 缓存过期，执行 bird query-ids --fresh 刷新即可；提示 cookie 提取失败，则先确认浏览器已登录 X，再尝试更换 --cookie-source，使用 Arc 或 Brave 时通过 --chrome-profile-dir <路径> 指定配置文件目录。

Q5：它和官方 API、浏览器脚本应该怎么选？ 看你想要的「稳定性」还是「即时可用」。要对外提供商业服务、有合规与 SLA 要求，用官方 API；要在终端里快速读搜、或把 X 接进 AI 助手与脚本流水线，bird 是阻力最小的选择；自写浏览器自动化维护成本最高，除非你有非常特殊的网页侧需求，否则不建议。