# Bird - X/Twitter CLI 使用“bird” CLI 工具与 X/Twitter 内容交互的指南。 ## 快速入门全局安装bird： npm install -g @steipete/bird # 或 pnpm add -g @steipete/bird # 或包子添加-g @steipete/bird # 一次性（无需安装） Bunx @steipete/bird whoami # 或酿造安装 steipete/tap/bird 验证身份验证： bird whoami # 显示登录帐户 bird check # 检查可用的凭据 ## 常见任务 ### 阅读推文和主题 # 阅读一条推文鸟读 bird # 简写 # 阅读主题（推文 + 回复）鸟线程 # 只获取回复鸟回复 # 输出为 JSON 进行处理鸟读 --json 鸟线程 --json --max-pages 3 ### 搜索推文 # 基本搜索鸟类搜索“查询”-n 10 # 从特定用户搜索鸟类搜索“来自：用户名”-n 20 # 获取所有结果（分页）鸟类搜索“查询”--all--json # 使用日期过滤器搜索鸟类搜索“查询自：2024-01-01”-n 50 ### 获取用户内容 # 用户的推文鸟用户推文@用户名-n 20 bird 用户推文 @username -n 50 --json # 用户提及鸟提到--user @用户名-n 10 ### 管理书签 # 列出书签鸟书签-n 20 鸟书签 --all --json # 来自特定文件夹鸟书签 --folder-id -n 10 # 删除书签 Bird 取消书签 ### 获取新闻和趋势 # AI 策划的新闻鸟类新闻--ai-only -n 10 # 体育/娱乐新闻鸟类新闻--体育-n 15 鸟类新闻--娱乐-n 10 # 包含相关推文鸟类新闻 --with-tweets --tweets-per-item 3 -n 10 # 热门话题鸟类趋势 -n 10 ### 发布推文（谨慎使用） # 发送推文鸟鸣叫“你好世界” # 回复推文鸟回复“我的回复” ### 处理 JSON 输出使用 `jq` 从 JSON 输出中提取特定字段： # 仅获取推文文本鸟读 --json | jq -r '.text' # 获取用户信息 bird 用户推文 @user -n 5 --json | jq '.[] | {名称：.user.name，句柄：.user.screen_name}' # 提取媒体 URL 鸟读 --json | jq -r '.media[]?.url' # 保存到文件 bird 用户推文 @user --all --json > tweets.json ## 身份验证 Bird 使用基于 cookie 的身份验证（不需要 API 密钥）。使用 `--auth-token` / `--ct0` 直接传递 cookie，或使用 `--cookie-source` 来传递浏览器 cookie。浏览器cookie来源： * Safari、Chrome 或 Firefox (macOS) * Chromium 变体（Arc/Brave/etc）：使用 `--chrome-profile-dir` * 使用 `--cookie-source` 选择 cookie 顺序，并使用 `--firefox-profile` 选择特定的 Firefox 配置文件 * `--cookie-source` 是可重复的：`safari|chrome|firefox|all|none` ## 配置文件全局：`~/.config/bird/config.json5` 项目：`./.birdrc.json5` 示例： { cookie来源：[“chrome”]， chromeProfileDir: "/path/to/Arc/Profile", chromeProfile：“默认”， firefoxProfile: "默认发布", cookieTimeoutMs: 10000, 超时时间：20000，报价深度：1 } 环境变量： * `BIRD_TIMEOUT_MS` * `BIRD_COOKIE_TIMEOUT_MS` * `BIRD_QUOTE_DEPTH` * `BIRD_QUERY_IDS_CACHE` ## 重要提示 * 使用未记录的 X/Twitter GraphQL API - 可能会中断，恕不另行通知 * **建议**：仅供阅读。发推文可能会触发封锁。 * 速率限制适用 - 使用 `--delay ` 在请求之间添加延迟 * 分页（如果支持）：“搜索”、“书签”、“喜欢”、“关注”和“关注者”需要“--all”或“--cursor”和“--max-pages”； `list-timeline` 将 `--max-pages` 视为 `--all` ## 故障排除查询 ID 过时（404 错误）：鸟查询-ids --fresh 查询 ID 缓存： * 默认值：`~/.config/bird/query-ids-cache.json` * 覆盖：`BIRD_QUERY_IDS_CACHE=/path/to/file.json` Cookie 提取失败： * 确认您已在浏览器中登录 X/Twitter * 尝试不同的 `--cookie-source` 顺序 * 对于 Arc/Brave，请传递 `--chrome-profile-dir` 身份验证失败，并显示 flags/env： * 确保 `--auth-token` 和 `--ct0` 来自同一会话 * 尝试使用浏览器 cookie 而不是标志来进行快速健全性检查 ## 参考有关完整的命令文档，请参阅 [references/commands.md]()。

鸟

包含技能