{"owner":"Panniantong","repo":"Agent-Reach","hasSkills":true,"totalSkillsCount":8,"totalTokensCount":13127,"categories":["root-instruction","anthropic-skill"],"hasMcp":false,"mcpConfig":null,"found":["llms.txt","agent_reach/skill/references/search.md","agent_reach/skill/references/dev.md","agent_reach/skill/references/web.md","agent_reach/skill/references/video.md","agent_reach/skill/SKILL.md","agent_reach/skill/references/career.md","agent_reach/skill/references/social.md"],"skills":{"llms.txt":"# Agent Reach\n\n> Give your AI agent eyes to see the internet. Agent Reach installs, routes, and health-checks upstream tools for 15 platforms — Twitter/X, Reddit, Facebook, Instagram, YouTube, GitHub, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Xiaoyuzhou Podcast, RSS, web search, and any web page. One install, zero API fees.\n\n## Quick Start\n\n- [Installation Guide](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md): Step-by-step setup instructions for AI agents\n- [README (中文)](https://github.com/Panniantong/Agent-Reach/blob/main/README.md): Full documentation in Chinese\n- [README (English)](https://github.com/Panniantong/Agent-Reach/blob/main/docs/README_en.md): Full documentation in English\n\n## Core Commands\n\n- [CLI Usage](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md): `agent-reach doctor --json` shows the active backend; agents then call upstream tools directly (`opencli`, `twitter`, `bili`, `yt-dlp`, `gh`, `mcporter`, etc.).\n\n## Key Features\n\n- Read any URL: tweets, Reddit posts, Facebook pages/feed/groups, Instagram profiles/posts, YouTube videos (transcripts), GitHub repos, articles, XiaoHongShu notes, Bilibili videos, RSS feeds\n- Search/discover across platforms: Twitter/X, Reddit, Facebook, Instagram user search, GitHub, YouTube, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Web (via Exa)\n- Self-diagnosis: `agent-reach doctor` checks what works and what needs setup\n- Auto-installs dependencies: `agent-reach install --env=auto`\n- Browser-session / cookie auth for platforms that require login (Twitter, Reddit, Facebook, Instagram, XiaoHongShu, Xueqiu)\n- Proxy support for platforms that block server IPs (Reddit, Twitter)\n- Zero API fees: all backends are free and open-source (OpenCLI, twitter-cli, rdt-cli, bili-cli, yt-dlp, Jina Reader, mcporter/Exa, etc.)\n\n## Troubleshooting\n\n- [Troubleshooting Guide](https://github.com/Panniantong/Agent-Reach/blob/main/docs/troubleshooting.md): Common issues and solutions\n\n## Optional\n\n- [SKILL.md](https://github.com/Panniantong/Agent-Reach/blob/main/agent_reach/skill/SKILL.md): Integration guide for AI agent frameworks (OpenClaw, Claude Code, etc.)\n- Install from GitHub (the `agent-reach` package on PyPI is NOT this project): `pipx install https://github.com/Panniantong/agent-reach/archive/main.zip`\n","agent_reach/skill/references/search.md":"# 搜索工具\n\nExa AI 搜索引擎。\n\n## Exa AI 搜索\n\n高质量 AI 搜索引擎，适合查找技术文档、官方示例和相关网页。\n\n```bash\nmcporter call exa.web_search_exa query=\"query\" numResults=5\nmcporter call exa.web_search_exa query=\"library API code example\" numResults=5\n```\n\n### 使用场景\n\n| 场景 | 参数 |\n|-----|------|\n| 网页搜索 | `web_search_exa(query: \"...\", numResults: 5)` |\n| 技术/代码资料 | `web_search_exa(query: \"框架名 API 示例\", numResults: 5)` |\n\n> Exa MCP 的 `get_code_context_exa` 已弃用且默认不注册。代码问题也使用\n> `web_search_exa`；需要精确搜索仓库内容时，改用 `dev.md` 中的 GitHub 搜索。\n\n### 特点\n\n- 擅长英文内容和技术文档\n- 可通过查询词定位官方文档和代码示例\n- 结果质量高\n\n## 与其他搜索工具对比\n\n| 工具 | 来源 | 适用场景 |\n|-----|------|---------|\n| Exa | agent-reach | 英文/技术/代码搜索 |\n| 智谱搜索 | my-mcp-tools | 中文搜索 |\n| GitHub 搜索 | agent-reach (dev.md) | 仓库/代码搜索 |\n","agent_reach/skill/references/dev.md":"# 开发工具\n\nGitHub CLI \n\n## GitHub (gh CLI)\n\nGitHub 官方命令行工具，用于仓库、Issue、PR、Actions、Release 以及 API 访问。\n\n```bash\n# 认证\ngh auth login\ngh auth status\n\n# 搜索\ngh search repos \"query\" --sort stars --limit 10\ngh search code \"query\" --language python\n\n# 仓库\ngh repo view owner/repo\ngh repo clone owner/repo\ngh repo create my-repo --private\ngh repo fork owner/repo\ngh repo fork owner/repo --clone\ngh repo sync owner/repo\n\n# Issues\ngh issue list -R owner/repo --state open\ngh issue view 123 -R owner/repo\ngh issue create -R owner/repo --title \"Title\" --body \"Body\"\n\n# Pull Requests\ngh pr list -R owner/repo --state open\ngh pr view 123 -R owner/repo\ngh pr create -R owner/repo --title \"Title\" --body \"Body\"\ngh pr checks 123 --repo owner/repo\n\n# Actions / CI\ngh run list --repo owner/repo --limit 10\ngh run view --repo owner/repo\ngh run view --repo owner/repo --log-failed\ngh workflow list --repo owner/repo\n\n# Releases\ngh release list -R owner/repo\ngh release create v1.0.0\n\n# API\ngh api /user\ngh api repos/owner/repo\n\n# JSON 输出\ngh issue list --repo owner/repo --json number,title --jq '.[] | \"\\(.number): \\(.title)\"'\n```\n\n\n## 选择指南\n\n| 工具 | 来源 | 用途 |\n|-----|------|------|\n| gh CLI | agent-reach | Git 操作 |\n| zread | my-mcp-tools | 读仓库内容 |\n| context7 | my-mcp-tools | 查技术文档 |\n","agent_reach/skill/references/web.md":"# 网页阅读\n\n通用网页、RSS。\n\n## 通用网页 (Jina Reader)\n\n```bash\n# 读取任意网页内容\ncurl -s \"https://r.jina.ai/URL\"\n\n# 示例\ncurl -s \"https://r.jina.ai/https://example.com/article\"\n```\n\n**适用场景**: 大多数网页可以直接用 Jina Reader 读取。\n\n## Web Reader (MCP)\n\n```bash\n# 读取网页内容 (Markdown 格式)\nmcporter call web-reader.webReader url=\"https://example.com\"\n\n# 保留图片\nmcporter call web-reader.webReader url=\"https://example.com\" retain_images=true\n\n# 纯文本格式\nmcporter call web-reader.webReader url=\"https://example.com\" return_format=\"text\"\n```\n\n**适用场景**: 需要更精确控制输出格式时使用。\n\n## RSS (feedparser)\n\n```python\npython3 -c \"\nimport feedparser\nfor e in feedparser.parse('FEED_URL').entries[:5]:\n print(f'{e.title} — {e.link}')\n\"\n```\n\n**适用场景**: 订阅博客、新闻源、播客等 RSS feed。\n\n## 选择指南\n\n| 场景 | 推荐工具 |\n|-----|---------|\n| 通用网页 | Jina Reader (`curl r.jina.ai`) |\n| 需要图片/格式控制 | web-reader MCP |\n| RSS 订阅 | feedparser |\n","agent_reach/skill/references/video.md":"# 视频/播客\n\nYouTube、B站、小宇宙播客的字幕和转录。\n\n## YouTube (yt-dlp)\n\n### 获取视频元数据\n\n```bash\nyt-dlp --dump-json \"URL\"\n```\n\n### 下载字幕\n\n```bash\n# 下载字幕 (不下载视频)\nyt-dlp --write-sub --write-auto-sub --sub-lang \"zh-Hans,zh,en\" --skip-download -o \"/tmp/%(id)s\" \"URL\"\n\n# 然后读取 .vtt 文件\ncat /tmp/VIDEO_ID.*.vtt\n```\n\n### 获取评论\n\n```bash\n# 提取评论（best-effort，不保证完整）\nyt-dlp --write-comments --skip-download --write-info-json \\\n --extractor-args \"youtube:max_comments=20\" \\\n -o \"/tmp/%(id)s\" \"URL\"\n# 评论在 .info.json 的 comments 字段中\n```\n\n### 搜索视频\n\n```bash\nyt-dlp --dump-json \"ytsearch5:query\"\n```\n\n> **字幕注意**: 手动上传的字幕提取可靠；自动生成字幕可能存在行间重复，需后处理。\n> **评论注意**: `--write-comments` 基于网页抓取（非 YouTube Data API），部分评论可能丢失。\n\n### 字幕失败时的重试链（按序执行，拿到实质内容即停）\n\n`doctor` 只确认 yt-dlp 本体与 JS runtime 能执行，不会请求具体视频；因此\n`active_backend: yt-dlp` 不等于目标视频的字幕已经通过实时验证。\n\n1. 先用上面的 `yt-dlp --write-sub --write-auto-sub` 命令。\n2. 若出现 bot 校验、字幕响应为空或没有生成字幕文件，且 OpenCLI 已连接：\n `opencli youtube transcript \"URL\" -f yaml`。\n3. OpenCLI 若返回 `Caption URL returned empty response`，最多重试 3 次；这是带\n 过期时间的字幕 URL 偶发失效，不能把空响应当成“视频没有字幕”。\n4. 仍失败或视频本来就没有字幕：`agent-reach transcribe \"URL\"` 下载音频转写。\n\n成功标准是实际得到非空字幕/转录内容，不是命令退出码或 `doctor` 的版本探测结果。\n\n### 无字幕兜底：Whisper 音频转写\n\n```bash\n# 视频没有字幕时的兜底：下载音频并用 Whisper 转写（Groq 免费 key 即可）\nagent-reach transcribe \"https://www.youtube.com/watch?v=VIDEO_ID\"\nagent-reach transcribe ./local_audio.mp3 -o /tmp/transcript.txt\n```\n\n> `agent-reach transcribe` 只接收公开 http(s) URL 或本地音频文件。用 `ytsearch5:` 搜索时，先从 yt-dlp 结果里选出具体视频 URL，再转写。\n> 需要先配置 key：`agent-reach configure groq-key`（隐藏输入；免费，console.groq.com）\n> 或 `agent-reach configure openai-key`。默认 auto 模式只使用第一个已配置服务商\n>（优先 Groq，否则 OpenAI），失败即停止，不会把音频自动发给另一家。\n> `--allow-provider-fallback` 会显式授权跨服务商降级；同一音频内容可能被 Groq 和\n> OpenAI 分别处理，并可能产生 OpenAI 费用，只应在确认内容可分享给两家后使用。\n\n## B站 / Bilibili（bili-cli 为主，OpenCLI 补字幕）\n\n> ⚠️ **不要用 yt-dlp 读 B站**：B站风控已全面 412 拦截 yt-dlp（实测最新版、直连/代理/带 Cookie 全部无效）。yt-dlp 只用于 YouTube。\n\n### 视频详情/搜索/热门/排行 (bili-cli，只读无需登录)\n\n```bash\n# 视频详情（标题/UP主/时长/播放互动数据/字幕可用性）\nbili video BVxxx\n\n# 搜索视频\nbili search \"query\" --type video -n 5\n\n# 热门视频 / 排行榜\nbili hot -n 10\nbili rank -n 10\n\n# 下载音频并切分为 ASR-ready WAV（无字幕时配合 agent-reach transcribe 转写）\nbili audio BVxxx\n```\n\n### 字幕 (OpenCLI，需要桌面 Chrome)\n\n```bash\n# 字幕逐句带时间轴\nopencli bilibili subtitle BVxxx\n\n# OpenCLI 也能搜索/读视频元数据（备选）\nopencli bilibili search \"query\" -f yaml\nopencli bilibili video BVxxx -f yaml\n```\n\n### 零配置兜底：搜索 API 直连\n\n```bash\nUA=\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36\"\ncurl -s -c /tmp/bili_ck.txt -o /dev/null -A \"$UA\" \"https://www.bilibili.com/\"\ncurl -s -b /tmp/bili_ck.txt -A \"$UA\" -e \"https://www.bilibili.com/\" \\\n \"https://api.bilibili.com/x/web-interface/search/all/v2?keyword=QUERY&page=1\"\n```\n\n> **安装 bili-cli**: `pipx install bilibili-cli`（上游 2026-03 起停更但实测健康；只读场景无需登录，`bili login` 扫码可解锁动态/收藏等个人功能）。\n\n## 小宇宙播客 / Xiaoyuzhou Podcast\n\n### 转录单集播客（可选 --polish 增强标点）\n\n```bash\n# 输出 Markdown 文件到 /tmp/。--polish 让 Llama 3.3 70B 给文稿补中文标点+合理分段\n~/.agent-reach/tools/xiaoyuzhou/transcribe.sh --polish \"https://www.xiaoyuzhoufm.com/episode/EPISODE_ID\"\n```\n\n> 转写 prompt 已要求 Whisper 输出中文标点；若标点效果仍不理想，可加 `--polish` 用 Groq 上免费的 Llama 3.3 70B 补标点+合理分段（9 分钟播客约多 ~7 秒）。每次转写多一轮 LLM 调用，按需使用。\n\n### 前置要求\n\n1. **ffmpeg**: `brew install ffmpeg`\n2. **Groq API Key** (免费): https://console.groq.com/keys\n3. **配置 Key**: `agent-reach configure groq-key`（隐藏输入）\n4. **首次运行**: `agent-reach install --env=auto --system --channels=xiaoyuzhou`（需用户明确授权）\n\n### 检查状态\n\n```bash\nagent-reach doctor\n```\n\n> 输出 Markdown 文件默认保存到 `/tmp/`。\n\n## 选择指南\n\n| 场景 | 推荐工具 |\n|-----|---------|\n| YouTube 字幕 | yt-dlp；失败时 OpenCLI（最多 3 次）→ agent-reach transcribe |\n| B站视频详情/搜索 | bili-cli |\n| B站字幕 | opencli bilibili subtitle |\n| 播客转录 | 小宇宙 transcribe.sh |\n| 无字幕音视频 | agent-reach transcribe（B站音频先 `bili audio`） |\n","agent_reach/skill/SKILL.md":"---\nname: agent-reach\ndescription: >\n MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything\n on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X /\n 看看大家怎么评价 X / X 上有什么讨论 / research this topic。\n\n Also MUST USE when user mentions any platform or shares any URL/链接:\n 小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili, Reddit, Facebook,\n Instagram, V2EX, LinkedIn/领英/Boss直聘/招聘/求职/jobs, YouTube, GitHub code search, 小宇宙播客,\n 雪球/股票行情, RSS feeds, or any web URL.\n\n 16 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs).\n Zero config for 6 channels. Run `agent-reach doctor --json` to see which\n backend serves each platform right now.\n\n NOT for: 写报告/数据分析/翻译等内容加工（本 skill 只负责从互联网获取内容）；\n 发帖/评论/点赞等写操作；已有专门 skill 的平台（先用专门 skill）。\n\n 【路由方式】SKILL.md 包含路由表和常用命令，复杂场景需按需阅读对应分类的 references/*.md。\n 分类：search / social (小红书/推特/B站/V2EX/Reddit/Facebook/Instagram) / career(LinkedIn/Boss直聘) / dev(github) / web(网页/文章/RSS) / video(YouTube/B站/播客) / finance(雪球/股票)。\nmetadata:\n homepage: https://github.com/Panniantong/Agent-Reach\n---\n\n# Agent Reach — 互联网能力路由器\n\n16 平台、多后端。**本 skill 存在时必须用它访问这些平台，不要自己发明方案。**\n\n## 常驻规则（全程适用）\n\n1. **动手前先体检**：多后端/登录态平台（小红书/Reddit/B站/Twitter/Facebook/Instagram/Boss直聘）先跑\n `agent-reach doctor --json`。`active_backend` 有值时按它选命令组；`active_backend: null`\n 表示 Doctor 为避免触发浏览器 Cookie 读取或远端写入而没有做实时验证，不代表后端不存在。\n Doctor 结果是「某一时刻的快照」，通道/登录态可能已变化；执行只读命令前若怀疑失效，\n 按对应 reference 的「体检与恢复」runbook 重新确认（如 career.md 的 Boss直聘 CDP 排查）。\n2. **声明你在用什么**：开始干活前说一句「使用 agent-reach 的 X 平台 / Y 后端」。\n3. **失败按 references 里的重试链处理**，不要瞎猜命令。\n4. **全网调研类任务**：组合多平台（Exa 搜索 + Twitter/Reddit 看讨论 + 小红书/B站看中文场景），并行收集再汇总。\n5. **替用户盯版本**：完成一次较大的调研/多平台任务后，顺手跑\n `agent-reach check-update`（很快，一个 API 调用）。有新版就在收尾汇报里附一句：\n 「Agent Reach 有新版 vX.Y.Z，复制这句话给我即可更新：帮我更新 Agent Reach：\n https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」。\n 不要中断当前任务去更新，也不要重复提醒同一个版本。\n\n## 路由表\n\n| 用户意图 | 分类 | 详细文档 |\n|---------|------|---------|\n| 网页搜索/代码搜索 | search | [references/search.md](references/search.md) |\n| 小红书/推特/B站/V2EX/Reddit/Facebook/Instagram | social | [references/social.md](references/social.md) |\n| 招聘/职位/LinkedIn/Boss直聘 | career | [references/career.md](references/career.md) |\n| GitHub/代码 | dev | [references/dev.md](references/dev.md) |\n| 网页/文章/RSS | web | [references/web.md](references/web.md) |\n| YouTube/B站/播客字幕 | video | [references/video.md](references/video.md) |\n| 雪球/股票行情 | finance | [references/finance.md](references/finance.md) |\n\n## 零配置快速命令\n\n```bash\n# Exa 网页搜索\nmcporter call exa.web_search_exa query=\"query\" numResults=5\n\n# 通用网页阅读\ncurl -s \"https://r.jina.ai/URL\"\n\n# GitHub 搜索\ngh search repos \"query\" --sort stars --limit 10\n\n# YouTube 字幕（注意：B站不要用 yt-dlp，失败重试链见 video.md）\nyt-dlp --write-sub --write-auto-sub --skip-download -o \"/tmp/%(id)s\" \"URL\"\n\n# V2EX 热门\ncurl -s \"https://www.v2ex.com/api/topics/hot.json\" -H \"User-Agent: agent-reach/1.0\"\n\n# B站搜索（bili-cli，无需登录）\nbili search \"query\" --type video -n 5\n```\n\n## 需登录态的平台（按 doctor 的 active_backend 选命令）\n\nTwitter 注意：`agent-reach configure twitter-cookies` 保存的 Cookie 只供\n`doctor` 检查配置是否齐全；`doctor` 不执行 `twitter status`，也不会设置当前\nShell。直接运行 `twitter` 前，必须在子进程环境中显式提供\n`TWITTER_AUTH_TOKEN` 和 `TWITTER_CT0`，不得在日志或命令回显中暴露值。\n\n小红书注意：Agent Reach 不替用户登录，也不读取浏览器 Cookie。OpenCLI 只用\n用户已有且明确控制的 Chrome 会话；没有现成会话时不要自动登录，改用\nCookie-Editor 手工导出后配置 xiaohongshu-mcp / 存量工具。\n\nBoss直聘配置触发：当用户说“帮我配 Boss直聘”时，先读取 `references/career.md`\n的 Boss 章节，然后在获得安装授权后运行\n`agent-reach install --env=local --system --channels=boss`。Agent 负责按系统启动\n只绑定 `127.0.0.1:9222` 的专用 Chrome；**拉起后第一步是暂停并让用户肉眼确认**\n窗口内是已登录状态（右上角有头像），未登录则让用户登录/扫码，用户确认后再运行\n`boss --cdp-url http://localhost:9222 login --cdp` 和 `agent-reach doctor` 验收。\n不要让用户自己研究端口参数。\n专用 Chrome profile 必须长期复用，不要每次创建，也不要默认改用日常主 Chrome。\n\n判断 CDP 浏览器登录态**不要信 `boss status`**（它只校验本地 session.enc，与\n浏览器登录态互不代表），以 `agent-reach doctor` 的浏览器 cookie 探测（wt2）\n为准，并配合用户肉眼确认。绝不用当前页 URL 判断登录态：\n`security-check` / `zhipin-security` / `_security_check` 安全校验页是 Boss 反爬挑战，\n与登录无关——已登录也会出现（带 CDP 调试端口的 Chrome 几乎必现）。看到它不要\n当成“未登录”，先跑 `agent-reach doctor` 看浏览器 cookie，再决定是否需要用户登录。\n搜索报 `AUTH_EXPIRED` 即浏览器未登录的 ground truth：直接走登录流程 + `login --cdp`，\n不要往安全校验方向解释。\n\n执行搜索时必须使用\n`boss --browser-source existing-browser --cdp-url http://localhost:9222 search ...`；\n遇到 `ENVIRONMENT_RISK` 立即停止，不刷新、不重新登录、不自动重试。\n\n```bash\n# Twitter 搜索（twitter-cli 首选；失败重试链见 social.md）\ntwitter search \"query\" -n 10\n\n# Reddit（无零配置路径：OpenCLI 或 rdt-cli，必须登录态）\nopencli reddit search \"query\" -f yaml # 桌面\nrdt search \"query\" --limit 10 # 存量/服务器\n\n# 小红书（桌面首选 OpenCLI）\nopencli xiaohongshu search \"query\" -f yaml\n\n# Facebook / Instagram（桌面 OpenCLI，复用浏览器登录态）\nopencli facebook search \"query\" -f yaml\nopencli facebook groups -f yaml\nopencli instagram search \"query\" -f yaml # 搜用户\nopencli instagram user USERNAME -f yaml # 读指定用户最近帖子\n```\n\n## 环境检查\n\n```bash\n# 检查可用 channel 与每个平台当前激活的后端\nagent-reach doctor --json\n```\n\n## OpenCLI 适配器发现\n\n路由表没有覆盖用户需要的平台或命令时，先用 `opencli list` 查已有适配器，再用\n`opencli <平台> --help` 查看公开命令。发现适配器只证明命令存在，不证明登录态或\n目标内容可用；仅在用户任务明确需要该平台时执行只读命令，并以实际非空内容验收。\n\n## 工作区规则\n\n**不要在 agent workspace 创建文件。** 使用 `/tmp/` 存放临时输出，`~/.agent-reach/` 存放持久数据。\n\n## 详细文档\n\n根据用户需求，阅读对应的详细文档：\n\n- [搜索工具](references/search.md) — Exa AI 搜索\n- [社交媒体](references/social.md) — 小红书, Twitter, B站, V2EX, Reddit, Facebook, Instagram（多后端/登录态命令组）\n- [职场招聘](references/career.md) — LinkedIn, Boss直聘\n- [开发工具](references/dev.md) — GitHub CLI\n- [网页阅读](references/web.md) — Jina Reader, RSS\n- [视频播客](references/video.md) — YouTube, B站, 小宇宙\n- [金融行情](references/finance.md) — 雪球股票行情、搜索、热门内容\n\n## 配置渠道\n\n如果某个 channel 需要配置，获取安装指南：\nhttps://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md\n\n用户只需提供 cookies，其他配置由 agent 完成。\n","agent_reach/skill/references/career.md":"# 职场招聘\n\nLinkedIn、Boss直聘。\n\n## LinkedIn\n\n```bash\n# 获取个人资料\nmcporter call linkedin.get_person_profile linkedin_username=\"username\" sections=\"experience,education\"\n\n# 搜索人才\nmcporter call linkedin.search_people keywords=\"AI engineer\" location=\"Shanghai\"\n\n# 获取公司资料\nmcporter call linkedin.get_company_profile company_name=\"openai\" sections=\"posts,jobs\"\n\n# 搜索职位\nmcporter call linkedin.search_jobs keywords=\"software engineer\" location=\"Remote\" max_pages=2\n```\n\n> **需要登录**: 首次使用前运行 `uvx mcp-server-linkedin@latest --login`，保存有效登录态。\n\n### Fallback 方案\n\n如果 MCP 不可用，可以用 Jina Reader：\n\n```bash\ncurl -s \"https://r.jina.ai/https://linkedin.com/in/username\"\n```\n\n## Boss直聘\n\n当用户说“帮我配 Boss直聘”时，按本节完成安装、启动专用 Chrome、等待用户手动\n登录和最终验证。不要把 9222 端口等实现细节先甩给用户，也不要替用户输入账号、\n扫码或处理滑块。\n\n> **关键区分：登录门槛 ≠ 反爬安全校验。** zhipin.com 落地后可能停在三种页面：\n> 已登录的 `web/geek/job`、未登录的 `web/user/`（扫码登录/手机号登录）、以及\n> 反爬的**安全校验页**（URL 含 `security-check` / `zhipin-security` /\n> `_security_check`）。安全校验页与登录无关：**已登录也会出现**（带 CDP 调试\n> 端口的 Chrome 几乎必现）。绝不用当前页 URL 判断登录态。\n\n> **双登录态存储（existing-browser 严格 CDP 模式下以浏览器为准）。** 存在两个凭据存储，\n> **都不能删**，但认证的是不同通道：\n>\n> | 存储 | 角色 |\n> |---|---|\n> | `~/.boss-agent/auth/session.enc` | ① 硬性门槛：`_get_browser()` 无条件 `get_token()`，读不到直接 `AuthRequired`，CDP 搜索会在连浏览器前就失败；② **不是**搜索的认证凭据：CDP 复用真 Chrome 的 `contexts[0]` 时，它的 cookies 只在「无 context」分支注入，实际从未生效；③ httpx 通道（低危 op：`status`/`detail`/`cities`/`job_card_httpx`）真用它的 cookies + stoken，code 37 的 `force_refresh()` 也回写它 |\n> | 专用 Chrome profile 内的浏览器 cookie | CDP 模式下 search/greet 等高危 op 实际携带的凭据 |\n>\n> **`boss status` / `status --live` 只校验 session.enc**——即使报\n> `logged_in: true`，也不代表 CDP 浏览器已登录。所以：\n> 1. 拉起专用 Chrome 后，第一步必须**暂停并让用户肉眼确认**窗口内是已登录\n> 状态（右上角有头像），确认后才允许执行搜索；\n> 2. doctor 的 boss 行会直接探测浏览器内有无 wt2 cookie，以它为准；\n> 3. **`AUTH_EXPIRED` 是 ground truth**：搜索报它就直接走登录 runbook\n> （用户在专用窗口登录 → `login --cdp`），禁止再往「安全校验」方向解释；\n> `_security_check` 页面只在 `AUTH_EXPIRED` 不存在时才按滑块处理。\n> 4. 不要为了「清理旧凭据」删除 session.enc；要刷新它就跑 `login --cdp`。\n\n> **依赖状态**：所需公开 strict-CDP API 来自 boss-agent-cli 后继拆分 PR #403–#407\n> （#402/#382 已按维护者意见拆分），已全部合并入上游 master。Agent Reach 的安装器锁定\n> 上游固定提交\n> `4c991b77086a203173bf08a4cb64a23af6514fe6`，而不是会移动的 branch；上游发布正式版后\n> 应把安装器切回版本约束。\n\n体检（无副作用，不搜索）：\n\n```bash\nagent-reach doctor # boss 行：off = 未装或 CDP 不通；warn = 链路就绪，\n # message 会注明浏览器内有无 wt2 登录 cookie（以浏览器为准）\n```\n\n搜索 + JD 使用公开 API（`browser_source` / `job_card_browser` / `JobItem.lid`）。\n因为 pipx/uv tool 是隔离环境，普通 `python` 不一定能 import 已安装工具；\n用 `uv run --with` 保证脚本和锁定依赖处于同一解释器环境：\n\n```bash\nuv run --isolated --no-project \\\n --with 'git+https://github.com/can4hou6joeng4/boss-agent-cli.git@4c991b77086a203173bf08a4cb64a23af6514fe6' \\\n python - <<'PY'\nfrom pathlib import Path\n\nfrom boss_agent_cli.api.client import AccountRiskError, BossClient, EnvironmentRiskError\nfrom boss_agent_cli.auth.manager import AuthManager\nfrom boss_agent_cli.platforms.zhipin import BossPlatform\n\nauth = AuthManager(Path.home() / \".boss-agent\")\n\n# 严格 CDP 模式：复用已登录浏览器、CDP 失败立即抛错、永不 headless\nwith BossClient(\n auth,\n cdp_url=\"http://localhost:9222\",\n browser_source=\"existing-browser\",\n) as boss:\n raw = boss.search_jobs(\"大模型\", city=\"深圳\", page=1)\n if raw.get(\"code\") != 0:\n code, message = BossPlatform(boss).parse_error(raw)\n raise RuntimeError(f\"{code}: {message}\")\n items = raw.get(\"zpData\", {}).get(\"jobList\", [])\n for item in items:\n card = boss.job_card_browser(item[\"securityId\"], item[\"lid\"])\n post_desc = card.get(\"zpData\", {}).get(\"jobCard\", {}).get(\n \"postDescription\", \"\"\n )\n print(item.get(\"jobName\"), post_desc)\n\n# AccountRiskError / EnvironmentRiskError → 立即停止，不自动重试；\n# 明确 token/stoken 过期的 code 37 由 BossClient 最多刷新并重试一次。\nPY\n```\n\n### 环境体检与恢复（抓取前必查）\n\n搜索前若 `agent-reach doctor` 报 boss 为 `off` 或 `warn`，按下面 runbook 排查，不要读源码瞎猜：\n\n1. **CDP 端口通不通**：\n ```bash\n curl -s http://localhost:9222/json/version # 有 Browser 字段 = 端口通\n ```\n\n2. **调试 Chrome 没开 / 已关**：按系统启动专用 Chrome（登录态独立，不污染日常浏览器）：\n ```bash\n # macOS\n open -na \"Google Chrome\" --args --remote-debugging-address=127.0.0.1 \\\n --remote-debugging-port=9222 --user-data-dir=\"$HOME/.boss-chrome-profile\" \\\n \"https://www.zhipin.com/web/geek/job\"\n\n # Linux\n google-chrome --remote-debugging-address=127.0.0.1 \\\n --remote-debugging-port=9222 --user-data-dir=\"$HOME/.boss-chrome-profile\" \\\n \"https://www.zhipin.com/web/geek/job\"\n ```\n\n Windows PowerShell：\n ```powershell\n Start-Process chrome.exe -ArgumentList '--remote-debugging-address=127.0.0.1','--remote-debugging-port=9222',\"--user-data-dir=$env:USERPROFILE\\.boss-chrome-profile\",'https://www.zhipin.com/web/geek/job'\n ```\n\n 只绑定回环地址。任何能访问 9222 的进程都能完全控制该 Chrome；不要监听公网。\n 这个专用 profile 要长期复用，以保留稳定登录态；不要每次运行时删除或新建，\n 也不要默认切换到日常主 Chrome。不使用时关闭这个专用窗口。\n\n **拉起后第一步：暂停并让用户肉眼确认窗口内是已登录状态（右上角有头像）。**\n 不要用 `boss status` 代替这一步——它只校验本地 session.enc，不代表浏览器。\n\n3. **用户手动登录（浏览器未登录时）**：判定以 doctor 的浏览器 cookie 探测为准\n （无 wt2 = 浏览器未登录），其次才是用户肉眼确认；`boss status` 只作参考。\n 让用户在这个专用窗口登录或扫码。用户确认完成后，保存 CDP 登录态：\n ```bash\n boss --cdp-url http://localhost:9222 login --cdp\n ```\n\n 若窗口停在安全校验页（`security-check` / `zhipin-security`），这是反爬挑战、\n 不是登录页：等它自动放行或让用户手动过一下滑块即可，不要当成“未登录”去\n 重新扫码登录。\n\n4. **登录态是否有效**（浏览器 cookie 探测 + stoken 是否过期）：\n ```bash\n agent-reach doctor # 看 boss 行 message 里的浏览器 wt2 cookie 探测结果\n boss status # 只反映本地 session.enc，仅作参考\n ```\n\n5. **错误码处置**（搜索/取 JD 时）：\n - `AUTH_EXPIRED`（用户未登录）→ **ground truth**：CDP 浏览器未登录（不管\n `boss status` 说什么），直接走第 3 步登录流程 + `login --cdp`，禁止往\n 「安全校验」方向解释；\n - code 36（ACCOUNT_RISK）→ 立即停，手动到 BOSS 页面处理，不可自动重试；\n - code 9（RATE_LIMITED）→ 冷却后重试；\n - code 37 + `环境存在异常` → `ENVIRONMENT_RISK`，立即停止，不刷新 Token、不重新登录、不自动重试；\n - 只有文案明确表示 token/stoken 过期的 code 37 才是 `TOKEN_REFRESH_FAILED`；客户端最多自动刷新并重试一次，仍失败再重新登录。\n\n用户要求开始搜索时，Agent 必须指定严格 CDP 模式（全局选项放在子命令之前）：\n\n```bash\nboss --browser-source existing-browser --cdp-url http://localhost:9222 search \"大模型\" --city 广州 --page 1\n```\n\n不要无提示连续翻页。boss-agent-cli PR #383 为跨 CLI 进程的普通搜索增加持久\n5–10 秒列表预算；该 PR 合并发布前，Agent 仍应主动串行、降频调用。\n\n> **等待属预期，不是卡死**：连续搜索命中节流时，boss-agent-cli 会静默等待 5–10 秒\n> （TTY 下会显示「节流等待 Ns…」提示；Agent Reach 以 `--json` 调用，看不到该提示）。\n> 等待窗口内不要重试、不要拉起新浏览器、不要切换 profile。\n","agent_reach/skill/references/social.md":"# 社交媒体 & 社区\n\n小红书、Twitter/X、B站、V2EX、Reddit、Facebook、Instagram。\n\n## 小红书 / XiaoHongShu（多后端）\n\n小红书有三个后端，**先跑 `agent-reach doctor --json` 看 xiaohongshu 的 `active_backend` 是哪个**，再用对应命令组。\n\n### 后端 A：OpenCLI（桌面首选）\n\n```bash\n# 搜索笔记\nopencli xiaohongshu search \"query\" -f yaml\n\n# 读笔记正文+互动数据（用搜索结果里的完整 URL，含 xsec_token）\nopencli xiaohongshu note \"NOTE_URL\" -f yaml\n\n# 评论（支持楼中楼）\nopencli xiaohongshu comments NOTE_ID -f yaml\n\n# 首页推荐 feed\nopencli xiaohongshu feed -f yaml\n\n# 用户主页公开笔记\nopencli xiaohongshu user USER_ID -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展。OpenCLI 只使用用户已经存在且明确控制\n> 的 Chrome 会话；Agent Reach 不替用户登录，也不读取浏览器 Cookie。\n> `agent-reach configure xhs-cookies` 不会把 Cookie 注入 OpenCLI。\n> 如果没有现成会话，不要自动登录；改走后端 B/C，并按对应的\n> Cookie-Editor 手工导出流程配置。\n\n### 后端 B：xiaohongshu-mcp（服务器场景）\n\n```bash\n# 认证前先让用户用 Cookie-Editor 手工导出，再显式导入\nagent-reach configure xhs-cookies\n\n# 只读检查当前状态\nmcporter call xiaohongshu.check_login_status --timeout 120000\n\n# 搜索\nmcporter call xiaohongshu.search_feeds keyword=\"query\" --timeout 120000\n\n# 笔记详情+评论（feed_id 和 xsec_token 从搜索结果取）\nmcporter call xiaohongshu.get_feed_detail feed_id=\"...\" xsec_token=\"...\" --timeout 120000\n```\n\n> 首次调用会自动下载约 150MB 无头浏览器，务必带 `--timeout 120000`。\n> 认证只走 Cookie-Editor 手工导出；导入后先运行 `check_login_status`。\n> 该显式命令会保存/导入用户提供的 xiaohongshu.com 同域 Cookie 集，用户应\n> 确认范围；非 xiaohongshu.com 域 Cookie 会被忽略。\n\n### 后端 C：xhs-cli（存量备选，上游 2026-03 起停更）\n\n```bash\nxhs search \"query\" # 搜索\nxhs read NOTE_ID_OR_URL # 读笔记（必须用搜索结果中的 URL/ID，不能裸 note_id）\nxhs comments NOTE_ID_OR_URL # 评论\nxhs hot # 热门\nxhs feed # 推荐\n```\n\n> 已知不稳定：`xhs user` / `xhs user-posts` / `xhs favorites` 可能返回 API error（上游停更无人修）。新装用户建议直接走后端 A/B。\n\n### 通用注意事项\n\n> **认证边界**: Agent Reach 不得替用户执行小红书登录，也不得读取浏览器\n> Cookie。OpenCLI 只能使用用户已有且明确控制的 Chrome 会话；\n> xiaohongshu-mcp / 存量工具使用 Cookie-Editor 手工导出。\n>\n> **xsec_token 限制**: 小红书强制 xsec_token 机制，**不能直接用裸 note_id 去读**。正确流程：先搜索/feed 拿结果，再用结果中的完整 URL/ID 去读。三个后端都一样。\n>\n> **频率控制**: 高频请求（批量搜索、深翻评论）会触发验证码，平台限制无法绕过。每次操作间隔 2-3 秒。\n>\n> **写操作（发帖/评论/点赞）**: 建议只读。xhs-cli v0.6.x 写操作可能因签名问题返回 406。\n\n## Twitter/X (twitter-cli)\n\n### 认证前置条件\n\n`agent-reach configure twitter-cookies` 通过隐藏输入保存的 Cookie 只供\n`agent-reach doctor` 检查显式凭据是否齐全。`doctor` 不执行上游\n`twitter status`，也不会设置当前 Shell。运行下面任何 `twitter` 命令前，\n必须在同一个 Shell 或子进程环境中显式提供：\n\n```bash\nexport TWITTER_AUTH_TOKEN=\"...\"\nexport TWITTER_CT0=\"...\"\n```\n\n### 稳定命令\n\n```bash\n# 首页时间线（最稳定）\ntwitter feed -n 20\n\n# 读取单条推文（含回复）\ntwitter tweet URL_OR_ID\n\n# 读取长文 / X Article\ntwitter article URL_OR_ID\n\n# 用户时间线\ntwitter user-posts @username -n 20\n\n# 用户资料\ntwitter user @username\n```\n\n### 可能不稳定的命令\n\n```bash\n# 搜索推文（Twitter 频繁改 GraphQL 端点，可能 404）\ntwitter search \"query\" -n 10\n\n# likes（2024 年后只能看自己的，平台限制）\ntwitter likes\n```\n\n### search 失败时的重试链（按序执行，成功即停）\n\n1. 直接重试一次（偶发失败常见）：`twitter search \"query\" -n 10`\n2. 升级后再试：`pipx upgrade twitter-cli && twitter search \"query\" -n 10`\n3. 换 OpenCLI 备选（桌面，复用浏览器登录态）：`opencli twitter search \"query\" -f yaml`\n4. 都不行就改用 `twitter feed` / `twitter user-posts @somebody` 等稳定命令绕路\n\n### 重要注意事项\n\n> **安装**: `pipx install twitter-cli`（确保 v0.8.5+）\n>\n> **认证**: 只用 Cookie-Editor 手工导出，再显式设置环境变量\n> `TWITTER_AUTH_TOKEN` + `TWITTER_CT0`；不要依赖自动浏览器读取。\n>\n> **IP 风控**: 不要在 VPS/数据中心 IP 上频繁调用，尤其是 followers/following，有封号风险。使用住宅代理或本地环境。\n>\n> **OpenCLI 备选**: 桌面装了 OpenCLI 的话，`opencli twitter search/article/user-posts -f yaml` 全套可用（浏览器登录态，无需 cookie 环境变量）。\n>\n> **输出格式**: 建议用 `--yaml` 或 `--json` 获得结构化输出，对 AI agent 更友好。\n\n## B站 / Bilibili\n\n> ⚠️ **不要用 yt-dlp 读 B站**（风控已全面 412 拦截，实测无解）。用 bili-cli / OpenCLI。\n\n```bash\n# 搜索 / 热门 / 视频详情（bili-cli，只读无需登录）\nbili search \"query\" --type video -n 5\nbili hot -n 10\nbili video BVxxx\n\n# 字幕（OpenCLI，需桌面 Chrome）\nopencli bilibili subtitle BVxxx\n```\n\n> 详细命令（音频转写、API 直连兜底）见 [references/video.md](video.md)。\n\n## V2EX (公开 API)\n\n无需认证，直接调用公开 API。\n\n### 热门主题\n\n```bash\ncurl -s \"https://www.v2ex.com/api/topics/hot.json\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 节点主题\n\n```bash\n# node_name 如: python, tech, jobs, qna, programmers\ncurl -s \"https://www.v2ex.com/api/topics/show.json?node_name=python&page=1\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 主题详情\n\n```bash\n# topic_id 从 URL 获取，如 https://www.v2ex.com/t/1234567\ncurl -s \"https://www.v2ex.com/api/topics/show.json?id=TOPIC_ID\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 主题回复\n\n```bash\ncurl -s \"https://www.v2ex.com/api/replies/show.json?topic_id=TOPIC_ID&page=1\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 用户信息\n\n```bash\ncurl -s \"https://www.v2ex.com/api/members/show.json?username=USERNAME\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### Python 调用示例\n\n```python\nfrom agent_reach.channels.v2ex import V2EXChannel\n\nch = V2EXChannel()\n\n# 获取热门帖子\ntopics = ch.get_hot_topics(limit=10)\nfor t in topics:\n print(f\"[{t['node_title']}] {t['title']} ({t['replies']} 回复)\")\n\n# 获取节点帖子\nnode_topics = ch.get_node_topics(\"python\", limit=5)\n\n# 获取帖子详情 + 回复\ntopic = ch.get_topic(1234567)\nprint(topic[\"title\"], \"—\", topic[\"author\"])\n\n# 获取用户信息\nuser = ch.get_user(\"Livid\")\n```\n\n> **节点列表**: https://www.v2ex.com/planes\n\n## Reddit（多后端，必须登录态）\n\n**Reddit 没有零配置路径**：匿名 `.json` 端点已被封（403），官方 API 自 2025-11 起人工审批基本不批。两个后端都靠登录态，先跑 `agent-reach doctor --json` 看 reddit 的 `active_backend`。中国大陆访问需代理。\n\n### 后端 A：OpenCLI（桌面首选，复用浏览器登录态）\n\n```bash\n# 搜索帖子\nopencli reddit search \"query\" -f yaml\n\n# 读帖子全文 + 评论\nopencli reddit read POST_ID -f yaml\n\n# 浏览 subreddit / 热门 / Popular\nopencli reddit subreddit LocalLLaMA -f yaml\nopencli reddit hot -f yaml\nopencli reddit popular -f yaml\n\n# subreddit 元信息（订阅数、简介）\nopencli reddit subreddit-info LocalLLaMA -f yaml\n```\n\n> 要求 Chrome 打开且浏览器里登录过 reddit.com。\n\n### 后端 B：rdt-cli（存量/服务器备选，上游 2026-03 起停更）\n\n```bash\nrdt search \"query\" --limit 10 # 搜索帖子\nrdt read POST_ID # 读帖子全文 + 评论\nrdt sub python --limit 20 # 浏览 subreddit\nrdt popular --limit 10 # 浏览热门\nrdt all --limit 10 # 浏览 /r/all\n```\n\n> **安装**: `pipx install 'git+https://github.com/public-clis/rdt-cli.git'`（PyPI 版本落后，需从 GitHub 装 v0.4.2+）。先 `rdt login` 才能搜索和阅读（服务器无浏览器时手动写 Cookie，见 doctor 提示）。\n> 建议使用 `--yaml` 输出，对 AI agent 更友好。\n\n### 高级选项：官方 API + PRAW（仅限已有凭证的用户）\n\n2025-11 前注册过 Reddit script app（持有 client_id/client_secret）的用户可以用 PRAW 走官方 API（100 QPM 免费）。新申请需人工审批且个人项目基本不批，**不要推荐新用户走这条路**。\n\n## Facebook（OpenCLI，必须登录态）\n\nFacebook 走 OpenCLI，复用用户 Chrome 里的 facebook.com 登录态。先跑 `agent-reach doctor --json` 看 facebook 的 `active_backend`，正常应为 `OpenCLI`。不要推荐 Jina/Exa/Graph API 作为默认路径。\n\n```bash\n# 搜索用户 / 主页 / 帖子\nopencli facebook search \"query\" -f yaml\n\n# 用户或主页信息\nopencli facebook profile zuck -f yaml\n\n# 当前账号 News Feed\nopencli facebook feed --limit 10 -f yaml\n\n# 当前账号可见的群组列表/最近动态\nopencli facebook groups --limit 20 -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展，并已登录 facebook.com。Facebook Groups 当前只承诺读取当前账号可见的群组列表/最近动态，不承诺任意群帖子和评论 API。\n\n## Instagram（OpenCLI，必须登录态）\n\nInstagram 走 OpenCLI，复用用户 Chrome 里的 instagram.com 登录态。先跑 `agent-reach doctor --json` 看 instagram 的 `active_backend`，正常应为 `OpenCLI`。不要默认恢复 instaloader；历史上 cookies/401/429 不稳定。\n\n```bash\n# 搜索用户（不是全站帖子关键词搜索）\nopencli instagram search \"query\" -f yaml\n\n# 用户 Profile\nopencli instagram profile nasa -f yaml\n\n# 用户最近帖子\nopencli instagram user nasa --limit 12 -f yaml\n\n# Explore / Discover\nopencli instagram explore --limit 20 -f yaml\n\n# 当前账号收藏\nopencli instagram saved --limit 20 -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展，并已登录 instagram.com。`instagram search` 是用户搜索；读帖子需要先确定 username，再用 `instagram user USERNAME`。若出现 429 / login required，先让用户在 Chrome 里重新登录并降低频率。\n"},"files":{"llms.txt":"# Agent Reach\n\n> Give your AI agent eyes to see the internet. Agent Reach installs, routes, and health-checks upstream tools for 15 platforms — Twitter/X, Reddit, Facebook, Instagram, YouTube, GitHub, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Xiaoyuzhou Podcast, RSS, web search, and any web page. One install, zero API fees.\n\n## Quick Start\n\n- [Installation Guide](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md): Step-by-step setup instructions for AI agents\n- [README (中文)](https://github.com/Panniantong/Agent-Reach/blob/main/README.md): Full documentation in Chinese\n- [README (English)](https://github.com/Panniantong/Agent-Reach/blob/main/docs/README_en.md): Full documentation in English\n\n## Core Commands\n\n- [CLI Usage](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md): `agent-reach doctor --json` shows the active backend; agents then call upstream tools directly (`opencli`, `twitter`, `bili`, `yt-dlp`, `gh`, `mcporter`, etc.).\n\n## Key Features\n\n- Read any URL: tweets, Reddit posts, Facebook pages/feed/groups, Instagram profiles/posts, YouTube videos (transcripts), GitHub repos, articles, XiaoHongShu notes, Bilibili videos, RSS feeds\n- Search/discover across platforms: Twitter/X, Reddit, Facebook, Instagram user search, GitHub, YouTube, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Web (via Exa)\n- Self-diagnosis: `agent-reach doctor` checks what works and what needs setup\n- Auto-installs dependencies: `agent-reach install --env=auto`\n- Browser-session / cookie auth for platforms that require login (Twitter, Reddit, Facebook, Instagram, XiaoHongShu, Xueqiu)\n- Proxy support for platforms that block server IPs (Reddit, Twitter)\n- Zero API fees: all backends are free and open-source (OpenCLI, twitter-cli, rdt-cli, bili-cli, yt-dlp, Jina Reader, mcporter/Exa, etc.)\n\n## Troubleshooting\n\n- [Troubleshooting Guide](https://github.com/Panniantong/Agent-Reach/blob/main/docs/troubleshooting.md): Common issues and solutions\n\n## Optional\n\n- [SKILL.md](https://github.com/Panniantong/Agent-Reach/blob/main/agent_reach/skill/SKILL.md): Integration guide for AI agent frameworks (OpenClaw, Claude Code, etc.)\n- Install from GitHub (the `agent-reach` package on PyPI is NOT this project): `pipx install https://github.com/Panniantong/agent-reach/archive/main.zip`\n","agent_reach/skill/references/search.md":"# 搜索工具\n\nExa AI 搜索引擎。\n\n## Exa AI 搜索\n\n高质量 AI 搜索引擎，适合查找技术文档、官方示例和相关网页。\n\n```bash\nmcporter call exa.web_search_exa query=\"query\" numResults=5\nmcporter call exa.web_search_exa query=\"library API code example\" numResults=5\n```\n\n### 使用场景\n\n| 场景 | 参数 |\n|-----|------|\n| 网页搜索 | `web_search_exa(query: \"...\", numResults: 5)` |\n| 技术/代码资料 | `web_search_exa(query: \"框架名 API 示例\", numResults: 5)` |\n\n> Exa MCP 的 `get_code_context_exa` 已弃用且默认不注册。代码问题也使用\n> `web_search_exa`；需要精确搜索仓库内容时，改用 `dev.md` 中的 GitHub 搜索。\n\n### 特点\n\n- 擅长英文内容和技术文档\n- 可通过查询词定位官方文档和代码示例\n- 结果质量高\n\n## 与其他搜索工具对比\n\n| 工具 | 来源 | 适用场景 |\n|-----|------|---------|\n| Exa | agent-reach | 英文/技术/代码搜索 |\n| 智谱搜索 | my-mcp-tools | 中文搜索 |\n| GitHub 搜索 | agent-reach (dev.md) | 仓库/代码搜索 |\n","agent_reach/skill/references/dev.md":"# 开发工具\n\nGitHub CLI \n\n## GitHub (gh CLI)\n\nGitHub 官方命令行工具，用于仓库、Issue、PR、Actions、Release 以及 API 访问。\n\n```bash\n# 认证\ngh auth login\ngh auth status\n\n# 搜索\ngh search repos \"query\" --sort stars --limit 10\ngh search code \"query\" --language python\n\n# 仓库\ngh repo view owner/repo\ngh repo clone owner/repo\ngh repo create my-repo --private\ngh repo fork owner/repo\ngh repo fork owner/repo --clone\ngh repo sync owner/repo\n\n# Issues\ngh issue list -R owner/repo --state open\ngh issue view 123 -R owner/repo\ngh issue create -R owner/repo --title \"Title\" --body \"Body\"\n\n# Pull Requests\ngh pr list -R owner/repo --state open\ngh pr view 123 -R owner/repo\ngh pr create -R owner/repo --title \"Title\" --body \"Body\"\ngh pr checks 123 --repo owner/repo\n\n# Actions / CI\ngh run list --repo owner/repo --limit 10\ngh run view --repo owner/repo\ngh run view --repo owner/repo --log-failed\ngh workflow list --repo owner/repo\n\n# Releases\ngh release list -R owner/repo\ngh release create v1.0.0\n\n# API\ngh api /user\ngh api repos/owner/repo\n\n# JSON 输出\ngh issue list --repo owner/repo --json number,title --jq '.[] | \"\\(.number): \\(.title)\"'\n```\n\n\n## 选择指南\n\n| 工具 | 来源 | 用途 |\n|-----|------|------|\n| gh CLI | agent-reach | Git 操作 |\n| zread | my-mcp-tools | 读仓库内容 |\n| context7 | my-mcp-tools | 查技术文档 |\n","agent_reach/skill/references/web.md":"# 网页阅读\n\n通用网页、RSS。\n\n## 通用网页 (Jina Reader)\n\n```bash\n# 读取任意网页内容\ncurl -s \"https://r.jina.ai/URL\"\n\n# 示例\ncurl -s \"https://r.jina.ai/https://example.com/article\"\n```\n\n**适用场景**: 大多数网页可以直接用 Jina Reader 读取。\n\n## Web Reader (MCP)\n\n```bash\n# 读取网页内容 (Markdown 格式)\nmcporter call web-reader.webReader url=\"https://example.com\"\n\n# 保留图片\nmcporter call web-reader.webReader url=\"https://example.com\" retain_images=true\n\n# 纯文本格式\nmcporter call web-reader.webReader url=\"https://example.com\" return_format=\"text\"\n```\n\n**适用场景**: 需要更精确控制输出格式时使用。\n\n## RSS (feedparser)\n\n```python\npython3 -c \"\nimport feedparser\nfor e in feedparser.parse('FEED_URL').entries[:5]:\n print(f'{e.title} — {e.link}')\n\"\n```\n\n**适用场景**: 订阅博客、新闻源、播客等 RSS feed。\n\n## 选择指南\n\n| 场景 | 推荐工具 |\n|-----|---------|\n| 通用网页 | Jina Reader (`curl r.jina.ai`) |\n| 需要图片/格式控制 | web-reader MCP |\n| RSS 订阅 | feedparser |\n","agent_reach/skill/references/video.md":"# 视频/播客\n\nYouTube、B站、小宇宙播客的字幕和转录。\n\n## YouTube (yt-dlp)\n\n### 获取视频元数据\n\n```bash\nyt-dlp --dump-json \"URL\"\n```\n\n### 下载字幕\n\n```bash\n# 下载字幕 (不下载视频)\nyt-dlp --write-sub --write-auto-sub --sub-lang \"zh-Hans,zh,en\" --skip-download -o \"/tmp/%(id)s\" \"URL\"\n\n# 然后读取 .vtt 文件\ncat /tmp/VIDEO_ID.*.vtt\n```\n\n### 获取评论\n\n```bash\n# 提取评论（best-effort，不保证完整）\nyt-dlp --write-comments --skip-download --write-info-json \\\n --extractor-args \"youtube:max_comments=20\" \\\n -o \"/tmp/%(id)s\" \"URL\"\n# 评论在 .info.json 的 comments 字段中\n```\n\n### 搜索视频\n\n```bash\nyt-dlp --dump-json \"ytsearch5:query\"\n```\n\n> **字幕注意**: 手动上传的字幕提取可靠；自动生成字幕可能存在行间重复，需后处理。\n> **评论注意**: `--write-comments` 基于网页抓取（非 YouTube Data API），部分评论可能丢失。\n\n### 字幕失败时的重试链（按序执行，拿到实质内容即停）\n\n`doctor` 只确认 yt-dlp 本体与 JS runtime 能执行，不会请求具体视频；因此\n`active_backend: yt-dlp` 不等于目标视频的字幕已经通过实时验证。\n\n1. 先用上面的 `yt-dlp --write-sub --write-auto-sub` 命令。\n2. 若出现 bot 校验、字幕响应为空或没有生成字幕文件，且 OpenCLI 已连接：\n `opencli youtube transcript \"URL\" -f yaml`。\n3. OpenCLI 若返回 `Caption URL returned empty response`，最多重试 3 次；这是带\n 过期时间的字幕 URL 偶发失效，不能把空响应当成“视频没有字幕”。\n4. 仍失败或视频本来就没有字幕：`agent-reach transcribe \"URL\"` 下载音频转写。\n\n成功标准是实际得到非空字幕/转录内容，不是命令退出码或 `doctor` 的版本探测结果。\n\n### 无字幕兜底：Whisper 音频转写\n\n```bash\n# 视频没有字幕时的兜底：下载音频并用 Whisper 转写（Groq 免费 key 即可）\nagent-reach transcribe \"https://www.youtube.com/watch?v=VIDEO_ID\"\nagent-reach transcribe ./local_audio.mp3 -o /tmp/transcript.txt\n```\n\n> `agent-reach transcribe` 只接收公开 http(s) URL 或本地音频文件。用 `ytsearch5:` 搜索时，先从 yt-dlp 结果里选出具体视频 URL，再转写。\n> 需要先配置 key：`agent-reach configure groq-key`（隐藏输入；免费，console.groq.com）\n> 或 `agent-reach configure openai-key`。默认 auto 模式只使用第一个已配置服务商\n>（优先 Groq，否则 OpenAI），失败即停止，不会把音频自动发给另一家。\n> `--allow-provider-fallback` 会显式授权跨服务商降级；同一音频内容可能被 Groq 和\n> OpenAI 分别处理，并可能产生 OpenAI 费用，只应在确认内容可分享给两家后使用。\n\n## B站 / Bilibili（bili-cli 为主，OpenCLI 补字幕）\n\n> ⚠️ **不要用 yt-dlp 读 B站**：B站风控已全面 412 拦截 yt-dlp（实测最新版、直连/代理/带 Cookie 全部无效）。yt-dlp 只用于 YouTube。\n\n### 视频详情/搜索/热门/排行 (bili-cli，只读无需登录)\n\n```bash\n# 视频详情（标题/UP主/时长/播放互动数据/字幕可用性）\nbili video BVxxx\n\n# 搜索视频\nbili search \"query\" --type video -n 5\n\n# 热门视频 / 排行榜\nbili hot -n 10\nbili rank -n 10\n\n# 下载音频并切分为 ASR-ready WAV（无字幕时配合 agent-reach transcribe 转写）\nbili audio BVxxx\n```\n\n### 字幕 (OpenCLI，需要桌面 Chrome)\n\n```bash\n# 字幕逐句带时间轴\nopencli bilibili subtitle BVxxx\n\n# OpenCLI 也能搜索/读视频元数据（备选）\nopencli bilibili search \"query\" -f yaml\nopencli bilibili video BVxxx -f yaml\n```\n\n### 零配置兜底：搜索 API 直连\n\n```bash\nUA=\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36\"\ncurl -s -c /tmp/bili_ck.txt -o /dev/null -A \"$UA\" \"https://www.bilibili.com/\"\ncurl -s -b /tmp/bili_ck.txt -A \"$UA\" -e \"https://www.bilibili.com/\" \\\n \"https://api.bilibili.com/x/web-interface/search/all/v2?keyword=QUERY&page=1\"\n```\n\n> **安装 bili-cli**: `pipx install bilibili-cli`（上游 2026-03 起停更但实测健康；只读场景无需登录，`bili login` 扫码可解锁动态/收藏等个人功能）。\n\n## 小宇宙播客 / Xiaoyuzhou Podcast\n\n### 转录单集播客（可选 --polish 增强标点）\n\n```bash\n# 输出 Markdown 文件到 /tmp/。--polish 让 Llama 3.3 70B 给文稿补中文标点+合理分段\n~/.agent-reach/tools/xiaoyuzhou/transcribe.sh --polish \"https://www.xiaoyuzhoufm.com/episode/EPISODE_ID\"\n```\n\n> 转写 prompt 已要求 Whisper 输出中文标点；若标点效果仍不理想，可加 `--polish` 用 Groq 上免费的 Llama 3.3 70B 补标点+合理分段（9 分钟播客约多 ~7 秒）。每次转写多一轮 LLM 调用，按需使用。\n\n### 前置要求\n\n1. **ffmpeg**: `brew install ffmpeg`\n2. **Groq API Key** (免费): https://console.groq.com/keys\n3. **配置 Key**: `agent-reach configure groq-key`（隐藏输入）\n4. **首次运行**: `agent-reach install --env=auto --system --channels=xiaoyuzhou`（需用户明确授权）\n\n### 检查状态\n\n```bash\nagent-reach doctor\n```\n\n> 输出 Markdown 文件默认保存到 `/tmp/`。\n\n## 选择指南\n\n| 场景 | 推荐工具 |\n|-----|---------|\n| YouTube 字幕 | yt-dlp；失败时 OpenCLI（最多 3 次）→ agent-reach transcribe |\n| B站视频详情/搜索 | bili-cli |\n| B站字幕 | opencli bilibili subtitle |\n| 播客转录 | 小宇宙 transcribe.sh |\n| 无字幕音视频 | agent-reach transcribe（B站音频先 `bili audio`） |\n","agent_reach/skill/SKILL.md":"---\nname: agent-reach\ndescription: >\n MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything\n on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X /\n 看看大家怎么评价 X / X 上有什么讨论 / research this topic。\n\n Also MUST USE when user mentions any platform or shares any URL/链接:\n 小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili, Reddit, Facebook,\n Instagram, V2EX, LinkedIn/领英/Boss直聘/招聘/求职/jobs, YouTube, GitHub code search, 小宇宙播客,\n 雪球/股票行情, RSS feeds, or any web URL.\n\n 16 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs).\n Zero config for 6 channels. Run `agent-reach doctor --json` to see which\n backend serves each platform right now.\n\n NOT for: 写报告/数据分析/翻译等内容加工（本 skill 只负责从互联网获取内容）；\n 发帖/评论/点赞等写操作；已有专门 skill 的平台（先用专门 skill）。\n\n 【路由方式】SKILL.md 包含路由表和常用命令，复杂场景需按需阅读对应分类的 references/*.md。\n 分类：search / social (小红书/推特/B站/V2EX/Reddit/Facebook/Instagram) / career(LinkedIn/Boss直聘) / dev(github) / web(网页/文章/RSS) / video(YouTube/B站/播客) / finance(雪球/股票)。\nmetadata:\n homepage: https://github.com/Panniantong/Agent-Reach\n---\n\n# Agent Reach — 互联网能力路由器\n\n16 平台、多后端。**本 skill 存在时必须用它访问这些平台，不要自己发明方案。**\n\n## 常驻规则（全程适用）\n\n1. **动手前先体检**：多后端/登录态平台（小红书/Reddit/B站/Twitter/Facebook/Instagram/Boss直聘）先跑\n `agent-reach doctor --json`。`active_backend` 有值时按它选命令组；`active_backend: null`\n 表示 Doctor 为避免触发浏览器 Cookie 读取或远端写入而没有做实时验证，不代表后端不存在。\n Doctor 结果是「某一时刻的快照」，通道/登录态可能已变化；执行只读命令前若怀疑失效，\n 按对应 reference 的「体检与恢复」runbook 重新确认（如 career.md 的 Boss直聘 CDP 排查）。\n2. **声明你在用什么**：开始干活前说一句「使用 agent-reach 的 X 平台 / Y 后端」。\n3. **失败按 references 里的重试链处理**，不要瞎猜命令。\n4. **全网调研类任务**：组合多平台（Exa 搜索 + Twitter/Reddit 看讨论 + 小红书/B站看中文场景），并行收集再汇总。\n5. **替用户盯版本**：完成一次较大的调研/多平台任务后，顺手跑\n `agent-reach check-update`（很快，一个 API 调用）。有新版就在收尾汇报里附一句：\n 「Agent Reach 有新版 vX.Y.Z，复制这句话给我即可更新：帮我更新 Agent Reach：\n https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」。\n 不要中断当前任务去更新，也不要重复提醒同一个版本。\n\n## 路由表\n\n| 用户意图 | 分类 | 详细文档 |\n|---------|------|---------|\n| 网页搜索/代码搜索 | search | [references/search.md](references/search.md) |\n| 小红书/推特/B站/V2EX/Reddit/Facebook/Instagram | social | [references/social.md](references/social.md) |\n| 招聘/职位/LinkedIn/Boss直聘 | career | [references/career.md](references/career.md) |\n| GitHub/代码 | dev | [references/dev.md](references/dev.md) |\n| 网页/文章/RSS | web | [references/web.md](references/web.md) |\n| YouTube/B站/播客字幕 | video | [references/video.md](references/video.md) |\n| 雪球/股票行情 | finance | [references/finance.md](references/finance.md) |\n\n## 零配置快速命令\n\n```bash\n# Exa 网页搜索\nmcporter call exa.web_search_exa query=\"query\" numResults=5\n\n# 通用网页阅读\ncurl -s \"https://r.jina.ai/URL\"\n\n# GitHub 搜索\ngh search repos \"query\" --sort stars --limit 10\n\n# YouTube 字幕（注意：B站不要用 yt-dlp，失败重试链见 video.md）\nyt-dlp --write-sub --write-auto-sub --skip-download -o \"/tmp/%(id)s\" \"URL\"\n\n# V2EX 热门\ncurl -s \"https://www.v2ex.com/api/topics/hot.json\" -H \"User-Agent: agent-reach/1.0\"\n\n# B站搜索（bili-cli，无需登录）\nbili search \"query\" --type video -n 5\n```\n\n## 需登录态的平台（按 doctor 的 active_backend 选命令）\n\nTwitter 注意：`agent-reach configure twitter-cookies` 保存的 Cookie 只供\n`doctor` 检查配置是否齐全；`doctor` 不执行 `twitter status`，也不会设置当前\nShell。直接运行 `twitter` 前，必须在子进程环境中显式提供\n`TWITTER_AUTH_TOKEN` 和 `TWITTER_CT0`，不得在日志或命令回显中暴露值。\n\n小红书注意：Agent Reach 不替用户登录，也不读取浏览器 Cookie。OpenCLI 只用\n用户已有且明确控制的 Chrome 会话；没有现成会话时不要自动登录，改用\nCookie-Editor 手工导出后配置 xiaohongshu-mcp / 存量工具。\n\nBoss直聘配置触发：当用户说“帮我配 Boss直聘”时，先读取 `references/career.md`\n的 Boss 章节，然后在获得安装授权后运行\n`agent-reach install --env=local --system --channels=boss`。Agent 负责按系统启动\n只绑定 `127.0.0.1:9222` 的专用 Chrome；**拉起后第一步是暂停并让用户肉眼确认**\n窗口内是已登录状态（右上角有头像），未登录则让用户登录/扫码，用户确认后再运行\n`boss --cdp-url http://localhost:9222 login --cdp` 和 `agent-reach doctor` 验收。\n不要让用户自己研究端口参数。\n专用 Chrome profile 必须长期复用，不要每次创建，也不要默认改用日常主 Chrome。\n\n判断 CDP 浏览器登录态**不要信 `boss status`**（它只校验本地 session.enc，与\n浏览器登录态互不代表），以 `agent-reach doctor` 的浏览器 cookie 探测（wt2）\n为准，并配合用户肉眼确认。绝不用当前页 URL 判断登录态：\n`security-check` / `zhipin-security` / `_security_check` 安全校验页是 Boss 反爬挑战，\n与登录无关——已登录也会出现（带 CDP 调试端口的 Chrome 几乎必现）。看到它不要\n当成“未登录”，先跑 `agent-reach doctor` 看浏览器 cookie，再决定是否需要用户登录。\n搜索报 `AUTH_EXPIRED` 即浏览器未登录的 ground truth：直接走登录流程 + `login --cdp`，\n不要往安全校验方向解释。\n\n执行搜索时必须使用\n`boss --browser-source existing-browser --cdp-url http://localhost:9222 search ...`；\n遇到 `ENVIRONMENT_RISK` 立即停止，不刷新、不重新登录、不自动重试。\n\n```bash\n# Twitter 搜索（twitter-cli 首选；失败重试链见 social.md）\ntwitter search \"query\" -n 10\n\n# Reddit（无零配置路径：OpenCLI 或 rdt-cli，必须登录态）\nopencli reddit search \"query\" -f yaml # 桌面\nrdt search \"query\" --limit 10 # 存量/服务器\n\n# 小红书（桌面首选 OpenCLI）\nopencli xiaohongshu search \"query\" -f yaml\n\n# Facebook / Instagram（桌面 OpenCLI，复用浏览器登录态）\nopencli facebook search \"query\" -f yaml\nopencli facebook groups -f yaml\nopencli instagram search \"query\" -f yaml # 搜用户\nopencli instagram user USERNAME -f yaml # 读指定用户最近帖子\n```\n\n## 环境检查\n\n```bash\n# 检查可用 channel 与每个平台当前激活的后端\nagent-reach doctor --json\n```\n\n## OpenCLI 适配器发现\n\n路由表没有覆盖用户需要的平台或命令时，先用 `opencli list` 查已有适配器，再用\n`opencli <平台> --help` 查看公开命令。发现适配器只证明命令存在，不证明登录态或\n目标内容可用；仅在用户任务明确需要该平台时执行只读命令，并以实际非空内容验收。\n\n## 工作区规则\n\n**不要在 agent workspace 创建文件。** 使用 `/tmp/` 存放临时输出，`~/.agent-reach/` 存放持久数据。\n\n## 详细文档\n\n根据用户需求，阅读对应的详细文档：\n\n- [搜索工具](references/search.md) — Exa AI 搜索\n- [社交媒体](references/social.md) — 小红书, Twitter, B站, V2EX, Reddit, Facebook, Instagram（多后端/登录态命令组）\n- [职场招聘](references/career.md) — LinkedIn, Boss直聘\n- [开发工具](references/dev.md) — GitHub CLI\n- [网页阅读](references/web.md) — Jina Reader, RSS\n- [视频播客](references/video.md) — YouTube, B站, 小宇宙\n- [金融行情](references/finance.md) — 雪球股票行情、搜索、热门内容\n\n## 配置渠道\n\n如果某个 channel 需要配置，获取安装指南：\nhttps://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md\n\n用户只需提供 cookies，其他配置由 agent 完成。\n","agent_reach/skill/references/career.md":"# 职场招聘\n\nLinkedIn、Boss直聘。\n\n## LinkedIn\n\n```bash\n# 获取个人资料\nmcporter call linkedin.get_person_profile linkedin_username=\"username\" sections=\"experience,education\"\n\n# 搜索人才\nmcporter call linkedin.search_people keywords=\"AI engineer\" location=\"Shanghai\"\n\n# 获取公司资料\nmcporter call linkedin.get_company_profile company_name=\"openai\" sections=\"posts,jobs\"\n\n# 搜索职位\nmcporter call linkedin.search_jobs keywords=\"software engineer\" location=\"Remote\" max_pages=2\n```\n\n> **需要登录**: 首次使用前运行 `uvx mcp-server-linkedin@latest --login`，保存有效登录态。\n\n### Fallback 方案\n\n如果 MCP 不可用，可以用 Jina Reader：\n\n```bash\ncurl -s \"https://r.jina.ai/https://linkedin.com/in/username\"\n```\n\n## Boss直聘\n\n当用户说“帮我配 Boss直聘”时，按本节完成安装、启动专用 Chrome、等待用户手动\n登录和最终验证。不要把 9222 端口等实现细节先甩给用户，也不要替用户输入账号、\n扫码或处理滑块。\n\n> **关键区分：登录门槛 ≠ 反爬安全校验。** zhipin.com 落地后可能停在三种页面：\n> 已登录的 `web/geek/job`、未登录的 `web/user/`（扫码登录/手机号登录）、以及\n> 反爬的**安全校验页**（URL 含 `security-check` / `zhipin-security` /\n> `_security_check`）。安全校验页与登录无关：**已登录也会出现**（带 CDP 调试\n> 端口的 Chrome 几乎必现）。绝不用当前页 URL 判断登录态。\n\n> **双登录态存储（existing-browser 严格 CDP 模式下以浏览器为准）。** 存在两个凭据存储，\n> **都不能删**，但认证的是不同通道：\n>\n> | 存储 | 角色 |\n> |---|---|\n> | `~/.boss-agent/auth/session.enc` | ① 硬性门槛：`_get_browser()` 无条件 `get_token()`，读不到直接 `AuthRequired`，CDP 搜索会在连浏览器前就失败；② **不是**搜索的认证凭据：CDP 复用真 Chrome 的 `contexts[0]` 时，它的 cookies 只在「无 context」分支注入，实际从未生效；③ httpx 通道（低危 op：`status`/`detail`/`cities`/`job_card_httpx`）真用它的 cookies + stoken，code 37 的 `force_refresh()` 也回写它 |\n> | 专用 Chrome profile 内的浏览器 cookie | CDP 模式下 search/greet 等高危 op 实际携带的凭据 |\n>\n> **`boss status` / `status --live` 只校验 session.enc**——即使报\n> `logged_in: true`，也不代表 CDP 浏览器已登录。所以：\n> 1. 拉起专用 Chrome 后，第一步必须**暂停并让用户肉眼确认**窗口内是已登录\n> 状态（右上角有头像），确认后才允许执行搜索；\n> 2. doctor 的 boss 行会直接探测浏览器内有无 wt2 cookie，以它为准；\n> 3. **`AUTH_EXPIRED` 是 ground truth**：搜索报它就直接走登录 runbook\n> （用户在专用窗口登录 → `login --cdp`），禁止再往「安全校验」方向解释；\n> `_security_check` 页面只在 `AUTH_EXPIRED` 不存在时才按滑块处理。\n> 4. 不要为了「清理旧凭据」删除 session.enc；要刷新它就跑 `login --cdp`。\n\n> **依赖状态**：所需公开 strict-CDP API 来自 boss-agent-cli 后继拆分 PR #403–#407\n> （#402/#382 已按维护者意见拆分），已全部合并入上游 master。Agent Reach 的安装器锁定\n> 上游固定提交\n> `4c991b77086a203173bf08a4cb64a23af6514fe6`，而不是会移动的 branch；上游发布正式版后\n> 应把安装器切回版本约束。\n\n体检（无副作用，不搜索）：\n\n```bash\nagent-reach doctor # boss 行：off = 未装或 CDP 不通；warn = 链路就绪，\n # message 会注明浏览器内有无 wt2 登录 cookie（以浏览器为准）\n```\n\n搜索 + JD 使用公开 API（`browser_source` / `job_card_browser` / `JobItem.lid`）。\n因为 pipx/uv tool 是隔离环境，普通 `python` 不一定能 import 已安装工具；\n用 `uv run --with` 保证脚本和锁定依赖处于同一解释器环境：\n\n```bash\nuv run --isolated --no-project \\\n --with 'git+https://github.com/can4hou6joeng4/boss-agent-cli.git@4c991b77086a203173bf08a4cb64a23af6514fe6' \\\n python - <<'PY'\nfrom pathlib import Path\n\nfrom boss_agent_cli.api.client import AccountRiskError, BossClient, EnvironmentRiskError\nfrom boss_agent_cli.auth.manager import AuthManager\nfrom boss_agent_cli.platforms.zhipin import BossPlatform\n\nauth = AuthManager(Path.home() / \".boss-agent\")\n\n# 严格 CDP 模式：复用已登录浏览器、CDP 失败立即抛错、永不 headless\nwith BossClient(\n auth,\n cdp_url=\"http://localhost:9222\",\n browser_source=\"existing-browser\",\n) as boss:\n raw = boss.search_jobs(\"大模型\", city=\"深圳\", page=1)\n if raw.get(\"code\") != 0:\n code, message = BossPlatform(boss).parse_error(raw)\n raise RuntimeError(f\"{code}: {message}\")\n items = raw.get(\"zpData\", {}).get(\"jobList\", [])\n for item in items:\n card = boss.job_card_browser(item[\"securityId\"], item[\"lid\"])\n post_desc = card.get(\"zpData\", {}).get(\"jobCard\", {}).get(\n \"postDescription\", \"\"\n )\n print(item.get(\"jobName\"), post_desc)\n\n# AccountRiskError / EnvironmentRiskError → 立即停止，不自动重试；\n# 明确 token/stoken 过期的 code 37 由 BossClient 最多刷新并重试一次。\nPY\n```\n\n### 环境体检与恢复（抓取前必查）\n\n搜索前若 `agent-reach doctor` 报 boss 为 `off` 或 `warn`，按下面 runbook 排查，不要读源码瞎猜：\n\n1. **CDP 端口通不通**：\n ```bash\n curl -s http://localhost:9222/json/version # 有 Browser 字段 = 端口通\n ```\n\n2. **调试 Chrome 没开 / 已关**：按系统启动专用 Chrome（登录态独立，不污染日常浏览器）：\n ```bash\n # macOS\n open -na \"Google Chrome\" --args --remote-debugging-address=127.0.0.1 \\\n --remote-debugging-port=9222 --user-data-dir=\"$HOME/.boss-chrome-profile\" \\\n \"https://www.zhipin.com/web/geek/job\"\n\n # Linux\n google-chrome --remote-debugging-address=127.0.0.1 \\\n --remote-debugging-port=9222 --user-data-dir=\"$HOME/.boss-chrome-profile\" \\\n \"https://www.zhipin.com/web/geek/job\"\n ```\n\n Windows PowerShell：\n ```powershell\n Start-Process chrome.exe -ArgumentList '--remote-debugging-address=127.0.0.1','--remote-debugging-port=9222',\"--user-data-dir=$env:USERPROFILE\\.boss-chrome-profile\",'https://www.zhipin.com/web/geek/job'\n ```\n\n 只绑定回环地址。任何能访问 9222 的进程都能完全控制该 Chrome；不要监听公网。\n 这个专用 profile 要长期复用，以保留稳定登录态；不要每次运行时删除或新建，\n 也不要默认切换到日常主 Chrome。不使用时关闭这个专用窗口。\n\n **拉起后第一步：暂停并让用户肉眼确认窗口内是已登录状态（右上角有头像）。**\n 不要用 `boss status` 代替这一步——它只校验本地 session.enc，不代表浏览器。\n\n3. **用户手动登录（浏览器未登录时）**：判定以 doctor 的浏览器 cookie 探测为准\n （无 wt2 = 浏览器未登录），其次才是用户肉眼确认；`boss status` 只作参考。\n 让用户在这个专用窗口登录或扫码。用户确认完成后，保存 CDP 登录态：\n ```bash\n boss --cdp-url http://localhost:9222 login --cdp\n ```\n\n 若窗口停在安全校验页（`security-check` / `zhipin-security`），这是反爬挑战、\n 不是登录页：等它自动放行或让用户手动过一下滑块即可，不要当成“未登录”去\n 重新扫码登录。\n\n4. **登录态是否有效**（浏览器 cookie 探测 + stoken 是否过期）：\n ```bash\n agent-reach doctor # 看 boss 行 message 里的浏览器 wt2 cookie 探测结果\n boss status # 只反映本地 session.enc，仅作参考\n ```\n\n5. **错误码处置**（搜索/取 JD 时）：\n - `AUTH_EXPIRED`（用户未登录）→ **ground truth**：CDP 浏览器未登录（不管\n `boss status` 说什么），直接走第 3 步登录流程 + `login --cdp`，禁止往\n 「安全校验」方向解释；\n - code 36（ACCOUNT_RISK）→ 立即停，手动到 BOSS 页面处理，不可自动重试；\n - code 9（RATE_LIMITED）→ 冷却后重试；\n - code 37 + `环境存在异常` → `ENVIRONMENT_RISK`，立即停止，不刷新 Token、不重新登录、不自动重试；\n - 只有文案明确表示 token/stoken 过期的 code 37 才是 `TOKEN_REFRESH_FAILED`；客户端最多自动刷新并重试一次，仍失败再重新登录。\n\n用户要求开始搜索时，Agent 必须指定严格 CDP 模式（全局选项放在子命令之前）：\n\n```bash\nboss --browser-source existing-browser --cdp-url http://localhost:9222 search \"大模型\" --city 广州 --page 1\n```\n\n不要无提示连续翻页。boss-agent-cli PR #383 为跨 CLI 进程的普通搜索增加持久\n5–10 秒列表预算；该 PR 合并发布前，Agent 仍应主动串行、降频调用。\n\n> **等待属预期，不是卡死**：连续搜索命中节流时，boss-agent-cli 会静默等待 5–10 秒\n> （TTY 下会显示「节流等待 Ns…」提示；Agent Reach 以 `--json` 调用，看不到该提示）。\n> 等待窗口内不要重试、不要拉起新浏览器、不要切换 profile。\n","agent_reach/skill/references/social.md":"# 社交媒体 & 社区\n\n小红书、Twitter/X、B站、V2EX、Reddit、Facebook、Instagram。\n\n## 小红书 / XiaoHongShu（多后端）\n\n小红书有三个后端，**先跑 `agent-reach doctor --json` 看 xiaohongshu 的 `active_backend` 是哪个**，再用对应命令组。\n\n### 后端 A：OpenCLI（桌面首选）\n\n```bash\n# 搜索笔记\nopencli xiaohongshu search \"query\" -f yaml\n\n# 读笔记正文+互动数据（用搜索结果里的完整 URL，含 xsec_token）\nopencli xiaohongshu note \"NOTE_URL\" -f yaml\n\n# 评论（支持楼中楼）\nopencli xiaohongshu comments NOTE_ID -f yaml\n\n# 首页推荐 feed\nopencli xiaohongshu feed -f yaml\n\n# 用户主页公开笔记\nopencli xiaohongshu user USER_ID -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展。OpenCLI 只使用用户已经存在且明确控制\n> 的 Chrome 会话；Agent Reach 不替用户登录，也不读取浏览器 Cookie。\n> `agent-reach configure xhs-cookies` 不会把 Cookie 注入 OpenCLI。\n> 如果没有现成会话，不要自动登录；改走后端 B/C，并按对应的\n> Cookie-Editor 手工导出流程配置。\n\n### 后端 B：xiaohongshu-mcp（服务器场景）\n\n```bash\n# 认证前先让用户用 Cookie-Editor 手工导出，再显式导入\nagent-reach configure xhs-cookies\n\n# 只读检查当前状态\nmcporter call xiaohongshu.check_login_status --timeout 120000\n\n# 搜索\nmcporter call xiaohongshu.search_feeds keyword=\"query\" --timeout 120000\n\n# 笔记详情+评论（feed_id 和 xsec_token 从搜索结果取）\nmcporter call xiaohongshu.get_feed_detail feed_id=\"...\" xsec_token=\"...\" --timeout 120000\n```\n\n> 首次调用会自动下载约 150MB 无头浏览器，务必带 `--timeout 120000`。\n> 认证只走 Cookie-Editor 手工导出；导入后先运行 `check_login_status`。\n> 该显式命令会保存/导入用户提供的 xiaohongshu.com 同域 Cookie 集，用户应\n> 确认范围；非 xiaohongshu.com 域 Cookie 会被忽略。\n\n### 后端 C：xhs-cli（存量备选，上游 2026-03 起停更）\n\n```bash\nxhs search \"query\" # 搜索\nxhs read NOTE_ID_OR_URL # 读笔记（必须用搜索结果中的 URL/ID，不能裸 note_id）\nxhs comments NOTE_ID_OR_URL # 评论\nxhs hot # 热门\nxhs feed # 推荐\n```\n\n> 已知不稳定：`xhs user` / `xhs user-posts` / `xhs favorites` 可能返回 API error（上游停更无人修）。新装用户建议直接走后端 A/B。\n\n### 通用注意事项\n\n> **认证边界**: Agent Reach 不得替用户执行小红书登录，也不得读取浏览器\n> Cookie。OpenCLI 只能使用用户已有且明确控制的 Chrome 会话；\n> xiaohongshu-mcp / 存量工具使用 Cookie-Editor 手工导出。\n>\n> **xsec_token 限制**: 小红书强制 xsec_token 机制，**不能直接用裸 note_id 去读**。正确流程：先搜索/feed 拿结果，再用结果中的完整 URL/ID 去读。三个后端都一样。\n>\n> **频率控制**: 高频请求（批量搜索、深翻评论）会触发验证码，平台限制无法绕过。每次操作间隔 2-3 秒。\n>\n> **写操作（发帖/评论/点赞）**: 建议只读。xhs-cli v0.6.x 写操作可能因签名问题返回 406。\n\n## Twitter/X (twitter-cli)\n\n### 认证前置条件\n\n`agent-reach configure twitter-cookies` 通过隐藏输入保存的 Cookie 只供\n`agent-reach doctor` 检查显式凭据是否齐全。`doctor` 不执行上游\n`twitter status`，也不会设置当前 Shell。运行下面任何 `twitter` 命令前，\n必须在同一个 Shell 或子进程环境中显式提供：\n\n```bash\nexport TWITTER_AUTH_TOKEN=\"...\"\nexport TWITTER_CT0=\"...\"\n```\n\n### 稳定命令\n\n```bash\n# 首页时间线（最稳定）\ntwitter feed -n 20\n\n# 读取单条推文（含回复）\ntwitter tweet URL_OR_ID\n\n# 读取长文 / X Article\ntwitter article URL_OR_ID\n\n# 用户时间线\ntwitter user-posts @username -n 20\n\n# 用户资料\ntwitter user @username\n```\n\n### 可能不稳定的命令\n\n```bash\n# 搜索推文（Twitter 频繁改 GraphQL 端点，可能 404）\ntwitter search \"query\" -n 10\n\n# likes（2024 年后只能看自己的，平台限制）\ntwitter likes\n```\n\n### search 失败时的重试链（按序执行，成功即停）\n\n1. 直接重试一次（偶发失败常见）：`twitter search \"query\" -n 10`\n2. 升级后再试：`pipx upgrade twitter-cli && twitter search \"query\" -n 10`\n3. 换 OpenCLI 备选（桌面，复用浏览器登录态）：`opencli twitter search \"query\" -f yaml`\n4. 都不行就改用 `twitter feed` / `twitter user-posts @somebody` 等稳定命令绕路\n\n### 重要注意事项\n\n> **安装**: `pipx install twitter-cli`（确保 v0.8.5+）\n>\n> **认证**: 只用 Cookie-Editor 手工导出，再显式设置环境变量\n> `TWITTER_AUTH_TOKEN` + `TWITTER_CT0`；不要依赖自动浏览器读取。\n>\n> **IP 风控**: 不要在 VPS/数据中心 IP 上频繁调用，尤其是 followers/following，有封号风险。使用住宅代理或本地环境。\n>\n> **OpenCLI 备选**: 桌面装了 OpenCLI 的话，`opencli twitter search/article/user-posts -f yaml` 全套可用（浏览器登录态，无需 cookie 环境变量）。\n>\n> **输出格式**: 建议用 `--yaml` 或 `--json` 获得结构化输出，对 AI agent 更友好。\n\n## B站 / Bilibili\n\n> ⚠️ **不要用 yt-dlp 读 B站**（风控已全面 412 拦截，实测无解）。用 bili-cli / OpenCLI。\n\n```bash\n# 搜索 / 热门 / 视频详情（bili-cli，只读无需登录）\nbili search \"query\" --type video -n 5\nbili hot -n 10\nbili video BVxxx\n\n# 字幕（OpenCLI，需桌面 Chrome）\nopencli bilibili subtitle BVxxx\n```\n\n> 详细命令（音频转写、API 直连兜底）见 [references/video.md](video.md)。\n\n## V2EX (公开 API)\n\n无需认证，直接调用公开 API。\n\n### 热门主题\n\n```bash\ncurl -s \"https://www.v2ex.com/api/topics/hot.json\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 节点主题\n\n```bash\n# node_name 如: python, tech, jobs, qna, programmers\ncurl -s \"https://www.v2ex.com/api/topics/show.json?node_name=python&page=1\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 主题详情\n\n```bash\n# topic_id 从 URL 获取，如 https://www.v2ex.com/t/1234567\ncurl -s \"https://www.v2ex.com/api/topics/show.json?id=TOPIC_ID\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 主题回复\n\n```bash\ncurl -s \"https://www.v2ex.com/api/replies/show.json?topic_id=TOPIC_ID&page=1\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 用户信息\n\n```bash\ncurl -s \"https://www.v2ex.com/api/members/show.json?username=USERNAME\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### Python 调用示例\n\n```python\nfrom agent_reach.channels.v2ex import V2EXChannel\n\nch = V2EXChannel()\n\n# 获取热门帖子\ntopics = ch.get_hot_topics(limit=10)\nfor t in topics:\n print(f\"[{t['node_title']}] {t['title']} ({t['replies']} 回复)\")\n\n# 获取节点帖子\nnode_topics = ch.get_node_topics(\"python\", limit=5)\n\n# 获取帖子详情 + 回复\ntopic = ch.get_topic(1234567)\nprint(topic[\"title\"], \"—\", topic[\"author\"])\n\n# 获取用户信息\nuser = ch.get_user(\"Livid\")\n```\n\n> **节点列表**: https://www.v2ex.com/planes\n\n## Reddit（多后端，必须登录态）\n\n**Reddit 没有零配置路径**：匿名 `.json` 端点已被封（403），官方 API 自 2025-11 起人工审批基本不批。两个后端都靠登录态，先跑 `agent-reach doctor --json` 看 reddit 的 `active_backend`。中国大陆访问需代理。\n\n### 后端 A：OpenCLI（桌面首选，复用浏览器登录态）\n\n```bash\n# 搜索帖子\nopencli reddit search \"query\" -f yaml\n\n# 读帖子全文 + 评论\nopencli reddit read POST_ID -f yaml\n\n# 浏览 subreddit / 热门 / Popular\nopencli reddit subreddit LocalLLaMA -f yaml\nopencli reddit hot -f yaml\nopencli reddit popular -f yaml\n\n# subreddit 元信息（订阅数、简介）\nopencli reddit subreddit-info LocalLLaMA -f yaml\n```\n\n> 要求 Chrome 打开且浏览器里登录过 reddit.com。\n\n### 后端 B：rdt-cli（存量/服务器备选，上游 2026-03 起停更）\n\n```bash\nrdt search \"query\" --limit 10 # 搜索帖子\nrdt read POST_ID # 读帖子全文 + 评论\nrdt sub python --limit 20 # 浏览 subreddit\nrdt popular --limit 10 # 浏览热门\nrdt all --limit 10 # 浏览 /r/all\n```\n\n> **安装**: `pipx install 'git+https://github.com/public-clis/rdt-cli.git'`（PyPI 版本落后，需从 GitHub 装 v0.4.2+）。先 `rdt login` 才能搜索和阅读（服务器无浏览器时手动写 Cookie，见 doctor 提示）。\n> 建议使用 `--yaml` 输出，对 AI agent 更友好。\n\n### 高级选项：官方 API + PRAW（仅限已有凭证的用户）\n\n2025-11 前注册过 Reddit script app（持有 client_id/client_secret）的用户可以用 PRAW 走官方 API（100 QPM 免费）。新申请需人工审批且个人项目基本不批，**不要推荐新用户走这条路**。\n\n## Facebook（OpenCLI，必须登录态）\n\nFacebook 走 OpenCLI，复用用户 Chrome 里的 facebook.com 登录态。先跑 `agent-reach doctor --json` 看 facebook 的 `active_backend`，正常应为 `OpenCLI`。不要推荐 Jina/Exa/Graph API 作为默认路径。\n\n```bash\n# 搜索用户 / 主页 / 帖子\nopencli facebook search \"query\" -f yaml\n\n# 用户或主页信息\nopencli facebook profile zuck -f yaml\n\n# 当前账号 News Feed\nopencli facebook feed --limit 10 -f yaml\n\n# 当前账号可见的群组列表/最近动态\nopencli facebook groups --limit 20 -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展，并已登录 facebook.com。Facebook Groups 当前只承诺读取当前账号可见的群组列表/最近动态，不承诺任意群帖子和评论 API。\n\n## Instagram（OpenCLI，必须登录态）\n\nInstagram 走 OpenCLI，复用用户 Chrome 里的 instagram.com 登录态。先跑 `agent-reach doctor --json` 看 instagram 的 `active_backend`，正常应为 `OpenCLI`。不要默认恢复 instaloader；历史上 cookies/401/429 不稳定。\n\n```bash\n# 搜索用户（不是全站帖子关键词搜索）\nopencli instagram search \"query\" -f yaml\n\n# 用户 Profile\nopencli instagram profile nasa -f yaml\n\n# 用户最近帖子\nopencli instagram user nasa --limit 12 -f yaml\n\n# Explore / Discover\nopencli instagram explore --limit 20 -f yaml\n\n# 当前账号收藏\nopencli instagram saved --limit 20 -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展，并已登录 instagram.com。`instagram search` 是用户搜索；读帖子需要先确定 username，再用 `instagram user USERNAME`。若出现 429 / login required，先让用户在 Chrome 里重新登录并降低频率。\n"},"items":[{"name":"llms.txt","path":"llms.txt","rawUrl":"https://raw.githubusercontent.com/Panniantong/Agent-Reach/HEAD/llms.txt","title":"LLM Index & Context Digest","category":"root-instruction","format":"text","content":"# Agent Reach\n\n> Give your AI agent eyes to see the internet. Agent Reach installs, routes, and health-checks upstream tools for 15 platforms — Twitter/X, Reddit, Facebook, Instagram, YouTube, GitHub, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Xiaoyuzhou Podcast, RSS, web search, and any web page. One install, zero API fees.\n\n## Quick Start\n\n- [Installation Guide](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md): Step-by-step setup instructions for AI agents\n- [README (中文)](https://github.com/Panniantong/Agent-Reach/blob/main/README.md): Full documentation in Chinese\n- [README (English)](https://github.com/Panniantong/Agent-Reach/blob/main/docs/README_en.md): Full documentation in English\n\n## Core Commands\n\n- [CLI Usage](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md): `agent-reach doctor --json` shows the active backend; agents then call upstream tools directly (`opencli`, `twitter`, `bili`, `yt-dlp`, `gh`, `mcporter`, etc.).\n\n## Key Features\n\n- Read any URL: tweets, Reddit posts, Facebook pages/feed/groups, Instagram profiles/posts, YouTube videos (transcripts), GitHub repos, articles, XiaoHongShu notes, Bilibili videos, RSS feeds\n- Search/discover across platforms: Twitter/X, Reddit, Facebook, Instagram user search, GitHub, YouTube, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Web (via Exa)\n- Self-diagnosis: `agent-reach doctor` checks what works and what needs setup\n- Auto-installs dependencies: `agent-reach install --env=auto`\n- Browser-session / cookie auth for platforms that require login (Twitter, Reddit, Facebook, Instagram, XiaoHongShu, Xueqiu)\n- Proxy support for platforms that block server IPs (Reddit, Twitter)\n- Zero API fees: all backends are free and open-source (OpenCLI, twitter-cli, rdt-cli, bili-cli, yt-dlp, Jina Reader, mcporter/Exa, etc.)\n\n## Troubleshooting\n\n- [Troubleshooting Guide](https://github.com/Panniantong/Agent-Reach/blob/main/docs/troubleshooting.md): Common issues and solutions\n\n## Optional\n\n- [SKILL.md](https://github.com/Panniantong/Agent-Reach/blob/main/agent_reach/skill/SKILL.md): Integration guide for AI agent frameworks (OpenClaw, Claude Code, etc.)\n- Install from GitHub (the `agent-reach` package on PyPI is NOT this project): `pipx install https://github.com/Panniantong/agent-reach/archive/main.zip`\n","isInternal":false,"tokens":604,"sizeBytes":2333},{"name":"career.md","path":"agent_reach/skill/references/career.md","rawUrl":"https://raw.githubusercontent.com/Panniantong/Agent-Reach/HEAD/agent_reach/skill/references/career.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# 职场招聘\n\nLinkedIn、Boss直聘。\n\n## LinkedIn\n\n```bash\n# 获取个人资料\nmcporter call linkedin.get_person_profile linkedin_username=\"username\" sections=\"experience,education\"\n\n# 搜索人才\nmcporter call linkedin.search_people keywords=\"AI engineer\" location=\"Shanghai\"\n\n# 获取公司资料\nmcporter call linkedin.get_company_profile company_name=\"openai\" sections=\"posts,jobs\"\n\n# 搜索职位\nmcporter call linkedin.search_jobs keywords=\"software engineer\" location=\"Remote\" max_pages=2\n```\n\n> **需要登录**: 首次使用前运行 `uvx mcp-server-linkedin@latest --login`，保存有效登录态。\n\n### Fallback 方案\n\n如果 MCP 不可用，可以用 Jina Reader：\n\n```bash\ncurl -s \"https://r.jina.ai/https://linkedin.com/in/username\"\n```\n\n## Boss直聘\n\n当用户说“帮我配 Boss直聘”时，按本节完成安装、启动专用 Chrome、等待用户手动\n登录和最终验证。不要把 9222 端口等实现细节先甩给用户，也不要替用户输入账号、\n扫码或处理滑块。\n\n> **关键区分：登录门槛 ≠ 反爬安全校验。** zhipin.com 落地后可能停在三种页面：\n> 已登录的 `web/geek/job`、未登录的 `web/user/`（扫码登录/手机号登录）、以及\n> 反爬的**安全校验页**（URL 含 `security-check` / `zhipin-security` /\n> `_security_check`）。安全校验页与登录无关：**已登录也会出现**（带 CDP 调试\n> 端口的 Chrome 几乎必现）。绝不用当前页 URL 判断登录态。\n\n> **双登录态存储（existing-browser 严格 CDP 模式下以浏览器为准）。** 存在两个凭据存储，\n> **都不能删**，但认证的是不同通道：\n>\n> | 存储 | 角色 |\n> |---|---|\n> | `~/.boss-agent/auth/session.enc` | ① 硬性门槛：`_get_browser()` 无条件 `get_token()`，读不到直接 `AuthRequired`，CDP 搜索会在连浏览器前就失败；② **不是**搜索的认证凭据：CDP 复用真 Chrome 的 `contexts[0]` 时，它的 cookies 只在「无 context」分支注入，实际从未生效；③ httpx 通道（低危 op：`status`/`detail`/`cities`/`job_card_httpx`）真用它的 cookies + stoken，code 37 的 `force_refresh()` 也回写它 |\n> | 专用 Chrome profile 内的浏览器 cookie | CDP 模式下 search/greet 等高危 op 实际携带的凭据 |\n>\n> **`boss status` / `status --live` 只校验 session.enc**——即使报\n> `logged_in: true`，也不代表 CDP 浏览器已登录。所以：\n> 1. 拉起专用 Chrome 后，第一步必须**暂停并让用户肉眼确认**窗口内是已登录\n> 状态（右上角有头像），确认后才允许执行搜索；\n> 2. doctor 的 boss 行会直接探测浏览器内有无 wt2 cookie，以它为准；\n> 3. **`AUTH_EXPIRED` 是 ground truth**：搜索报它就直接走登录 runbook\n> （用户在专用窗口登录 → `login --cdp`），禁止再往「安全校验」方向解释；\n> `_security_check` 页面只在 `AUTH_EXPIRED` 不存在时才按滑块处理。\n> 4. 不要为了「清理旧凭据」删除 session.enc；要刷新它就跑 `login --cdp`。\n\n> **依赖状态**：所需公开 strict-CDP API 来自 boss-agent-cli 后继拆分 PR #403–#407\n> （#402/#382 已按维护者意见拆分），已全部合并入上游 master。Agent Reach 的安装器锁定\n> 上游固定提交\n> `4c991b77086a203173bf08a4cb64a23af6514fe6`，而不是会移动的 branch；上游发布正式版后\n> 应把安装器切回版本约束。\n\n体检（无副作用，不搜索）：\n\n```bash\nagent-reach doctor # boss 行：off = 未装或 CDP 不通；warn = 链路就绪，\n # message 会注明浏览器内有无 wt2 登录 cookie（以浏览器为准）\n```\n\n搜索 + JD 使用公开 API（`browser_source` / `job_card_browser` / `JobItem.lid`）。\n因为 pipx/uv tool 是隔离环境，普通 `python` 不一定能 import 已安装工具；\n用 `uv run --with` 保证脚本和锁定依赖处于同一解释器环境：\n\n```bash\nuv run --isolated --no-project \\\n --with 'git+https://github.com/can4hou6joeng4/boss-agent-cli.git@4c991b77086a203173bf08a4cb64a23af6514fe6' \\\n python - <<'PY'\nfrom pathlib import Path\n\nfrom boss_agent_cli.api.client import AccountRiskError, BossClient, EnvironmentRiskError\nfrom boss_agent_cli.auth.manager import AuthManager\nfrom boss_agent_cli.platforms.zhipin import BossPlatform\n\nauth = AuthManager(Path.home() / \".boss-agent\")\n\n# 严格 CDP 模式：复用已登录浏览器、CDP 失败立即抛错、永不 headless\nwith BossClient(\n auth,\n cdp_url=\"http://localhost:9222\",\n browser_source=\"existing-browser\",\n) as boss:\n raw = boss.search_jobs(\"大模型\", city=\"深圳\", page=1)\n if raw.get(\"code\") != 0:\n code, message = BossPlatform(boss).parse_error(raw)\n raise RuntimeError(f\"{code}: {message}\")\n items = raw.get(\"zpData\", {}).get(\"jobList\", [])\n for item in items:\n card = boss.job_card_browser(item[\"securityId\"], item[\"lid\"])\n post_desc = card.get(\"zpData\", {}).get(\"jobCard\", {}).get(\n \"postDescription\", \"\"\n )\n print(item.get(\"jobName\"), post_desc)\n\n# AccountRiskError / EnvironmentRiskError → 立即停止，不自动重试；\n# 明确 token/stoken 过期的 code 37 由 BossClient 最多刷新并重试一次。\nPY\n```\n\n### 环境体检与恢复（抓取前必查）\n\n搜索前若 `agent-reach doctor` 报 boss 为 `off` 或 `warn`，按下面 runbook 排查，不要读源码瞎猜：\n\n1. **CDP 端口通不通**：\n ```bash\n curl -s http://localhost:9222/json/version # 有 Browser 字段 = 端口通\n ```\n\n2. **调试 Chrome 没开 / 已关**：按系统启动专用 Chrome（登录态独立，不污染日常浏览器）：\n ```bash\n # macOS\n open -na \"Google Chrome\" --args --remote-debugging-address=127.0.0.1 \\\n --remote-debugging-port=9222 --user-data-dir=\"$HOME/.boss-chrome-profile\" \\\n \"https://www.zhipin.com/web/geek/job\"\n\n # Linux\n google-chrome --remote-debugging-address=127.0.0.1 \\\n --remote-debugging-port=9222 --user-data-dir=\"$HOME/.boss-chrome-profile\" \\\n \"https://www.zhipin.com/web/geek/job\"\n ```\n\n Windows PowerShell：\n ```powershell\n Start-Process chrome.exe -ArgumentList '--remote-debugging-address=127.0.0.1','--remote-debugging-port=9222',\"--user-data-dir=$env:USERPROFILE\\.boss-chrome-profile\",'https://www.zhipin.com/web/geek/job'\n ```\n\n 只绑定回环地址。任何能访问 9222 的进程都能完全控制该 Chrome；不要监听公网。\n 这个专用 profile 要长期复用，以保留稳定登录态；不要每次运行时删除或新建，\n 也不要默认切换到日常主 Chrome。不使用时关闭这个专用窗口。\n\n **拉起后第一步：暂停并让用户肉眼确认窗口内是已登录状态（右上角有头像）。**\n 不要用 `boss status` 代替这一步——它只校验本地 session.enc，不代表浏览器。\n\n3. **用户手动登录（浏览器未登录时）**：判定以 doctor 的浏览器 cookie 探测为准\n （无 wt2 = 浏览器未登录），其次才是用户肉眼确认；`boss status` 只作参考。\n 让用户在这个专用窗口登录或扫码。用户确认完成后，保存 CDP 登录态：\n ```bash\n boss --cdp-url http://localhost:9222 login --cdp\n ```\n\n 若窗口停在安全校验页（`security-check` / `zhipin-security`），这是反爬挑战、\n 不是登录页：等它自动放行或让用户手动过一下滑块即可，不要当成“未登录”去\n 重新扫码登录。\n\n4. **登录态是否有效**（浏览器 cookie 探测 + stoken 是否过期）：\n ```bash\n agent-reach doctor # 看 boss 行 message 里的浏览器 wt2 cookie 探测结果\n boss status # 只反映本地 session.enc，仅作参考\n ```\n\n5. **错误码处置**（搜索/取 JD 时）：\n - `AUTH_EXPIRED`（用户未登录）→ **ground truth**：CDP 浏览器未登录（不管\n `boss status` 说什么），直接走第 3 步登录流程 + `login --cdp`，禁止往\n 「安全校验」方向解释；\n - code 36（ACCOUNT_RISK）→ 立即停，手动到 BOSS 页面处理，不可自动重试；\n - code 9（RATE_LIMITED）→ 冷却后重试；\n - code 37 + `环境存在异常` → `ENVIRONMENT_RISK`，立即停止，不刷新 Token、不重新登录、不自动重试；\n - 只有文案明确表示 token/stoken 过期的 code 37 才是 `TOKEN_REFRESH_FAILED`；客户端最多自动刷新并重试一次，仍失败再重新登录。\n\n用户要求开始搜索时，Agent 必须指定严格 CDP 模式（全局选项放在子命令之前）：\n\n```bash\nboss --browser-source existing-browser --cdp-url http://localhost:9222 search \"大模型\" --city 广州 --page 1\n```\n\n不要无提示连续翻页。boss-agent-cli PR #383 为跨 CLI 进程的普通搜索增加持久\n5–10 秒列表预算；该 PR 合并发布前，Agent 仍应主动串行、降频调用。\n\n> **等待属预期，不是卡死**：连续搜索命中节流时，boss-agent-cli 会静默等待 5–10 秒\n> （TTY 下会显示「节流等待 Ns…」提示；Agent Reach 以 `--json` 调用，看不到该提示）。\n> 等待窗口内不要重试、不要拉起新浏览器、不要切换 profile。\n","isInternal":false,"tokens":3066,"sizeBytes":9249},{"name":"dev.md","path":"agent_reach/skill/references/dev.md","rawUrl":"https://raw.githubusercontent.com/Panniantong/Agent-Reach/HEAD/agent_reach/skill/references/dev.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# 开发工具\n\nGitHub CLI \n\n## GitHub (gh CLI)\n\nGitHub 官方命令行工具，用于仓库、Issue、PR、Actions、Release 以及 API 访问。\n\n```bash\n# 认证\ngh auth login\ngh auth status\n\n# 搜索\ngh search repos \"query\" --sort stars --limit 10\ngh search code \"query\" --language python\n\n# 仓库\ngh repo view owner/repo\ngh repo clone owner/repo\ngh repo create my-repo --private\ngh repo fork owner/repo\ngh repo fork owner/repo --clone\ngh repo sync owner/repo\n\n# Issues\ngh issue list -R owner/repo --state open\ngh issue view 123 -R owner/repo\ngh issue create -R owner/repo --title \"Title\" --body \"Body\"\n\n# Pull Requests\ngh pr list -R owner/repo --state open\ngh pr view 123 -R owner/repo\ngh pr create -R owner/repo --title \"Title\" --body \"Body\"\ngh pr checks 123 --repo owner/repo\n\n# Actions / CI\ngh run list --repo owner/repo --limit 10\ngh run view --repo owner/repo\ngh run view --repo owner/repo --log-failed\ngh workflow list --repo owner/repo\n\n# Releases\ngh release list -R owner/repo\ngh release create v1.0.0\n\n# API\ngh api /user\ngh api repos/owner/repo\n\n# JSON 输出\ngh issue list --repo owner/repo --json number,title --jq '.[] | \"\\(.number): \\(.title)\"'\n```\n\n\n## 选择指南\n\n| 工具 | 来源 | 用途 |\n|-----|------|------|\n| gh CLI | agent-reach | Git 操作 |\n| zread | my-mcp-tools | 读仓库内容 |\n| context7 | my-mcp-tools | 查技术文档 |\n","isInternal":false,"tokens":442,"sizeBytes":1383},{"name":"search.md","path":"agent_reach/skill/references/search.md","rawUrl":"https://raw.githubusercontent.com/Panniantong/Agent-Reach/HEAD/agent_reach/skill/references/search.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# 搜索工具\n\nExa AI 搜索引擎。\n\n## Exa AI 搜索\n\n高质量 AI 搜索引擎，适合查找技术文档、官方示例和相关网页。\n\n```bash\nmcporter call exa.web_search_exa query=\"query\" numResults=5\nmcporter call exa.web_search_exa query=\"library API code example\" numResults=5\n```\n\n### 使用场景\n\n| 场景 | 参数 |\n|-----|------|\n| 网页搜索 | `web_search_exa(query: \"...\", numResults: 5)` |\n| 技术/代码资料 | `web_search_exa(query: \"框架名 API 示例\", numResults: 5)` |\n\n> Exa MCP 的 `get_code_context_exa` 已弃用且默认不注册。代码问题也使用\n> `web_search_exa`；需要精确搜索仓库内容时，改用 `dev.md` 中的 GitHub 搜索。\n\n### 特点\n\n- 擅长英文内容和技术文档\n- 可通过查询词定位官方文档和代码示例\n- 结果质量高\n\n## 与其他搜索工具对比\n\n| 工具 | 来源 | 适用场景 |\n|-----|------|---------|\n| Exa | agent-reach | 英文/技术/代码搜索 |\n| 智谱搜索 | my-mcp-tools | 中文搜索 |\n| GitHub 搜索 | agent-reach (dev.md) | 仓库/代码搜索 |\n","isInternal":false,"tokens":372,"sizeBytes":1066},{"name":"social.md","path":"agent_reach/skill/references/social.md","rawUrl":"https://raw.githubusercontent.com/Panniantong/Agent-Reach/HEAD/agent_reach/skill/references/social.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# 社交媒体 & 社区\n\n小红书、Twitter/X、B站、V2EX、Reddit、Facebook、Instagram。\n\n## 小红书 / XiaoHongShu（多后端）\n\n小红书有三个后端，**先跑 `agent-reach doctor --json` 看 xiaohongshu 的 `active_backend` 是哪个**，再用对应命令组。\n\n### 后端 A：OpenCLI（桌面首选）\n\n```bash\n# 搜索笔记\nopencli xiaohongshu search \"query\" -f yaml\n\n# 读笔记正文+互动数据（用搜索结果里的完整 URL，含 xsec_token）\nopencli xiaohongshu note \"NOTE_URL\" -f yaml\n\n# 评论（支持楼中楼）\nopencli xiaohongshu comments NOTE_ID -f yaml\n\n# 首页推荐 feed\nopencli xiaohongshu feed -f yaml\n\n# 用户主页公开笔记\nopencli xiaohongshu user USER_ID -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展。OpenCLI 只使用用户已经存在且明确控制\n> 的 Chrome 会话；Agent Reach 不替用户登录，也不读取浏览器 Cookie。\n> `agent-reach configure xhs-cookies` 不会把 Cookie 注入 OpenCLI。\n> 如果没有现成会话，不要自动登录；改走后端 B/C，并按对应的\n> Cookie-Editor 手工导出流程配置。\n\n### 后端 B：xiaohongshu-mcp（服务器场景）\n\n```bash\n# 认证前先让用户用 Cookie-Editor 手工导出，再显式导入\nagent-reach configure xhs-cookies\n\n# 只读检查当前状态\nmcporter call xiaohongshu.check_login_status --timeout 120000\n\n# 搜索\nmcporter call xiaohongshu.search_feeds keyword=\"query\" --timeout 120000\n\n# 笔记详情+评论（feed_id 和 xsec_token 从搜索结果取）\nmcporter call xiaohongshu.get_feed_detail feed_id=\"...\" xsec_token=\"...\" --timeout 120000\n```\n\n> 首次调用会自动下载约 150MB 无头浏览器，务必带 `--timeout 120000`。\n> 认证只走 Cookie-Editor 手工导出；导入后先运行 `check_login_status`。\n> 该显式命令会保存/导入用户提供的 xiaohongshu.com 同域 Cookie 集，用户应\n> 确认范围；非 xiaohongshu.com 域 Cookie 会被忽略。\n\n### 后端 C：xhs-cli（存量备选，上游 2026-03 起停更）\n\n```bash\nxhs search \"query\" # 搜索\nxhs read NOTE_ID_OR_URL # 读笔记（必须用搜索结果中的 URL/ID，不能裸 note_id）\nxhs comments NOTE_ID_OR_URL # 评论\nxhs hot # 热门\nxhs feed # 推荐\n```\n\n> 已知不稳定：`xhs user` / `xhs user-posts` / `xhs favorites` 可能返回 API error（上游停更无人修）。新装用户建议直接走后端 A/B。\n\n### 通用注意事项\n\n> **认证边界**: Agent Reach 不得替用户执行小红书登录，也不得读取浏览器\n> Cookie。OpenCLI 只能使用用户已有且明确控制的 Chrome 会话；\n> xiaohongshu-mcp / 存量工具使用 Cookie-Editor 手工导出。\n>\n> **xsec_token 限制**: 小红书强制 xsec_token 机制，**不能直接用裸 note_id 去读**。正确流程：先搜索/feed 拿结果，再用结果中的完整 URL/ID 去读。三个后端都一样。\n>\n> **频率控制**: 高频请求（批量搜索、深翻评论）会触发验证码，平台限制无法绕过。每次操作间隔 2-3 秒。\n>\n> **写操作（发帖/评论/点赞）**: 建议只读。xhs-cli v0.6.x 写操作可能因签名问题返回 406。\n\n## Twitter/X (twitter-cli)\n\n### 认证前置条件\n\n`agent-reach configure twitter-cookies` 通过隐藏输入保存的 Cookie 只供\n`agent-reach doctor` 检查显式凭据是否齐全。`doctor` 不执行上游\n`twitter status`，也不会设置当前 Shell。运行下面任何 `twitter` 命令前，\n必须在同一个 Shell 或子进程环境中显式提供：\n\n```bash\nexport TWITTER_AUTH_TOKEN=\"...\"\nexport TWITTER_CT0=\"...\"\n```\n\n### 稳定命令\n\n```bash\n# 首页时间线（最稳定）\ntwitter feed -n 20\n\n# 读取单条推文（含回复）\ntwitter tweet URL_OR_ID\n\n# 读取长文 / X Article\ntwitter article URL_OR_ID\n\n# 用户时间线\ntwitter user-posts @username -n 20\n\n# 用户资料\ntwitter user @username\n```\n\n### 可能不稳定的命令\n\n```bash\n# 搜索推文（Twitter 频繁改 GraphQL 端点，可能 404）\ntwitter search \"query\" -n 10\n\n# likes（2024 年后只能看自己的，平台限制）\ntwitter likes\n```\n\n### search 失败时的重试链（按序执行，成功即停）\n\n1. 直接重试一次（偶发失败常见）：`twitter search \"query\" -n 10`\n2. 升级后再试：`pipx upgrade twitter-cli && twitter search \"query\" -n 10`\n3. 换 OpenCLI 备选（桌面，复用浏览器登录态）：`opencli twitter search \"query\" -f yaml`\n4. 都不行就改用 `twitter feed` / `twitter user-posts @somebody` 等稳定命令绕路\n\n### 重要注意事项\n\n> **安装**: `pipx install twitter-cli`（确保 v0.8.5+）\n>\n> **认证**: 只用 Cookie-Editor 手工导出，再显式设置环境变量\n> `TWITTER_AUTH_TOKEN` + `TWITTER_CT0`；不要依赖自动浏览器读取。\n>\n> **IP 风控**: 不要在 VPS/数据中心 IP 上频繁调用，尤其是 followers/following，有封号风险。使用住宅代理或本地环境。\n>\n> **OpenCLI 备选**: 桌面装了 OpenCLI 的话，`opencli twitter search/article/user-posts -f yaml` 全套可用（浏览器登录态，无需 cookie 环境变量）。\n>\n> **输出格式**: 建议用 `--yaml` 或 `--json` 获得结构化输出，对 AI agent 更友好。\n\n## B站 / Bilibili\n\n> ⚠️ **不要用 yt-dlp 读 B站**（风控已全面 412 拦截，实测无解）。用 bili-cli / OpenCLI。\n\n```bash\n# 搜索 / 热门 / 视频详情（bili-cli，只读无需登录）\nbili search \"query\" --type video -n 5\nbili hot -n 10\nbili video BVxxx\n\n# 字幕（OpenCLI，需桌面 Chrome）\nopencli bilibili subtitle BVxxx\n```\n\n> 详细命令（音频转写、API 直连兜底）见 [references/video.md](video.md)。\n\n## V2EX (公开 API)\n\n无需认证，直接调用公开 API。\n\n### 热门主题\n\n```bash\ncurl -s \"https://www.v2ex.com/api/topics/hot.json\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 节点主题\n\n```bash\n# node_name 如: python, tech, jobs, qna, programmers\ncurl -s \"https://www.v2ex.com/api/topics/show.json?node_name=python&page=1\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 主题详情\n\n```bash\n# topic_id 从 URL 获取，如 https://www.v2ex.com/t/1234567\ncurl -s \"https://www.v2ex.com/api/topics/show.json?id=TOPIC_ID\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 主题回复\n\n```bash\ncurl -s \"https://www.v2ex.com/api/replies/show.json?topic_id=TOPIC_ID&page=1\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 用户信息\n\n```bash\ncurl -s \"https://www.v2ex.com/api/members/show.json?username=USERNAME\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### Python 调用示例\n\n```python\nfrom agent_reach.channels.v2ex import V2EXChannel\n\nch = V2EXChannel()\n\n# 获取热门帖子\ntopics = ch.get_hot_topics(limit=10)\nfor t in topics:\n print(f\"[{t['node_title']}] {t['title']} ({t['replies']} 回复)\")\n\n# 获取节点帖子\nnode_topics = ch.get_node_topics(\"python\", limit=5)\n\n# 获取帖子详情 + 回复\ntopic = ch.get_topic(1234567)\nprint(topic[\"title\"], \"—\", topic[\"author\"])\n\n# 获取用户信息\nuser = ch.get_user(\"Livid\")\n```\n\n> **节点列表**: https://www.v2ex.com/planes\n\n## Reddit（多后端，必须登录态）\n\n**Reddit 没有零配置路径**：匿名 `.json` 端点已被封（403），官方 API 自 2025-11 起人工审批基本不批。两个后端都靠登录态，先跑 `agent-reach doctor --json` 看 reddit 的 `active_backend`。中国大陆访问需代理。\n\n### 后端 A：OpenCLI（桌面首选，复用浏览器登录态）\n\n```bash\n# 搜索帖子\nopencli reddit search \"query\" -f yaml\n\n# 读帖子全文 + 评论\nopencli reddit read POST_ID -f yaml\n\n# 浏览 subreddit / 热门 / Popular\nopencli reddit subreddit LocalLLaMA -f yaml\nopencli reddit hot -f yaml\nopencli reddit popular -f yaml\n\n# subreddit 元信息（订阅数、简介）\nopencli reddit subreddit-info LocalLLaMA -f yaml\n```\n\n> 要求 Chrome 打开且浏览器里登录过 reddit.com。\n\n### 后端 B：rdt-cli（存量/服务器备选，上游 2026-03 起停更）\n\n```bash\nrdt search \"query\" --limit 10 # 搜索帖子\nrdt read POST_ID # 读帖子全文 + 评论\nrdt sub python --limit 20 # 浏览 subreddit\nrdt popular --limit 10 # 浏览热门\nrdt all --limit 10 # 浏览 /r/all\n```\n\n> **安装**: `pipx install 'git+https://github.com/public-clis/rdt-cli.git'`（PyPI 版本落后，需从 GitHub 装 v0.4.2+）。先 `rdt login` 才能搜索和阅读（服务器无浏览器时手动写 Cookie，见 doctor 提示）。\n> 建议使用 `--yaml` 输出，对 AI agent 更友好。\n\n### 高级选项：官方 API + PRAW（仅限已有凭证的用户）\n\n2025-11 前注册过 Reddit script app（持有 client_id/client_secret）的用户可以用 PRAW 走官方 API（100 QPM 免费）。新申请需人工审批且个人项目基本不批，**不要推荐新用户走这条路**。\n\n## Facebook（OpenCLI，必须登录态）\n\nFacebook 走 OpenCLI，复用用户 Chrome 里的 facebook.com 登录态。先跑 `agent-reach doctor --json` 看 facebook 的 `active_backend`，正常应为 `OpenCLI`。不要推荐 Jina/Exa/Graph API 作为默认路径。\n\n```bash\n# 搜索用户 / 主页 / 帖子\nopencli facebook search \"query\" -f yaml\n\n# 用户或主页信息\nopencli facebook profile zuck -f yaml\n\n# 当前账号 News Feed\nopencli facebook feed --limit 10 -f yaml\n\n# 当前账号可见的群组列表/最近动态\nopencli facebook groups --limit 20 -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展，并已登录 facebook.com。Facebook Groups 当前只承诺读取当前账号可见的群组列表/最近动态，不承诺任意群帖子和评论 API。\n\n## Instagram（OpenCLI，必须登录态）\n\nInstagram 走 OpenCLI，复用用户 Chrome 里的 instagram.com 登录态。先跑 `agent-reach doctor --json` 看 instagram 的 `active_backend`，正常应为 `OpenCLI`。不要默认恢复 instaloader；历史上 cookies/401/429 不稳定。\n\n```bash\n# 搜索用户（不是全站帖子关键词搜索）\nopencli instagram search \"query\" -f yaml\n\n# 用户 Profile\nopencli instagram profile nasa -f yaml\n\n# 用户最近帖子\nopencli instagram user nasa --limit 12 -f yaml\n\n# Explore / Discover\nopencli instagram explore --limit 20 -f yaml\n\n# 当前账号收藏\nopencli instagram saved --limit 20 -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展，并已登录 instagram.com。`instagram search` 是用户搜索；读帖子需要先确定 username，再用 `instagram user USERNAME`。若出现 429 / login required，先让用户在 Chrome 里重新登录并降低频率。\n","isInternal":false,"tokens":3545,"sizeBytes":10521},{"name":"video.md","path":"agent_reach/skill/references/video.md","rawUrl":"https://raw.githubusercontent.com/Panniantong/Agent-Reach/HEAD/agent_reach/skill/references/video.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# 视频/播客\n\nYouTube、B站、小宇宙播客的字幕和转录。\n\n## YouTube (yt-dlp)\n\n### 获取视频元数据\n\n```bash\nyt-dlp --dump-json \"URL\"\n```\n\n### 下载字幕\n\n```bash\n# 下载字幕 (不下载视频)\nyt-dlp --write-sub --write-auto-sub --sub-lang \"zh-Hans,zh,en\" --skip-download -o \"/tmp/%(id)s\" \"URL\"\n\n# 然后读取 .vtt 文件\ncat /tmp/VIDEO_ID.*.vtt\n```\n\n### 获取评论\n\n```bash\n# 提取评论（best-effort，不保证完整）\nyt-dlp --write-comments --skip-download --write-info-json \\\n --extractor-args \"youtube:max_comments=20\" \\\n -o \"/tmp/%(id)s\" \"URL\"\n# 评论在 .info.json 的 comments 字段中\n```\n\n### 搜索视频\n\n```bash\nyt-dlp --dump-json \"ytsearch5:query\"\n```\n\n> **字幕注意**: 手动上传的字幕提取可靠；自动生成字幕可能存在行间重复，需后处理。\n> **评论注意**: `--write-comments` 基于网页抓取（非 YouTube Data API），部分评论可能丢失。\n\n### 字幕失败时的重试链（按序执行，拿到实质内容即停）\n\n`doctor` 只确认 yt-dlp 本体与 JS runtime 能执行，不会请求具体视频；因此\n`active_backend: yt-dlp` 不等于目标视频的字幕已经通过实时验证。\n\n1. 先用上面的 `yt-dlp --write-sub --write-auto-sub` 命令。\n2. 若出现 bot 校验、字幕响应为空或没有生成字幕文件，且 OpenCLI 已连接：\n `opencli youtube transcript \"URL\" -f yaml`。\n3. OpenCLI 若返回 `Caption URL returned empty response`，最多重试 3 次；这是带\n 过期时间的字幕 URL 偶发失效，不能把空响应当成“视频没有字幕”。\n4. 仍失败或视频本来就没有字幕：`agent-reach transcribe \"URL\"` 下载音频转写。\n\n成功标准是实际得到非空字幕/转录内容，不是命令退出码或 `doctor` 的版本探测结果。\n\n### 无字幕兜底：Whisper 音频转写\n\n```bash\n# 视频没有字幕时的兜底：下载音频并用 Whisper 转写（Groq 免费 key 即可）\nagent-reach transcribe \"https://www.youtube.com/watch?v=VIDEO_ID\"\nagent-reach transcribe ./local_audio.mp3 -o /tmp/transcript.txt\n```\n\n> `agent-reach transcribe` 只接收公开 http(s) URL 或本地音频文件。用 `ytsearch5:` 搜索时，先从 yt-dlp 结果里选出具体视频 URL，再转写。\n> 需要先配置 key：`agent-reach configure groq-key`（隐藏输入；免费，console.groq.com）\n> 或 `agent-reach configure openai-key`。默认 auto 模式只使用第一个已配置服务商\n>（优先 Groq，否则 OpenAI），失败即停止，不会把音频自动发给另一家。\n> `--allow-provider-fallback` 会显式授权跨服务商降级；同一音频内容可能被 Groq 和\n> OpenAI 分别处理，并可能产生 OpenAI 费用，只应在确认内容可分享给两家后使用。\n\n## B站 / Bilibili（bili-cli 为主，OpenCLI 补字幕）\n\n> ⚠️ **不要用 yt-dlp 读 B站**：B站风控已全面 412 拦截 yt-dlp（实测最新版、直连/代理/带 Cookie 全部无效）。yt-dlp 只用于 YouTube。\n\n### 视频详情/搜索/热门/排行 (bili-cli，只读无需登录)\n\n```bash\n# 视频详情（标题/UP主/时长/播放互动数据/字幕可用性）\nbili video BVxxx\n\n# 搜索视频\nbili search \"query\" --type video -n 5\n\n# 热门视频 / 排行榜\nbili hot -n 10\nbili rank -n 10\n\n# 下载音频并切分为 ASR-ready WAV（无字幕时配合 agent-reach transcribe 转写）\nbili audio BVxxx\n```\n\n### 字幕 (OpenCLI，需要桌面 Chrome)\n\n```bash\n# 字幕逐句带时间轴\nopencli bilibili subtitle BVxxx\n\n# OpenCLI 也能搜索/读视频元数据（备选）\nopencli bilibili search \"query\" -f yaml\nopencli bilibili video BVxxx -f yaml\n```\n\n### 零配置兜底：搜索 API 直连\n\n```bash\nUA=\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36\"\ncurl -s -c /tmp/bili_ck.txt -o /dev/null -A \"$UA\" \"https://www.bilibili.com/\"\ncurl -s -b /tmp/bili_ck.txt -A \"$UA\" -e \"https://www.bilibili.com/\" \\\n \"https://api.bilibili.com/x/web-interface/search/all/v2?keyword=QUERY&page=1\"\n```\n\n> **安装 bili-cli**: `pipx install bilibili-cli`（上游 2026-03 起停更但实测健康；只读场景无需登录，`bili login` 扫码可解锁动态/收藏等个人功能）。\n\n## 小宇宙播客 / Xiaoyuzhou Podcast\n\n### 转录单集播客（可选 --polish 增强标点）\n\n```bash\n# 输出 Markdown 文件到 /tmp/。--polish 让 Llama 3.3 70B 给文稿补中文标点+合理分段\n~/.agent-reach/tools/xiaoyuzhou/transcribe.sh --polish \"https://www.xiaoyuzhoufm.com/episode/EPISODE_ID\"\n```\n\n> 转写 prompt 已要求 Whisper 输出中文标点；若标点效果仍不理想，可加 `--polish` 用 Groq 上免费的 Llama 3.3 70B 补标点+合理分段（9 分钟播客约多 ~7 秒）。每次转写多一轮 LLM 调用，按需使用。\n\n### 前置要求\n\n1. **ffmpeg**: `brew install ffmpeg`\n2. **Groq API Key** (免费): https://console.groq.com/keys\n3. **配置 Key**: `agent-reach configure groq-key`（隐藏输入）\n4. **首次运行**: `agent-reach install --env=auto --system --channels=xiaoyuzhou`（需用户明确授权）\n\n### 检查状态\n\n```bash\nagent-reach doctor\n```\n\n> 输出 Markdown 文件默认保存到 `/tmp/`。\n\n## 选择指南\n\n| 场景 | 推荐工具 |\n|-----|---------|\n| YouTube 字幕 | yt-dlp；失败时 OpenCLI（最多 3 次）→ agent-reach transcribe |\n| B站视频详情/搜索 | bili-cli |\n| B站字幕 | opencli bilibili subtitle |\n| 播客转录 | 小宇宙 transcribe.sh |\n| 无字幕音视频 | agent-reach transcribe（B站音频先 `bili audio`） |\n","isInternal":false,"tokens":1883,"sizeBytes":5515},{"name":"web.md","path":"agent_reach/skill/references/web.md","rawUrl":"https://raw.githubusercontent.com/Panniantong/Agent-Reach/HEAD/agent_reach/skill/references/web.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# 网页阅读\n\n通用网页、RSS。\n\n## 通用网页 (Jina Reader)\n\n```bash\n# 读取任意网页内容\ncurl -s \"https://r.jina.ai/URL\"\n\n# 示例\ncurl -s \"https://r.jina.ai/https://example.com/article\"\n```\n\n**适用场景**: 大多数网页可以直接用 Jina Reader 读取。\n\n## Web Reader (MCP)\n\n```bash\n# 读取网页内容 (Markdown 格式)\nmcporter call web-reader.webReader url=\"https://example.com\"\n\n# 保留图片\nmcporter call web-reader.webReader url=\"https://example.com\" retain_images=true\n\n# 纯文本格式\nmcporter call web-reader.webReader url=\"https://example.com\" return_format=\"text\"\n```\n\n**适用场景**: 需要更精确控制输出格式时使用。\n\n## RSS (feedparser)\n\n```python\npython3 -c \"\nimport feedparser\nfor e in feedparser.parse('FEED_URL').entries[:5]:\n print(f'{e.title} — {e.link}')\n\"\n```\n\n**适用场景**: 订阅博客、新闻源、播客等 RSS feed。\n\n## 选择指南\n\n| 场景 | 推荐工具 |\n|-----|---------|\n| 通用网页 | Jina Reader (`curl r.jina.ai`) |\n| 需要图片/格式控制 | web-reader MCP |\n| RSS 订阅 | feedparser |\n","isInternal":false,"tokens":354,"sizeBytes":1087},{"name":"SKILL.md","path":"agent_reach/skill/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Panniantong/Agent-Reach/HEAD/agent_reach/skill/SKILL.md","title":"agent-reach","category":"anthropic-skill","format":"markdown","content":"---\nname: agent-reach\ndescription: >\n MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything\n on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X /\n 看看大家怎么评价 X / X 上有什么讨论 / research this topic。\n\n Also MUST USE when user mentions any platform or shares any URL/链接:\n 小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili, Reddit, Facebook,\n Instagram, V2EX, LinkedIn/领英/Boss直聘/招聘/求职/jobs, YouTube, GitHub code search, 小宇宙播客,\n 雪球/股票行情, RSS feeds, or any web URL.\n\n 16 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs).\n Zero config for 6 channels. Run `agent-reach doctor --json` to see which\n backend serves each platform right now.\n\n NOT for: 写报告/数据分析/翻译等内容加工（本 skill 只负责从互联网获取内容）；\n 发帖/评论/点赞等写操作；已有专门 skill 的平台（先用专门 skill）。\n\n 【路由方式】SKILL.md 包含路由表和常用命令，复杂场景需按需阅读对应分类的 references/*.md。\n 分类：search / social (小红书/推特/B站/V2EX/Reddit/Facebook/Instagram) / career(LinkedIn/Boss直聘) / dev(github) / web(网页/文章/RSS) / video(YouTube/B站/播客) / finance(雪球/股票)。\nmetadata:\n homepage: https://github.com/Panniantong/Agent-Reach\n---\n\n# Agent Reach — 互联网能力路由器\n\n16 平台、多后端。**本 skill 存在时必须用它访问这些平台，不要自己发明方案。**\n\n## 常驻规则（全程适用）\n\n1. **动手前先体检**：多后端/登录态平台（小红书/Reddit/B站/Twitter/Facebook/Instagram/Boss直聘）先跑\n `agent-reach doctor --json`。`active_backend` 有值时按它选命令组；`active_backend: null`\n 表示 Doctor 为避免触发浏览器 Cookie 读取或远端写入而没有做实时验证，不代表后端不存在。\n Doctor 结果是「某一时刻的快照」，通道/登录态可能已变化；执行只读命令前若怀疑失效，\n 按对应 reference 的「体检与恢复」runbook 重新确认（如 career.md 的 Boss直聘 CDP 排查）。\n2. **声明你在用什么**：开始干活前说一句「使用 agent-reach 的 X 平台 / Y 后端」。\n3. **失败按 references 里的重试链处理**，不要瞎猜命令。\n4. **全网调研类任务**：组合多平台（Exa 搜索 + Twitter/Reddit 看讨论 + 小红书/B站看中文场景），并行收集再汇总。\n5. **替用户盯版本**：完成一次较大的调研/多平台任务后，顺手跑\n `agent-reach check-update`（很快，一个 API 调用）。有新版就在收尾汇报里附一句：\n 「Agent Reach 有新版 vX.Y.Z，复制这句话给我即可更新：帮我更新 Agent Reach：\n https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」。\n 不要中断当前任务去更新，也不要重复提醒同一个版本。\n\n## 路由表\n\n| 用户意图 | 分类 | 详细文档 |\n|---------|------|---------|\n| 网页搜索/代码搜索 | search | [references/search.md](references/search.md) |\n| 小红书/推特/B站/V2EX/Reddit/Facebook/Instagram | social | [references/social.md](references/social.md) |\n| 招聘/职位/LinkedIn/Boss直聘 | career | [references/career.md](references/career.md) |\n| GitHub/代码 | dev | [references/dev.md](references/dev.md) |\n| 网页/文章/RSS | web | [references/web.md](references/web.md) |\n| YouTube/B站/播客字幕 | video | [references/video.md](references/video.md) |\n| 雪球/股票行情 | finance | [references/finance.md](references/finance.md) |\n\n## 零配置快速命令\n\n```bash\n# Exa 网页搜索\nmcporter call exa.web_search_exa query=\"query\" numResults=5\n\n# 通用网页阅读\ncurl -s \"https://r.jina.ai/URL\"\n\n# GitHub 搜索\ngh search repos \"query\" --sort stars --limit 10\n\n# YouTube 字幕（注意：B站不要用 yt-dlp，失败重试链见 video.md）\nyt-dlp --write-sub --write-auto-sub --skip-download -o \"/tmp/%(id)s\" \"URL\"\n\n# V2EX 热门\ncurl -s \"https://www.v2ex.com/api/topics/hot.json\" -H \"User-Agent: agent-reach/1.0\"\n\n# B站搜索（bili-cli，无需登录）\nbili search \"query\" --type video -n 5\n```\n\n## 需登录态的平台（按 doctor 的 active_backend 选命令）\n\nTwitter 注意：`agent-reach configure twitter-cookies` 保存的 Cookie 只供\n`doctor` 检查配置是否齐全；`doctor` 不执行 `twitter status`，也不会设置当前\nShell。直接运行 `twitter` 前，必须在子进程环境中显式提供\n`TWITTER_AUTH_TOKEN` 和 `TWITTER_CT0`，不得在日志或命令回显中暴露值。\n\n小红书注意：Agent Reach 不替用户登录，也不读取浏览器 Cookie。OpenCLI 只用\n用户已有且明确控制的 Chrome 会话；没有现成会话时不要自动登录，改用\nCookie-Editor 手工导出后配置 xiaohongshu-mcp / 存量工具。\n\nBoss直聘配置触发：当用户说“帮我配 Boss直聘”时，先读取 `references/career.md`\n的 Boss 章节，然后在获得安装授权后运行\n`agent-reach install --env=local --system --channels=boss`。Agent 负责按系统启动\n只绑定 `127.0.0.1:9222` 的专用 Chrome；**拉起后第一步是暂停并让用户肉眼确认**\n窗口内是已登录状态（右上角有头像），未登录则让用户登录/扫码，用户确认后再运行\n`boss --cdp-url http://localhost:9222 login --cdp` 和 `agent-reach doctor` 验收。\n不要让用户自己研究端口参数。\n专用 Chrome profile 必须长期复用，不要每次创建，也不要默认改用日常主 Chrome。\n\n判断 CDP 浏览器登录态**不要信 `boss status`**（它只校验本地 session.enc，与\n浏览器登录态互不代表），以 `agent-reach doctor` 的浏览器 cookie 探测（wt2）\n为准，并配合用户肉眼确认。绝不用当前页 URL 判断登录态：\n`security-check` / `zhipin-security` / `_security_check` 安全校验页是 Boss 反爬挑战，\n与登录无关——已登录也会出现（带 CDP 调试端口的 Chrome 几乎必现）。看到它不要\n当成“未登录”，先跑 `agent-reach doctor` 看浏览器 cookie，再决定是否需要用户登录。\n搜索报 `AUTH_EXPIRED` 即浏览器未登录的 ground truth：直接走登录流程 + `login --cdp`，\n不要往安全校验方向解释。\n\n执行搜索时必须使用\n`boss --browser-source existing-browser --cdp-url http://localhost:9222 search ...`；\n遇到 `ENVIRONMENT_RISK` 立即停止，不刷新、不重新登录、不自动重试。\n\n```bash\n# Twitter 搜索（twitter-cli 首选；失败重试链见 social.md）\ntwitter search \"query\" -n 10\n\n# Reddit（无零配置路径：OpenCLI 或 rdt-cli，必须登录态）\nopencli reddit search \"query\" -f yaml # 桌面\nrdt search \"query\" --limit 10 # 存量/服务器\n\n# 小红书（桌面首选 OpenCLI）\nopencli xiaohongshu search \"query\" -f yaml\n\n# Facebook / Instagram（桌面 OpenCLI，复用浏览器登录态）\nopencli facebook search \"query\" -f yaml\nopencli facebook groups -f yaml\nopencli instagram search \"query\" -f yaml # 搜用户\nopencli instagram user USERNAME -f yaml # 读指定用户最近帖子\n```\n\n## 环境检查\n\n```bash\n# 检查可用 channel 与每个平台当前激活的后端\nagent-reach doctor --json\n```\n\n## OpenCLI 适配器发现\n\n路由表没有覆盖用户需要的平台或命令时，先用 `opencli list` 查已有适配器，再用\n`opencli <平台> --help` 查看公开命令。发现适配器只证明命令存在，不证明登录态或\n目标内容可用；仅在用户任务明确需要该平台时执行只读命令，并以实际非空内容验收。\n\n## 工作区规则\n\n**不要在 agent workspace 创建文件。** 使用 `/tmp/` 存放临时输出，`~/.agent-reach/` 存放持久数据。\n\n## 详细文档\n\n根据用户需求，阅读对应的详细文档：\n\n- [搜索工具](references/search.md) — Exa AI 搜索\n- [社交媒体](references/social.md) — 小红书, Twitter, B站, V2EX, Reddit, Facebook, Instagram（多后端/登录态命令组）\n- [职场招聘](references/career.md) — LinkedIn, Boss直聘\n- [开发工具](references/dev.md) — GitHub CLI\n- [网页阅读](references/web.md) — Jina Reader, RSS\n- [视频播客](references/video.md) — YouTube, B站, 小宇宙\n- [金融行情](references/finance.md) — 雪球股票行情、搜索、热门内容\n\n## 配置渠道\n\n如果某个 channel 需要配置，获取安装指南：\nhttps://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md\n\n用户只需提供 cookies，其他配置由 agent 完成。\n","frontmatter":{"name":"agent-reach","description":"MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X / 看看大家怎么评价 X / X 上有什么讨论 / research this topic。\nAlso MUST USE when user mentions any platform or shares any URL/链接: 小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili, Reddit, Facebook, Instagram, V2EX, LinkedIn/领英/Boss直聘/招聘/求职/jobs, YouTube, GitHub code search, 小宇宙播客, 雪球/股票行情, RSS feeds, or any web URL.\n16 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs). Zero config for 6 channels. Run `agent-reach doctor --json` to see which backend serves each platform right now.\nNOT for: 写报告/数据分析/翻译等内容加工（本 skill 只负责从互联网获取内容）； 发帖/评论/点赞等写操作；已有专门 skill 的平台（先用专门 skill）。\n【路由方式】SKILL.md 包含路由表和常用命令，复杂场景需按需阅读对应分类的 references/*.md。 分类：search / social (小红书/推特/B站/V2EX/Reddit/Facebook/Instagram) / career(LinkedIn/Boss直聘) / dev(github) / web(网页/文章/RSS) / video(YouTube/B站/播客) / finance(雪球/股票)。\n","metadata":{"homepage":"https://github.com/Panniantong/Agent-Reach"}},"isInternal":false,"tokens":2861,"sizeBytes":8636}],"systemPromptSnippet":"\n\n# Agent Reach\n\n> Give your AI agent eyes to see the internet. Agent Reach installs, routes, and health-checks upstream tools for 15 platforms — Twitter/X, Reddit, Facebook, Instagram, YouTube, GitHub, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Xiaoyuzhou Podcast, RSS, web search, and any web page. One install, zero API fees.\n\n## Quick Start\n\n- [Installation Guide](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md): Step-by-step setup instructions for AI agents\n- [README (中文)](https://github.com/Panniantong/Agent-Reach/blob/main/README.md): Full documentation in Chinese\n- [README (English)](https://github.com/Panniantong/Agent-Reach/blob/main/docs/README_en.md): Full documentation in English\n\n## Core Commands\n\n- [CLI Usage](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md): `agent-reach doctor --json` shows the active backend; agents then call upstream tools directly (`opencli`, `twitter`, `bili`, `yt-dlp`, `gh`, `mcporter`, etc.).\n\n## Key Features\n\n- Read any URL: tweets, Reddit posts, Facebook pages/feed/groups, Instagram profiles/posts, YouTube videos (transcripts), GitHub repos, articles, XiaoHongShu notes, Bilibili videos, RSS feeds\n- Search/discover across platforms: Twitter/X, Reddit, Facebook, Instagram user search, GitHub, YouTube, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Web (via Exa)\n- Self-diagnosis: `agent-reach doctor` checks what works and what needs setup\n- Auto-installs dependencies: `agent-reach install --env=auto`\n- Browser-session / cookie auth for platforms that require login (Twitter, Reddit, Facebook, Instagram, XiaoHongShu, Xueqiu)\n- Proxy support for platforms that block server IPs (Reddit, Twitter)\n- Zero API fees: all backends are free and open-source (OpenCLI, twitter-cli, rdt-cli, bili-cli, yt-dlp, Jina Reader, mcporter/Exa, etc.)\n\n## Troubleshooting\n\n- [Troubleshooting Guide](https://github.com/Panniantong/Agent-Reach/blob/main/docs/troubleshooting.md): Common issues and solutions\n\n## Optional\n\n- [SKILL.md](https://github.com/Panniantong/Agent-Reach/blob/main/agent_reach/skill/SKILL.md): Integration guide for AI agent frameworks (OpenClaw, Claude Code, etc.)\n- Install from GitHub (the `agent-reach` package on PyPI is NOT this project): `pipx install https://github.com/Panniantong/agent-reach/archive/main.zip`\n\n\n# 职场招聘\n\nLinkedIn、Boss直聘。\n\n## LinkedIn\n\n```bash\n# 获取个人资料\nmcporter call linkedin.get_person_profile linkedin_username=\"username\" sections=\"experience,education\"\n\n# 搜索人才\nmcporter call linkedin.search_people keywords=\"AI engineer\" location=\"Shanghai\"\n\n# 获取公司资料\nmcporter call linkedin.get_company_profile company_name=\"openai\" sections=\"posts,jobs\"\n\n# 搜索职位\nmcporter call linkedin.search_jobs keywords=\"software engineer\" location=\"Remote\" max_pages=2\n```\n\n> **需要登录**: 首次使用前运行 `uvx mcp-server-linkedin@latest --login`，保存有效登录态。\n\n### Fallback 方案\n\n如果 MCP 不可用，可以用 Jina Reader：\n\n```bash\ncurl -s \"https://r.jina.ai/https://linkedin.com/in/username\"\n```\n\n## Boss直聘\n\n当用户说“帮我配 Boss直聘”时，按本节完成安装、启动专用 Chrome、等待用户手动\n登录和最终验证。不要把 9222 端口等实现细节先甩给用户，也不要替用户输入账号、\n扫码或处理滑块。\n\n> **关键区分：登录门槛 ≠ 反爬安全校验。** zhipin.com 落地后可能停在三种页面：\n> 已登录的 `web/geek/job`、未登录的 `web/user/`（扫码登录/手机号登录）、以及\n> 反爬的**安全校验页**（URL 含 `security-check` / `zhipin-security` /\n> `_security_check`）。安全校验页与登录无关：**已登录也会出现**（带 CDP 调试\n> 端口的 Chrome 几乎必现）。绝不用当前页 URL 判断登录态。\n\n> **双登录态存储（existing-browser 严格 CDP 模式下以浏览器为准）。** 存在两个凭据存储，\n> **都不能删**，但认证的是不同通道：\n>\n> | 存储 | 角色 |\n> |---|---|\n> | `~/.boss-agent/auth/session.enc` | ① 硬性门槛：`_get_browser()` 无条件 `get_token()`，读不到直接 `AuthRequired`，CDP 搜索会在连浏览器前就失败；② **不是**搜索的认证凭据：CDP 复用真 Chrome 的 `contexts[0]` 时，它的 cookies 只在「无 context」分支注入，实际从未生效；③ httpx 通道（低危 op：`status`/`detail`/`cities`/`job_card_httpx`）真用它的 cookies + stoken，code 37 的 `force_refresh()` 也回写它 |\n> | 专用 Chrome profile 内的浏览器 cookie | CDP 模式下 search/greet 等高危 op 实际携带的凭据 |\n>\n> **`boss status` / `status --live` 只校验 session.enc**——即使报\n> `logged_in: true`，也不代表 CDP 浏览器已登录。所以：\n> 1. 拉起专用 Chrome 后，第一步必须**暂停并让用户肉眼确认**窗口内是已登录\n> 状态（右上角有头像），确认后才允许执行搜索；\n> 2. doctor 的 boss 行会直接探测浏览器内有无 wt2 cookie，以它为准；\n> 3. **`AUTH_EXPIRED` 是 ground truth**：搜索报它就直接走登录 runbook\n> （用户在专用窗口登录 → `login --cdp`），禁止再往「安全校验」方向解释；\n> `_security_check` 页面只在 `AUTH_EXPIRED` 不存在时才按滑块处理。\n> 4. 不要为了「清理旧凭据」删除 session.enc；要刷新它就跑 `login --cdp`。\n\n> **依赖状态**：所需公开 strict-CDP API 来自 boss-agent-cli 后继拆分 PR #403–#407\n> （#402/#382 已按维护者意见拆分），已全部合并入上游 master。Agent Reach 的安装器锁定\n> 上游固定提交\n> `4c991b77086a203173bf08a4cb64a23af6514fe6`，而不是会移动的 branch；上游发布正式版后\n> 应把安装器切回版本约束。\n\n体检（无副作用，不搜索）：\n\n```bash\nagent-reach doctor # boss 行：off = 未装或 CDP 不通；warn = 链路就绪，\n # message 会注明浏览器内有无 wt2 登录 cookie（以浏览器为准）\n```\n\n搜索 + JD 使用公开 API（`browser_source` / `job_card_browser` / `JobItem.lid`）。\n因为 pipx/uv tool 是隔离环境，普通 `python` 不一定能 import 已安装工具；\n用 `uv run --with` 保证脚本和锁定依赖处于同一解释器环境：\n\n```bash\nuv run --isolated --no-project \\\n --with 'git+https://github.com/can4hou6joeng4/boss-agent-cli.git@4c991b77086a203173bf08a4cb64a23af6514fe6' \\\n python - <<'PY'\nfrom pathlib import Path\n\nfrom boss_agent_cli.api.client import AccountRiskError, BossClient, EnvironmentRiskError\nfrom boss_agent_cli.auth.manager import AuthManager\nfrom boss_agent_cli.platforms.zhipin import BossPlatform\n\nauth = AuthManager(Path.home() / \".boss-agent\")\n\n# 严格 CDP 模式：复用已登录浏览器、CDP 失败立即抛错、永不 headless\nwith BossClient(\n auth,\n cdp_url=\"http://localhost:9222\",\n browser_source=\"existing-browser\",\n) as boss:\n raw = boss.search_jobs(\"大模型\", city=\"深圳\", page=1)\n if raw.get(\"code\") != 0:\n code, message = BossPlatform(boss).parse_error(raw)\n raise RuntimeError(f\"{code}: {message}\")\n items = raw.get(\"zpData\", {}).get(\"jobList\", [])\n for item in items:\n card = boss.job_card_browser(item[\"securityId\"], item[\"lid\"])\n post_desc = card.get(\"zpData\", {}).get(\"jobCard\", {}).get(\n \"postDescription\", \"\"\n )\n print(item.get(\"jobName\"), post_desc)\n\n# AccountRiskError / EnvironmentRiskError → 立即停止，不自动重试；\n# 明确 token/stoken 过期的 code 37 由 BossClient 最多刷新并重试一次。\nPY\n```\n\n### 环境体检与恢复（抓取前必查）\n\n搜索前若 `agent-reach doctor` 报 boss 为 `off` 或 `warn`，按下面 runbook 排查，不要读源码瞎猜：\n\n1. **CDP 端口通不通**：\n ```bash\n curl -s http://localhost:9222/json/version # 有 Browser 字段 = 端口通\n ```\n\n2. **调试 Chrome 没开 / 已关**：按系统启动专用 Chrome（登录态独立，不污染日常浏览器）：\n ```bash\n # macOS\n open -na \"Google Chrome\" --args --remote-debugging-address=127.0.0.1 \\\n --remote-debugging-port=9222 --user-data-dir=\"$HOME/.boss-chrome-profile\" \\\n \"https://www.zhipin.com/web/geek/job\"\n\n # Linux\n google-chrome --remote-debugging-address=127.0.0.1 \\\n --remote-debugging-port=9222 --user-data-dir=\"$HOME/.boss-chrome-profile\" \\\n \"https://www.zhipin.com/web/geek/job\"\n ```\n\n Windows PowerShell：\n ```powershell\n Start-Process chrome.exe -ArgumentList '--remote-debugging-address=127.0.0.1','--remote-debugging-port=9222',\"--user-data-dir=$env:USERPROFILE\\.boss-chrome-profile\",'https://www.zhipin.com/web/geek/job'\n ```\n\n 只绑定回环地址。任何能访问 9222 的进程都能完全控制该 Chrome；不要监听公网。\n 这个专用 profile 要长期复用，以保留稳定登录态；不要每次运行时删除或新建，\n 也不要默认切换到日常主 Chrome。不使用时关闭这个专用窗口。\n\n **拉起后第一步：暂停并让用户肉眼确认窗口内是已登录状态（右上角有头像）。**\n 不要用 `boss status` 代替这一步——它只校验本地 session.enc，不代表浏览器。\n\n3. **用户手动登录（浏览器未登录时）**：判定以 doctor 的浏览器 cookie 探测为准\n （无 wt2 = 浏览器未登录），其次才是用户肉眼确认；`boss status` 只作参考。\n 让用户在这个专用窗口登录或扫码。用户确认完成后，保存 CDP 登录态：\n ```bash\n boss --cdp-url http://localhost:9222 login --cdp\n ```\n\n 若窗口停在安全校验页（`security-check` / `zhipin-security`），这是反爬挑战、\n 不是登录页：等它自动放行或让用户手动过一下滑块即可，不要当成“未登录”去\n 重新扫码登录。\n\n4. **登录态是否有效**（浏览器 cookie 探测 + stoken 是否过期）：\n ```bash\n agent-reach doctor # 看 boss 行 message 里的浏览器 wt2 cookie 探测结果\n boss status # 只反映本地 session.enc，仅作参考\n ```\n\n5. **错误码处置**（搜索/取 JD 时）：\n - `AUTH_EXPIRED`（用户未登录）→ **ground truth**：CDP 浏览器未登录（不管\n `boss status` 说什么），直接走第 3 步登录流程 + `login --cdp`，禁止往\n 「安全校验」方向解释；\n - code 36（ACCOUNT_RISK）→ 立即停，手动到 BOSS 页面处理，不可自动重试；\n - code 9（RATE_LIMITED）→ 冷却后重试；\n - code 37 + `环境存在异常` → `ENVIRONMENT_RISK`，立即停止，不刷新 Token、不重新登录、不自动重试；\n - 只有文案明确表示 token/stoken 过期的 code 37 才是 `TOKEN_REFRESH_FAILED`；客户端最多自动刷新并重试一次，仍失败再重新登录。\n\n用户要求开始搜索时，Agent 必须指定严格 CDP 模式（全局选项放在子命令之前）：\n\n```bash\nboss --browser-source existing-browser --cdp-url http://localhost:9222 search \"大模型\" --city 广州 --page 1\n```\n\n不要无提示连续翻页。boss-agent-cli PR #383 为跨 CLI 进程的普通搜索增加持久\n5–10 秒列表预算；该 PR 合并发布前，Agent 仍应主动串行、降频调用。\n\n> **等待属预期，不是卡死**：连续搜索命中节流时，boss-agent-cli 会静默等待 5–10 秒\n> （TTY 下会显示「节流等待 Ns…」提示；Agent Reach 以 `--json` 调用，看不到该提示）。\n> 等待窗口内不要重试、不要拉起新浏览器、不要切换 profile。\n\n\n# 开发工具\n\nGitHub CLI \n\n## GitHub (gh CLI)\n\nGitHub 官方命令行工具，用于仓库、Issue、PR、Actions、Release 以及 API 访问。\n\n```bash\n# 认证\ngh auth login\ngh auth status\n\n# 搜索\ngh search repos \"query\" --sort stars --limit 10\ngh search code \"query\" --language python\n\n# 仓库\ngh repo view owner/repo\ngh repo clone owner/repo\ngh repo create my-repo --private\ngh repo fork owner/repo\ngh repo fork owner/repo --clone\ngh repo sync owner/repo\n\n# Issues\ngh issue list -R owner/repo --state open\ngh issue view 123 -R owner/repo\ngh issue create -R owner/repo --title \"Title\" --body \"Body\"\n\n# Pull Requests\ngh pr list -R owner/repo --state open\ngh pr view 123 -R owner/repo\ngh pr create -R owner/repo --title \"Title\" --body \"Body\"\ngh pr checks 123 --repo owner/repo\n\n# Actions / CI\ngh run list --repo owner/repo --limit 10\ngh run view --repo owner/repo\ngh run view --repo owner/repo --log-failed\ngh workflow list --repo owner/repo\n\n# Releases\ngh release list -R owner/repo\ngh release create v1.0.0\n\n# API\ngh api /user\ngh api repos/owner/repo\n\n# JSON 输出\ngh issue list --repo owner/repo --json number,title --jq '.[] | \"\\(.number): \\(.title)\"'\n```\n\n\n## 选择指南\n\n| 工具 | 来源 | 用途 |\n|-----|------|------|\n| gh CLI | agent-reach | Git 操作 |\n| zread | my-mcp-tools | 读仓库内容 |\n| context7 | my-mcp-tools | 查技术文档 |\n\n\n# 搜索工具\n\nExa AI 搜索引擎。\n\n## Exa AI 搜索\n\n高质量 AI 搜索引擎，适合查找技术文档、官方示例和相关网页。\n\n```bash\nmcporter call exa.web_search_exa query=\"query\" numResults=5\nmcporter call exa.web_search_exa query=\"library API code example\" numResults=5\n```\n\n### 使用场景\n\n| 场景 | 参数 |\n|-----|------|\n| 网页搜索 | `web_search_exa(query: \"...\", numResults: 5)` |\n| 技术/代码资料 | `web_search_exa(query: \"框架名 API 示例\", numResults: 5)` |\n\n> Exa MCP 的 `get_code_context_exa` 已弃用且默认不注册。代码问题也使用\n> `web_search_exa`；需要精确搜索仓库内容时，改用 `dev.md` 中的 GitHub 搜索。\n\n### 特点\n\n- 擅长英文内容和技术文档\n- 可通过查询词定位官方文档和代码示例\n- 结果质量高\n\n## 与其他搜索工具对比\n\n| 工具 | 来源 | 适用场景 |\n|-----|------|---------|\n| Exa | agent-reach | 英文/技术/代码搜索 |\n| 智谱搜索 | my-mcp-tools | 中文搜索 |\n| GitHub 搜索 | agent-reach (dev.md) | 仓库/代码搜索 |\n\n\n# 社交媒体 & 社区\n\n小红书、Twitter/X、B站、V2EX、Reddit、Facebook、Instagram。\n\n## 小红书 / XiaoHongShu（多后端）\n\n小红书有三个后端，**先跑 `agent-reach doctor --json` 看 xiaohongshu 的 `active_backend` 是哪个**，再用对应命令组。\n\n### 后端 A：OpenCLI（桌面首选）\n\n```bash\n# 搜索笔记\nopencli xiaohongshu search \"query\" -f yaml\n\n# 读笔记正文+互动数据（用搜索结果里的完整 URL，含 xsec_token）\nopencli xiaohongshu note \"NOTE_URL\" -f yaml\n\n# 评论（支持楼中楼）\nopencli xiaohongshu comments NOTE_ID -f yaml\n\n# 首页推荐 feed\nopencli xiaohongshu feed -f yaml\n\n# 用户主页公开笔记\nopencli xiaohongshu user USER_ID -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展。OpenCLI 只使用用户已经存在且明确控制\n> 的 Chrome 会话；Agent Reach 不替用户登录，也不读取浏览器 Cookie。\n> `agent-reach configure xhs-cookies` 不会把 Cookie 注入 OpenCLI。\n> 如果没有现成会话，不要自动登录；改走后端 B/C，并按对应的\n> Cookie-Editor 手工导出流程配置。\n\n### 后端 B：xiaohongshu-mcp（服务器场景）\n\n```bash\n# 认证前先让用户用 Cookie-Editor 手工导出，再显式导入\nagent-reach configure xhs-cookies\n\n# 只读检查当前状态\nmcporter call xiaohongshu.check_login_status --timeout 120000\n\n# 搜索\nmcporter call xiaohongshu.search_feeds keyword=\"query\" --timeout 120000\n\n# 笔记详情+评论（feed_id 和 xsec_token 从搜索结果取）\nmcporter call xiaohongshu.get_feed_detail feed_id=\"...\" xsec_token=\"...\" --timeout 120000\n```\n\n> 首次调用会自动下载约 150MB 无头浏览器，务必带 `--timeout 120000`。\n> 认证只走 Cookie-Editor 手工导出；导入后先运行 `check_login_status`。\n> 该显式命令会保存/导入用户提供的 xiaohongshu.com 同域 Cookie 集，用户应\n> 确认范围；非 xiaohongshu.com 域 Cookie 会被忽略。\n\n### 后端 C：xhs-cli（存量备选，上游 2026-03 起停更）\n\n```bash\nxhs search \"query\" # 搜索\nxhs read NOTE_ID_OR_URL # 读笔记（必须用搜索结果中的 URL/ID，不能裸 note_id）\nxhs comments NOTE_ID_OR_URL # 评论\nxhs hot # 热门\nxhs feed # 推荐\n```\n\n> 已知不稳定：`xhs user` / `xhs user-posts` / `xhs favorites` 可能返回 API error（上游停更无人修）。新装用户建议直接走后端 A/B。\n\n### 通用注意事项\n\n> **认证边界**: Agent Reach 不得替用户执行小红书登录，也不得读取浏览器\n> Cookie。OpenCLI 只能使用用户已有且明确控制的 Chrome 会话；\n> xiaohongshu-mcp / 存量工具使用 Cookie-Editor 手工导出。\n>\n> **xsec_token 限制**: 小红书强制 xsec_token 机制，**不能直接用裸 note_id 去读**。正确流程：先搜索/feed 拿结果，再用结果中的完整 URL/ID 去读。三个后端都一样。\n>\n> **频率控制**: 高频请求（批量搜索、深翻评论）会触发验证码，平台限制无法绕过。每次操作间隔 2-3 秒。\n>\n> **写操作（发帖/评论/点赞）**: 建议只读。xhs-cli v0.6.x 写操作可能因签名问题返回 406。\n\n## Twitter/X (twitter-cli)\n\n### 认证前置条件\n\n`agent-reach configure twitter-cookies` 通过隐藏输入保存的 Cookie 只供\n`agent-reach doctor` 检查显式凭据是否齐全。`doctor` 不执行上游\n`twitter status`，也不会设置当前 Shell。运行下面任何 `twitter` 命令前，\n必须在同一个 Shell 或子进程环境中显式提供：\n\n```bash\nexport TWITTER_AUTH_TOKEN=\"...\"\nexport TWITTER_CT0=\"...\"\n```\n\n### 稳定命令\n\n```bash\n# 首页时间线（最稳定）\ntwitter feed -n 20\n\n# 读取单条推文（含回复）\ntwitter tweet URL_OR_ID\n\n# 读取长文 / X Article\ntwitter article URL_OR_ID\n\n# 用户时间线\ntwitter user-posts @username -n 20\n\n# 用户资料\ntwitter user @username\n```\n\n### 可能不稳定的命令\n\n```bash\n# 搜索推文（Twitter 频繁改 GraphQL 端点，可能 404）\ntwitter search \"query\" -n 10\n\n# likes（2024 年后只能看自己的，平台限制）\ntwitter likes\n```\n\n### search 失败时的重试链（按序执行，成功即停）\n\n1. 直接重试一次（偶发失败常见）：`twitter search \"query\" -n 10`\n2. 升级后再试：`pipx upgrade twitter-cli && twitter search \"query\" -n 10`\n3. 换 OpenCLI 备选（桌面，复用浏览器登录态）：`opencli twitter search \"query\" -f yaml`\n4. 都不行就改用 `twitter feed` / `twitter user-posts @somebody` 等稳定命令绕路\n\n### 重要注意事项\n\n> **安装**: `pipx install twitter-cli`（确保 v0.8.5+）\n>\n> **认证**: 只用 Cookie-Editor 手工导出，再显式设置环境变量\n> `TWITTER_AUTH_TOKEN` + `TWITTER_CT0`；不要依赖自动浏览器读取。\n>\n> **IP 风控**: 不要在 VPS/数据中心 IP 上频繁调用，尤其是 followers/following，有封号风险。使用住宅代理或本地环境。\n>\n> **OpenCLI 备选**: 桌面装了 OpenCLI 的话，`opencli twitter search/article/user-posts -f yaml` 全套可用（浏览器登录态，无需 cookie 环境变量）。\n>\n> **输出格式**: 建议用 `--yaml` 或 `--json` 获得结构化输出，对 AI agent 更友好。\n\n## B站 / Bilibili\n\n> ⚠️ **不要用 yt-dlp 读 B站**（风控已全面 412 拦截，实测无解）。用 bili-cli / OpenCLI。\n\n```bash\n# 搜索 / 热门 / 视频详情（bili-cli，只读无需登录）\nbili search \"query\" --type video -n 5\nbili hot -n 10\nbili video BVxxx\n\n# 字幕（OpenCLI，需桌面 Chrome）\nopencli bilibili subtitle BVxxx\n```\n\n> 详细命令（音频转写、API 直连兜底）见 [references/video.md](video.md)。\n\n## V2EX (公开 API)\n\n无需认证，直接调用公开 API。\n\n### 热门主题\n\n```bash\ncurl -s \"https://www.v2ex.com/api/topics/hot.json\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 节点主题\n\n```bash\n# node_name 如: python, tech, jobs, qna, programmers\ncurl -s \"https://www.v2ex.com/api/topics/show.json?node_name=python&page=1\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 主题详情\n\n```bash\n# topic_id 从 URL 获取，如 https://www.v2ex.com/t/1234567\ncurl -s \"https://www.v2ex.com/api/topics/show.json?id=TOPIC_ID\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 主题回复\n\n```bash\ncurl -s \"https://www.v2ex.com/api/replies/show.json?topic_id=TOPIC_ID&page=1\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### 用户信息\n\n```bash\ncurl -s \"https://www.v2ex.com/api/members/show.json?username=USERNAME\" -H \"User-Agent: agent-reach/1.0\"\n```\n\n### Python 调用示例\n\n```python\nfrom agent_reach.channels.v2ex import V2EXChannel\n\nch = V2EXChannel()\n\n# 获取热门帖子\ntopics = ch.get_hot_topics(limit=10)\nfor t in topics:\n print(f\"[{t['node_title']}] {t['title']} ({t['replies']} 回复)\")\n\n# 获取节点帖子\nnode_topics = ch.get_node_topics(\"python\", limit=5)\n\n# 获取帖子详情 + 回复\ntopic = ch.get_topic(1234567)\nprint(topic[\"title\"], \"—\", topic[\"author\"])\n\n# 获取用户信息\nuser = ch.get_user(\"Livid\")\n```\n\n> **节点列表**: https://www.v2ex.com/planes\n\n## Reddit（多后端，必须登录态）\n\n**Reddit 没有零配置路径**：匿名 `.json` 端点已被封（403），官方 API 自 2025-11 起人工审批基本不批。两个后端都靠登录态，先跑 `agent-reach doctor --json` 看 reddit 的 `active_backend`。中国大陆访问需代理。\n\n### 后端 A：OpenCLI（桌面首选，复用浏览器登录态）\n\n```bash\n# 搜索帖子\nopencli reddit search \"query\" -f yaml\n\n# 读帖子全文 + 评论\nopencli reddit read POST_ID -f yaml\n\n# 浏览 subreddit / 热门 / Popular\nopencli reddit subreddit LocalLLaMA -f yaml\nopencli reddit hot -f yaml\nopencli reddit popular -f yaml\n\n# subreddit 元信息（订阅数、简介）\nopencli reddit subreddit-info LocalLLaMA -f yaml\n```\n\n> 要求 Chrome 打开且浏览器里登录过 reddit.com。\n\n### 后端 B：rdt-cli（存量/服务器备选，上游 2026-03 起停更）\n\n```bash\nrdt search \"query\" --limit 10 # 搜索帖子\nrdt read POST_ID # 读帖子全文 + 评论\nrdt sub python --limit 20 # 浏览 subreddit\nrdt popular --limit 10 # 浏览热门\nrdt all --limit 10 # 浏览 /r/all\n```\n\n> **安装**: `pipx install 'git+https://github.com/public-clis/rdt-cli.git'`（PyPI 版本落后，需从 GitHub 装 v0.4.2+）。先 `rdt login` 才能搜索和阅读（服务器无浏览器时手动写 Cookie，见 doctor 提示）。\n> 建议使用 `--yaml` 输出，对 AI agent 更友好。\n\n### 高级选项：官方 API + PRAW（仅限已有凭证的用户）\n\n2025-11 前注册过 Reddit script app（持有 client_id/client_secret）的用户可以用 PRAW 走官方 API（100 QPM 免费）。新申请需人工审批且个人项目基本不批，**不要推荐新用户走这条路**。\n\n## Facebook（OpenCLI，必须登录态）\n\nFacebook 走 OpenCLI，复用用户 Chrome 里的 facebook.com 登录态。先跑 `agent-reach doctor --json` 看 facebook 的 `active_backend`，正常应为 `OpenCLI`。不要推荐 Jina/Exa/Graph API 作为默认路径。\n\n```bash\n# 搜索用户 / 主页 / 帖子\nopencli facebook search \"query\" -f yaml\n\n# 用户或主页信息\nopencli facebook profile zuck -f yaml\n\n# 当前账号 News Feed\nopencli facebook feed --limit 10 -f yaml\n\n# 当前账号可见的群组列表/最近动态\nopencli facebook groups --limit 20 -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展，并已登录 facebook.com。Facebook Groups 当前只承诺读取当前账号可见的群组列表/最近动态，不承诺任意群帖子和评论 API。\n\n## Instagram（OpenCLI，必须登录态）\n\nInstagram 走 OpenCLI，复用用户 Chrome 里的 instagram.com 登录态。先跑 `agent-reach doctor --json` 看 instagram 的 `active_backend`，正常应为 `OpenCLI`。不要默认恢复 instaloader；历史上 cookies/401/429 不稳定。\n\n```bash\n# 搜索用户（不是全站帖子关键词搜索）\nopencli instagram search \"query\" -f yaml\n\n# 用户 Profile\nopencli instagram profile nasa -f yaml\n\n# 用户最近帖子\nopencli instagram user nasa --limit 12 -f yaml\n\n# Explore / Discover\nopencli instagram explore --limit 20 -f yaml\n\n# 当前账号收藏\nopencli instagram saved --limit 20 -f yaml\n```\n\n> 要求 Chrome 打开且装了 OpenCLI 扩展，并已登录 instagram.com。`instagram search` 是用户搜索；读帖子需要先确定 username，再用 `instagram user USERNAME`。若出现 429 / login required，先让用户在 Chrome 里重新登录并降低频率。\n\n\n# 视频/播客\n\nYouTube、B站、小宇宙播客的字幕和转录。\n\n## YouTube (yt-dlp)\n\n### 获取视频元数据\n\n```bash\nyt-dlp --dump-json \"URL\"\n```\n\n### 下载字幕\n\n```bash\n# 下载字幕 (不下载视频)\nyt-dlp --write-sub --write-auto-sub --sub-lang \"zh-Hans,zh,en\" --skip-download -o \"/tmp/%(id)s\" \"URL\"\n\n# 然后读取 .vtt 文件\ncat /tmp/VIDEO_ID.*.vtt\n```\n\n### 获取评论\n\n```bash\n# 提取评论（best-effort，不保证完整）\nyt-dlp --write-comments --skip-download --write-info-json \\\n --extractor-args \"youtube:max_comments=20\" \\\n -o \"/tmp/%(id)s\" \"URL\"\n# 评论在 .info.json 的 comments 字段中\n```\n\n### 搜索视频\n\n```bash\nyt-dlp --dump-json \"ytsearch5:query\"\n```\n\n> **字幕注意**: 手动上传的字幕提取可靠；自动生成字幕可能存在行间重复，需后处理。\n> **评论注意**: `--write-comments` 基于网页抓取（非 YouTube Data API），部分评论可能丢失。\n\n### 字幕失败时的重试链（按序执行，拿到实质内容即停）\n\n`doctor` 只确认 yt-dlp 本体与 JS runtime 能执行，不会请求具体视频；因此\n`active_backend: yt-dlp` 不等于目标视频的字幕已经通过实时验证。\n\n1. 先用上面的 `yt-dlp --write-sub --write-auto-sub` 命令。\n2. 若出现 bot 校验、字幕响应为空或没有生成字幕文件，且 OpenCLI 已连接：\n `opencli youtube transcript \"URL\" -f yaml`。\n3. OpenCLI 若返回 `Caption URL returned empty response`，最多重试 3 次；这是带\n 过期时间的字幕 URL 偶发失效，不能把空响应当成“视频没有字幕”。\n4. 仍失败或视频本来就没有字幕：`agent-reach transcribe \"URL\"` 下载音频转写。\n\n成功标准是实际得到非空字幕/转录内容，不是命令退出码或 `doctor` 的版本探测结果。\n\n### 无字幕兜底：Whisper 音频转写\n\n```bash\n# 视频没有字幕时的兜底：下载音频并用 Whisper 转写（Groq 免费 key 即可）\nagent-reach transcribe \"https://www.youtube.com/watch?v=VIDEO_ID\"\nagent-reach transcribe ./local_audio.mp3 -o /tmp/transcript.txt\n```\n\n> `agent-reach transcribe` 只接收公开 http(s) URL 或本地音频文件。用 `ytsearch5:` 搜索时，先从 yt-dlp 结果里选出具体视频 URL，再转写。\n> 需要先配置 key：`agent-reach configure groq-key`（隐藏输入；免费，console.groq.com）\n> 或 `agent-reach configure openai-key`。默认 auto 模式只使用第一个已配置服务商\n>（优先 Groq，否则 OpenAI），失败即停止，不会把音频自动发给另一家。\n> `--allow-provider-fallback` 会显式授权跨服务商降级；同一音频内容可能被 Groq 和\n> OpenAI 分别处理，并可能产生 OpenAI 费用，只应在确认内容可分享给两家后使用。\n\n## B站 / Bilibili（bili-cli 为主，OpenCLI 补字幕）\n\n> ⚠️ **不要用 yt-dlp 读 B站**：B站风控已全面 412 拦截 yt-dlp（实测最新版、直连/代理/带 Cookie 全部无效）。yt-dlp 只用于 YouTube。\n\n### 视频详情/搜索/热门/排行 (bili-cli，只读无需登录)\n\n```bash\n# 视频详情（标题/UP主/时长/播放互动数据/字幕可用性）\nbili video BVxxx\n\n# 搜索视频\nbili search \"query\" --type video -n 5\n\n# 热门视频 / 排行榜\nbili hot -n 10\nbili rank -n 10\n\n# 下载音频并切分为 ASR-ready WAV（无字幕时配合 agent-reach transcribe 转写）\nbili audio BVxxx\n```\n\n### 字幕 (OpenCLI，需要桌面 Chrome)\n\n```bash\n# 字幕逐句带时间轴\nopencli bilibili subtitle BVxxx\n\n# OpenCLI 也能搜索/读视频元数据（备选）\nopencli bilibili search \"query\" -f yaml\nopencli bilibili video BVxxx -f yaml\n```\n\n### 零配置兜底：搜索 API 直连\n\n```bash\nUA=\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36\"\ncurl -s -c /tmp/bili_ck.txt -o /dev/null -A \"$UA\" \"https://www.bilibili.com/\"\ncurl -s -b /tmp/bili_ck.txt -A \"$UA\" -e \"https://www.bilibili.com/\" \\\n \"https://api.bilibili.com/x/web-interface/search/all/v2?keyword=QUERY&page=1\"\n```\n\n> **安装 bili-cli**: `pipx install bilibili-cli`（上游 2026-03 起停更但实测健康；只读场景无需登录，`bili login` 扫码可解锁动态/收藏等个人功能）。\n\n## 小宇宙播客 / Xiaoyuzhou Podcast\n\n### 转录单集播客（可选 --polish 增强标点）\n\n```bash\n# 输出 Markdown 文件到 /tmp/。--polish 让 Llama 3.3 70B 给文稿补中文标点+合理分段\n~/.agent-reach/tools/xiaoyuzhou/transcribe.sh --polish \"https://www.xiaoyuzhoufm.com/episode/EPISODE_ID\"\n```\n\n> 转写 prompt 已要求 Whisper 输出中文标点；若标点效果仍不理想，可加 `--polish` 用 Groq 上免费的 Llama 3.3 70B 补标点+合理分段（9 分钟播客约多 ~7 秒）。每次转写多一轮 LLM 调用，按需使用。\n\n### 前置要求\n\n1. **ffmpeg**: `brew install ffmpeg`\n2. **Groq API Key** (免费): https://console.groq.com/keys\n3. **配置 Key**: `agent-reach configure groq-key`（隐藏输入）\n4. **首次运行**: `agent-reach install --env=auto --system --channels=xiaoyuzhou`（需用户明确授权）\n\n### 检查状态\n\n```bash\nagent-reach doctor\n```\n\n> 输出 Markdown 文件默认保存到 `/tmp/`。\n\n## 选择指南\n\n| 场景 | 推荐工具 |\n|-----|---------|\n| YouTube 字幕 | yt-dlp；失败时 OpenCLI（最多 3 次）→ agent-reach transcribe |\n| B站视频详情/搜索 | bili-cli |\n| B站字幕 | opencli bilibili subtitle |\n| 播客转录 | 小宇宙 transcribe.sh |\n| 无字幕音视频 | agent-reach transcribe（B站音频先 `bili audio`） |\n\n\n# 网页阅读\n\n通用网页、RSS。\n\n## 通用网页 (Jina Reader)\n\n```bash\n# 读取任意网页内容\ncurl -s \"https://r.jina.ai/URL\"\n\n# 示例\ncurl -s \"https://r.jina.ai/https://example.com/article\"\n```\n\n**适用场景**: 大多数网页可以直接用 Jina Reader 读取。\n\n## Web Reader (MCP)\n\n```bash\n# 读取网页内容 (Markdown 格式)\nmcporter call web-reader.webReader url=\"https://example.com\"\n\n# 保留图片\nmcporter call web-reader.webReader url=\"https://example.com\" retain_images=true\n\n# 纯文本格式\nmcporter call web-reader.webReader url=\"https://example.com\" return_format=\"text\"\n```\n\n**适用场景**: 需要更精确控制输出格式时使用。\n\n## RSS (feedparser)\n\n```python\npython3 -c \"\nimport feedparser\nfor e in feedparser.parse('FEED_URL').entries[:5]:\n print(f'{e.title} — {e.link}')\n\"\n```\n\n**适用场景**: 订阅博客、新闻源、播客等 RSS feed。\n\n## 选择指南\n\n| 场景 | 推荐工具 |\n|-----|---------|\n| 通用网页 | Jina Reader (`curl r.jina.ai`) |\n| 需要图片/格式控制 | web-reader MCP |\n| RSS 订阅 | feedparser |\n\n\n---\nname: agent-reach\ndescription: >\n MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything\n on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X /\n 看看大家怎么评价 X / X 上有什么讨论 / research this topic。\n\n Also MUST USE when user mentions any platform or shares any URL/链接:\n 小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili, Reddit, Facebook,\n Instagram, V2EX, LinkedIn/领英/Boss直聘/招聘/求职/jobs, YouTube, GitHub code search, 小宇宙播客,\n 雪球/股票行情, RSS feeds, or any web URL.\n\n 16 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs).\n Zero config for 6 channels. Run `agent-reach doctor --json` to see which\n backend serves each platform right now.\n\n NOT for: 写报告/数据分析/翻译等内容加工（本 skill 只负责从互联网获取内容）；\n 发帖/评论/点赞等写操作；已有专门 skill 的平台（先用专门 skill）。\n\n 【路由方式】SKILL.md 包含路由表和常用命令，复杂场景需按需阅读对应分类的 references/*.md。\n 分类：search / social (小红书/推特/B站/V2EX/Reddit/Facebook/Instagram) / career(LinkedIn/Boss直聘) / dev(github) / web(网页/文章/RSS) / video(YouTube/B站/播客) / finance(雪球/股票)。\nmetadata:\n homepage: https://github.com/Panniantong/Agent-Reach\n---\n\n# Agent Reach — 互联网能力路由器\n\n16 平台、多后端。**本 skill 存在时必须用它访问这些平台，不要自己发明方案。**\n\n## 常驻规则（全程适用）\n\n1. **动手前先体检**：多后端/登录态平台（小红书/Reddit/B站/Twitter/Facebook/Instagram/Boss直聘）先跑\n `agent-reach doctor --json`。`active_backend` 有值时按它选命令组；`active_backend: null`\n 表示 Doctor 为避免触发浏览器 Cookie 读取或远端写入而没有做实时验证，不代表后端不存在。\n Doctor 结果是「某一时刻的快照」，通道/登录态可能已变化；执行只读命令前若怀疑失效，\n 按对应 reference 的「体检与恢复」runbook 重新确认（如 career.md 的 Boss直聘 CDP 排查）。\n2. **声明你在用什么**：开始干活前说一句「使用 agent-reach 的 X 平台 / Y 后端」。\n3. **失败按 references 里的重试链处理**，不要瞎猜命令。\n4. **全网调研类任务**：组合多平台（Exa 搜索 + Twitter/Reddit 看讨论 + 小红书/B站看中文场景），并行收集再汇总。\n5. **替用户盯版本**：完成一次较大的调研/多平台任务后，顺手跑\n `agent-reach check-update`（很快，一个 API 调用）。有新版就在收尾汇报里附一句：\n 「Agent Reach 有新版 vX.Y.Z，复制这句话给我即可更新：帮我更新 Agent Reach：\n https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」。\n 不要中断当前任务去更新，也不要重复提醒同一个版本。\n\n## 路由表\n\n| 用户意图 | 分类 | 详细文档 |\n|---------|------|---------|\n| 网页搜索/代码搜索 | search | [references/search.md](references/search.md) |\n| 小红书/推特/B站/V2EX/Reddit/Facebook/Instagram | social | [references/social.md](references/social.md) |\n| 招聘/职位/LinkedIn/Boss直聘 | career | [references/career.md](references/career.md) |\n| GitHub/代码 | dev | [references/dev.md](references/dev.md) |\n| 网页/文章/RSS | web | [references/web.md](references/web.md) |\n| YouTube/B站/播客字幕 | video | [references/video.md](references/video.md) |\n| 雪球/股票行情 | finance | [references/finance.md](references/finance.md) |\n\n## 零配置快速命令\n\n```bash\n# Exa 网页搜索\nmcporter call exa.web_search_exa query=\"query\" numResults=5\n\n# 通用网页阅读\ncurl -s \"https://r.jina.ai/URL\"\n\n# GitHub 搜索\ngh search repos \"query\" --sort stars --limit 10\n\n# YouTube 字幕（注意：B站不要用 yt-dlp，失败重试链见 video.md）\nyt-dlp --write-sub --write-auto-sub --skip-download -o \"/tmp/%(id)s\" \"URL\"\n\n# V2EX 热门\ncurl -s \"https://www.v2ex.com/api/topics/hot.json\" -H \"User-Agent: agent-reach/1.0\"\n\n# B站搜索（bili-cli，无需登录）\nbili search \"query\" --type video -n 5\n```\n\n## 需登录态的平台（按 doctor 的 active_backend 选命令）\n\nTwitter 注意：`agent-reach configure twitter-cookies` 保存的 Cookie 只供\n`doctor` 检查配置是否齐全；`doctor` 不执行 `twitter status`，也不会设置当前\nShell。直接运行 `twitter` 前，必须在子进程环境中显式提供\n`TWITTER_AUTH_TOKEN` 和 `TWITTER_CT0`，不得在日志或命令回显中暴露值。\n\n小红书注意：Agent Reach 不替用户登录，也不读取浏览器 Cookie。OpenCLI 只用\n用户已有且明确控制的 Chrome 会话；没有现成会话时不要自动登录，改用\nCookie-Editor 手工导出后配置 xiaohongshu-mcp / 存量工具。\n\nBoss直聘配置触发：当用户说“帮我配 Boss直聘”时，先读取 `references/career.md`\n的 Boss 章节，然后在获得安装授权后运行\n`agent-reach install --env=local --system --channels=boss`。Agent 负责按系统启动\n只绑定 `127.0.0.1:9222` 的专用 Chrome；**拉起后第一步是暂停并让用户肉眼确认**\n窗口内是已登录状态（右上角有头像），未登录则让用户登录/扫码，用户确认后再运行\n`boss --cdp-url http://localhost:9222 login --cdp` 和 `agent-reach doctor` 验收。\n不要让用户自己研究端口参数。\n专用 Chrome profile 必须长期复用，不要每次创建，也不要默认改用日常主 Chrome。\n\n判断 CDP 浏览器登录态**不要信 `boss status`**（它只校验本地 session.enc，与\n浏览器登录态互不代表），以 `agent-reach doctor` 的浏览器 cookie 探测（wt2）\n为准，并配合用户肉眼确认。绝不用当前页 URL 判断登录态：\n`security-check` / `zhipin-security` / `_security_check` 安全校验页是 Boss 反爬挑战，\n与登录无关——已登录也会出现（带 CDP 调试端口的 Chrome 几乎必现）。看到它不要\n当成“未登录”，先跑 `agent-reach doctor` 看浏览器 cookie，再决定是否需要用户登录。\n搜索报 `AUTH_EXPIRED` 即浏览器未登录的 ground truth：直接走登录流程 + `login --cdp`，\n不要往安全校验方向解释。\n\n执行搜索时必须使用\n`boss --browser-source existing-browser --cdp-url http://localhost:9222 search ...`；\n遇到 `ENVIRONMENT_RISK` 立即停止，不刷新、不重新登录、不自动重试。\n\n```bash\n# Twitter 搜索（twitter-cli 首选；失败重试链见 social.md）\ntwitter search \"query\" -n 10\n\n# Reddit（无零配置路径：OpenCLI 或 rdt-cli，必须登录态）\nopencli reddit search \"query\" -f yaml # 桌面\nrdt search \"query\" --limit 10 # 存量/服务器\n\n# 小红书（桌面首选 OpenCLI）\nopencli xiaohongshu search \"query\" -f yaml\n\n# Facebook / Instagram（桌面 OpenCLI，复用浏览器登录态）\nopencli facebook search \"query\" -f yaml\nopencli facebook groups -f yaml\nopencli instagram search \"query\" -f yaml # 搜用户\nopencli instagram user USERNAME -f yaml # 读指定用户最近帖子\n```\n\n## 环境检查\n\n```bash\n# 检查可用 channel 与每个平台当前激活的后端\nagent-reach doctor --json\n```\n\n## OpenCLI 适配器发现\n\n路由表没有覆盖用户需要的平台或命令时，先用 `opencli list` 查已有适配器，再用\n`opencli <平台> --help` 查看公开命令。发现适配器只证明命令存在，不证明登录态或\n目标内容可用；仅在用户任务明确需要该平台时执行只读命令，并以实际非空内容验收。\n\n## 工作区规则\n\n**不要在 agent workspace 创建文件。** 使用 `/tmp/` 存放临时输出，`~/.agent-reach/` 存放持久数据。\n\n## 详细文档\n\n根据用户需求，阅读对应的详细文档：\n\n- [搜索工具](references/search.md) — Exa AI 搜索\n- [社交媒体](references/social.md) — 小红书, Twitter, B站, V2EX, Reddit, Facebook, Instagram（多后端/登录态命令组）\n- [职场招聘](references/career.md) — LinkedIn, Boss直聘\n- [开发工具](references/dev.md) — GitHub CLI\n- [网页阅读](references/web.md) — Jina Reader, RSS\n- [视频播客](references/video.md) — YouTube, B站, 小宇宙\n- [金融行情](references/finance.md) — 雪球股票行情、搜索、热门内容\n\n## 配置渠道\n\n如果某个 channel 需要配置，获取安装指南：\nhttps://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md\n\n用户只需提供 cookies，其他配置由 agent 完成。\n"}