agent-reach

Agent Reach 是一套面向 AI 智能体的互联网访问工具集，为 13 个以上平台提供上游工具，供智能体直接调用，从而完成搜索、阅读和交互等任务。

【用途】 Agent Reach 的核心用途是让智能体能够访问和操作互联网上的多种平台内容，包括社交媒体、视频平台、代码托管、招聘网站、内容社区和 RSS 订阅等。它把各平台分散的访问方式统一为一组可调用的命令和接口。

【主要能力】

1. 通用网页：通过 curl 调用 https://r.jina.ai/URL 读取任意 URL 内容。
2. 网页搜索（Exa）：通过 mcporter 调用 exa.web_search_exa 进行搜索，或调用 exa.get_code_context_exa 获取代码上下文。
3. Twitter/X（xreach）：支持搜索、读取推文（含 /status/ 和 /article/ URL）、查看用户时间线、读取完整线程。
4. YouTube（yt-dlp）：获取视频元数据、下载字幕（支持 zh-Hans、zh、en）、搜索视频。
5. Bilibili（yt-dlp）：获取视频元数据、下载并转换字幕。服务器 IP 可能返回 412，可使用 --cookies-from-browser chrome 或配置代理。
6. Reddit：通过 JSON 接口读取子版块热帖和搜索。服务器 IP 可能返回 403，可改用 Exa 搜索或配置代理。
7. GitHub（gh CLI）：搜索仓库、查看仓库、搜索代码、列出和查看 issue。
8. 小红书（mcporter）：搜索笔记、获取笔记详情（可加载全部评论）、发布内容。需要登录，使用 Cookie-Editor 导入 cookies。
9. 抖音（mcporter）：解析视频信息、获取下载链接。无需登录。
10. 微信公众号：使用 miku_ai 搜索文章，使用 Camoufox 阅读文章（可绕过微信反爬）。微信文章无法用 Jina Reader 或 curl 读取，必须使用 Camoufox。
11. LinkedIn（mcporter）：获取个人资料、搜索人员。备用方案为 curl 调用 r.jina.ai。
12. Boss直聘（mcporter）：获取推荐职位、搜索职位。备用方案为 curl 调用 r.jina.ai。
13. RSS：使用 feedparser 解析订阅源并输出条目。

【使用方式】 运行 agent-reach doctor 可检查哪些渠道可用，并显示状态和修复说明。各平台通过对应的命令行工具或 mcporter 调用。若某渠道需要配置（如 cookies、Docker 等），可获取安装指南：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md。用户只需提供 cookies，其余配置由智能体完成。

【工作区规则】 不要在智能体工作区创建文件。临时输出使用 /tmp/，持久数据使用 ~/.agent-reach/。

【故障排查】 渠道不可用时运行 agent-reach doctor 查看状态和修复说明。Twitter 获取失败时，确保已安装 undici（npm install -g undici），并可通过 agent-reach configure proxy URL 配置代理。

【适用场景】 适用于需要让智能体跨平台搜集信息、阅读内容、搜索资料、查看代码仓库、获取职位信息、解析视频信息等场景。

【限制】 部分平台需要登录或配置 Cookie（如小红书），部分平台在服务器 IP 下可能返回 412 或 403（如 Bilibili、Reddit），需要配置代理或使用替代方案。微信公众号阅读必须使用 Camoufox。具体平台的可用性受网络环境和配置影响。