MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X / 看看大家怎么评价 X / X 上有什么讨论 / researc
复制下面这句话，粘贴给 Claude Code、Codex、Cursor 等 AI 编程工具，它会读取安装说明并在你确认后完成安装。
请阅读 https://ai.atlankj.com/install/asset/gh-skill-c7ecee44e84d ，按照其中的说明把「agent-reach」安装到你（当前 AI 工具）中。执行前先告诉我将运行的命令和写入的位置，等我确认。
查看 AI 将读取的安装说明正在读取 GitHub 原文…
内容来自 GitHub 原始文件，由原作者维护。在 GitHub 查看
16 平台、多后端。本 skill 存在时必须用它访问这些平台，不要自己发明方案。
agent-reach doctor --json。active_backend 有值时按它选命令组；active_backend: null
表示 Doctor 为避免触发浏览器 Cookie 读取或远端写入而没有做实时验证，不代表后端不存在。
Doctor 结果是「某一时刻的快照」，通道/登录态可能已变化；执行只读命令前若怀疑失效，
按对应 reference 的「体检与恢复」runbook 重新确认（如 career.md 的 Boss直聘 CDP 排查）。agent-reach check-update（很快，一个 API 调用）。有新版就在收尾汇报里附一句：
「Agent Reach 有新版 vX.Y.Z，复制这句话给我即可更新：帮我更新 Agent Reach：
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」。
不要中断当前任务去更新，也不要重复提醒同一个版本。| 用户意图 | 分类 | 详细文档 |
|---|---|---|
| 网页搜索/代码搜索 | search | references/search.md |
| 小红书/推特/B站/V2EX/Reddit/Facebook/Instagram | social | references/social.md |
| 招聘/职位/LinkedIn/Boss直聘 | career | references/career.md |
| GitHub/代码 | dev | references/dev.md |
| 网页/文章/RSS | web | references/web.md |
| YouTube/B站/播客字幕 | video | references/video.md |
| 雪球/股票行情 | finance | references/finance.md |
# Exa 网页搜索
mcporter call exa.web_search_exa query="query" numResults=5
# 通用网页阅读
curl -s "https://r.jina.ai/URL"
# GitHub 搜索
gh search repos "query" --sort stars --limit 10
# YouTube 字幕（注意：B站不要用 yt-dlp，失败重试链见 video.md）
yt-dlp --write-sub --write-auto-sub --skip-download -o "/tmp/%(id)s" "URL"
# V2EX 热门
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
# B站搜索（bili-cli，无需登录）
bili search "query" --type video -n 5
Twitter 注意：agent-reach configure twitter-cookies 保存的 Cookie 只供
doctor 检查配置是否齐全；doctor 不执行 twitter status，也不会设置当前
Shell。直接运行 twitter 前，必须在子进程环境中显式提供
TWITTER_AUTH_TOKEN 和 TWITTER_CT0，不得在日志或命令回显中暴露值。
小红书注意：Agent Reach 不替用户登录，也不读取浏览器 Cookie。OpenCLI 只用 用户已有且明确控制的 Chrome 会话；没有现成会话时不要自动登录，改用 Cookie-Editor 手工导出后配置 xiaohongshu-mcp / 存量工具。
Boss直聘配置触发：当用户说“帮我配 Boss直聘”时，先读取 references/career.md
的 Boss 章节，然后在获得安装授权后运行
agent-reach install --env=local --system --channels=boss。Agent 负责按系统启动
只绑定 127.0.0.1:9222 的专用 Chrome；拉起后第一步是暂停并让用户肉眼确认
窗口内是已登录状态（右上角有头像），未登录则让用户登录/扫码，用户确认后再运行
boss --cdp-url http://localhost:9222 login --cdp 和 agent-reach doctor 验收。
不要让用户自己研究端口参数。
专用 Chrome profile 必须长期复用，不要每次创建，也不要默认改用日常主 Chrome。
判断 CDP 浏览器登录态不要信 boss status（它只校验本地 session.enc，与
浏览器登录态互不代表），以 agent-reach doctor 的浏览器 cookie 探测（wt2）
为准，并配合用户肉眼确认。绝不用当前页 URL 判断登录态：
security-check / zhipin-security / _security_check 安全校验页是 Boss 反爬挑战，
与登录无关——已登录也会出现（带 CDP 调试端口的 Chrome 几乎必现）。看到它不要
当成“未登录”，先跑 agent-reach doctor 看浏览器 cookie，再决定是否需要用户登录。
搜索报 AUTH_EXPIRED 即浏览器未登录的 ground truth：直接走登录流程 + login --cdp，
不要往安全校验方向解释。
执行搜索时必须使用
boss --browser-source existing-browser --cdp-url http://localhost:9222 search ...；
遇到 ENVIRONMENT_RISK 立即停止，不刷新、不重新登录、不自动重试。
# Twitter 搜索（twitter-cli 首选；失败重试链见 social.md）
twitter search "query" -n 10
# Reddit（无零配置路径：OpenCLI 或 rdt-cli，必须登录态）
opencli reddit search "query" -f yaml # 桌面
rdt search "query" --limit 10 # 存量/服务器
# 小红书（桌面首选 OpenCLI）
opencli xiaohongshu search "query" -f yaml
# Facebook / Instagram（桌面 OpenCLI，复用浏览器登录态）
opencli facebook search "query" -f yaml
opencli facebook groups -f yaml
opencli instagram search "query" -f yaml # 搜用户
opencli instagram user USERNAME -f yaml # 读指定用户最近帖子
本机 Python 环境默认是 conda
dl；若agent-reach不在 PATH，用conda run -n dl agent-reach ...前缀。
# 检查可用 channel 与每个平台当前激活的后端
conda run -n dl agent-reach doctor --json
路由表没有覆盖用户需要的平台或命令时，先用 opencli list 查已有适配器，再用
opencli <平台> --help 查看公开命令。发现适配器只证明命令存在，不证明登录态或
目标内容可用；仅在用户任务明确需要该平台时执行只读命令，并以实际非空内容验收。
不要在 agent workspace 创建文件。 使用 /tmp/ 存放临时输出，~/.agent-reach/ 存放持久数据。
根据用户需求，阅读对应的详细文档：
如果某个 channel 需要配置，获取安装指南： https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
用户只需提供 cookies，其他配置由 agent 完成。