# X Hunter

> X/Twitter 登录、内容搜索与采集：作品、账号、评论、媒体下载；互动写操作走 expert-bd，创作/发布/本人数据走 expert-twitter。

- Skill: `teamwiseflow/x-hunter` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add teamwiseflow/x-hunter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/teamwiseflow/x-hunter/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: teamwiseflow (https://skillmd.com/u/teamwiseflow)
- Updated: 2026-11-11
- Page: https://skillmd.com/skills/teamwiseflow/x-hunter

---


请求签名由 Relay 计算，使用 `OFB_KEY` 与可选 `RELAY_BASE_URL`。平台 HTTP、登录和 Cookie 更新仍在客户端；签名服务失败或配额不足时停止，不回退本地签名，不自动重登或解验证码。


# X/Twitter内容采集

**登录必须在 Camoufox 专属 session `twitter` 的持久窗口内完成。不要用通用 browser 工具或其他会话打开登录页；其他窗口中的登录不会被本技能导出。**

**profile 中有 Cookie 不代表登录有效，即使 `auth_token/ct0/twid` 未过期。不要读取 `cookies.sqlite` 推断登录成功；已保存 API 会话以 `x-hunter check --account <alias>` 在线校验为准。`check` 成功不能证明新开的浏览器窗口已登录，`login-status:ready` 也只确认窗口；新窗口必须经 export 在线验证。**

首次登录执行 `x-hunter login --account default`，只有返回 `browser_status:ready`、`browser_launched:true`、`headed:true`、`persistent:true` 才向用户说明窗口已打开，并告知 session 和 `url`。等用户确认在该窗口完成登录后执行 `x-hunter export --account default`（也可使用 `login-confirm`），再运行 `x-hunter check --account default`。发布和 BD 工具复用同一账号会话。

窗口不清晰时执行 `x-hunter login-status --account default`，该命令不导航、不导出、不关闭窗口；未就绪时按返回状态和错误指引处理，再运行 login。不要自行换会话；如必须直接排查 Camoufox，后续命令保持 `--session twitter --persistent --headed`，遗漏 `--headed` 会重启有头会话。export 报缺登录 Cookie 时，先检查窗口模式和 profile；专属持久窗口就绪仍缺字段时，请用户在该窗口完成登录并确认后再导出。不要从 sqlite 或其他窗口复制旧 Cookie 补齐。不要自动轮询或导入 Cookie 造浏览器登录；导出失败保留旧账号和浏览器，成功后关闭。多账号始终显式传 `--account`。详细规则见 [运行库登录说明](../platform-runtime/references/login.md)。

```bash
x-hunter check
x-hunter search '关键词' --limit 20
x-hunter user '<用户ID或主页链接>'
x-hunter user-posts '<用户ID或主页链接>' --limit 20
x-hunter comments '<作品链接>' --limit 20
x-hunter fetch '<作品链接>' --output-dir /绝对路径/样本 --download-media
x-hunter fetch '<视频链接>' --output-dir /绝对路径/样本 --download-media --video-only
x-hunter methods
x-hunter call <resource> <action> [平台选项]
```

普通查询返回 JSON 信封，`data` 是数组或对象，`page` 保留游标；fetch 返回 `note`、`media_paths`，保存 `note.json` 和有序媒体文件。保留真实来源、完整字符串 ID 与原始计数，缺项为 null，不补零。终端缩略 ID 不能用于下一步。核对账号作品的作者身份；数字 uid、用户名与 secUid 不能互换。

列表默认 20 条，`--limit` 范围 1–100；按实际 `page` 游标有界续读，不使用 --all。`call` 只允许 methods 列出的读取接口，不能借此发评论、私信、点赞或关注。会话缺失/明确过期返回 2，风控和网络故障保留独立错误，不触发盲重登。

只读与写接口仍需真实账号验收。媒体搜索 --type video/image 不支持 --sort latest；推荐流可读，关注流未实现。通知、粉丝/关注列表和收藏列表尚不支持。

视频先下载再交 `viral-chaser` 本地 analyzer，采用返回的实际视频路径；`--video-only` 在下载前拒绝图文。图文和文字采样在 `expert-twitter` 或调用方 workflow 回读原文与图片分析。创作/发布/本人数据走 `expert-twitter`；互动走 expert-bd，公开商业信息分析走 expert-osbi；X 直播尚无已实现接口。下载依赖平台返回的实际可访问媒体 URL，失败不回报下载成功。

