93ad9c5722
birdx 从来不是 PyPI 包，pip install birdx 必然失败。 实际工具是 npm 包 @steipete/bird，一个 Twitter GraphQL CLI。 变更： - 安装器改用 npm install -g @steipete/bird - twitter.py 直接调 bird，通过环境变量传 AUTH_TOKEN/CT0 - 兼容已有的 birdx wrapper（shutil.which 回退） - 更新所有文档引用 - 重写 setup-twitter.md 指南
2.3 KiB
2.3 KiB
Twitter 高级功能配置指南（bird CLI）
功能说明
基础 Twitter 功能（搜索+读单条推文）无需配置，开箱即用。
高级功能需要 bird CLI：
- 查看用户时间线
- 深度搜索（更精确、更多结果）
- 读取完整线程（thread）
- 查看关注列表推文
bird 是免费开源工具（npm 包 @steipete/bird），但需要你的 Twitter 账号 cookie。
Agent 可自动完成的步骤
- 检查 bird 是否安装：
which bird && echo "installed" || echo "not installed"
- 安装 bird：
npm install -g @steipete/bird
- 测试（需要先配置 cookie）：
AUTH_TOKEN="xxx" CT0="yyy" bird search "test" -n 1
- 用 agent-reach 配置 cookie（推荐）：
agent-reach configure twitter-cookies "auth_token=xxx; ct0=yyy"
需要用户手动做的步骤
请告诉用户：
Twitter 高级功能需要你的 Twitter 账号 cookie（完全免费）。
最简单的方式：
- 安装 Chrome 插件 Cookie-Editor
- 打开 https://x.com 并确保已登录
- 点击 Cookie-Editor 插件图标 → Export → Header String
- 把导出的内容发给我
手动方式：
- 用 Chrome 打开 https://x.com 并确保你已登录
- 按 F12 打开开发者工具（Mac 按 Cmd+Option+I）
- 点击顶部的 Application（应用）标签
- 左侧找到 Cookies → https://x.com
- 在列表中找到以下两个值，双击复制：
- auth_token — 一串字母数字
- ct0 — 一串字母数字
- 把这两个值发给我
⚠️ 这些 cookie 让我能以你的身份读取推文（只读）。我不会发推、点赞或做任何操作。 ⚠️ cookie 大约 1-3 个月会过期，届时需要重新导出。
Agent 收到 cookie 后的操作
- 安装 bird（如果没装）：
npm install -g @steipete/bird - 配置 cookie：
agent-reach configure twitter-cookies "粘贴的内容" - 测试：运行
agent-reach doctor确认 Twitter 状态 - 反馈："✅ Twitter 高级功能已开启！现在可以搜索推文、查看时间线了。"
- 如果失败："❌ Cookie 无效或已过期，请重新导出。"