Agent-Reach 是一个为 AI Agent 提供互联网访问能力的能力层（capability layer）工具，目标是让 Agent 能够读取和搜索 Twitter、Reddit、YouTube、GitHub、Bilibili、小红书等平台内容。项目以 CLI 形式提供，官方称读取和搜索不产生 API 费用。
【用途与定位】 AI Agent 已能写代码、改文档、管项目，但联网找信息时常常受限：YouTube 拿不到字幕、Twitter API 需付费、Reddit 服务器 IP 被 403 拒绝、小红书必须登录、B站被风控拦截、网页抓回来一堆 HTML 标签、RSS 需自己写代码。Agent-Reach 将这些门槛统一处理。它并不做一个新的抓取工具，而是比具体实现高一层，负责选型、安装、体检、路由，实际读取由 Agent 直接调用上游工具完成，没有包装层。
【主要能力与支持渠道】 零配置渠道（默认激活 6 个）包括：通过 curl https://r.jina.ai/URL 读取任意网页、用 gh repo view owner/repo 查看 GitHub 仓库、用 yt-dlp 提取 YouTube 字幕、用 bili search 搜索 B站（无需登录）、用 Exa 进行全网语义搜索、用 feedparser 解析订阅 RSS。 需要登录态的渠道包括小红书、Twitter、Reddit、Facebook、Instagram，Agent 会列出菜单询问用户需要哪些，点名后才安装。 每个平台维护一个首选加备选的有序后端列表，渠道文件按序真实探测各候选后端（不只是检查命令是否存在），第一个完整可用的当选，坏掉的会给出修复处方。更换接入方式只需调整列表顺序，而非重写代码。agent-reach doctor 命令可查看每个渠道的状态、当前使用哪个后端。
【使用方式】 用户将指定的一句话指令复制给 AI Agent（如 Claude Code、OpenClaw、Cursor 等），Agent 会自行完成后续安装。已安装过的用户更新同样只需一句话。安装流程包括：从本仓库安装 agent-reach 命令行（自带 yt-dlp、feedparser，官方提示不要从 PyPI 安装同名包，那不是本项目）；检查 Node.js、gh CLI、mcporter 等系统基建并给出缺失项安装方式；在显式传入 --system 时安装依赖并通过 MCP 接入 Exa；检测环境是本地还是服务器；在显式 --system 时写入 Agent 的 skills 目录；默认只激活零配置渠道。官方强调 agent-reach install 默认只检查环境，不会自动装系统包或写配置，只有明确允许修改系统后才使用 agent-reach install --system。 使用 OpenClaw 的用户需先确认 exec 权限已开启，因为 Agent-Reach 依赖 Agent 执行 shell 命令；可在 ~/.openclaw/openclaw.json 设置 "tools": { "profile": "coding" }，重启 Gateway 并开启新对话。其他平台不受此限制。 配置方面，用户无需记命令，Agent 读取 SKILL.md 后会自行判断调用；需要登录的平台告诉 Agent「帮我配 XXX」即可。
【安全与限制】 Cookie 只存在本地，不上传不外传，代码完全开源。Twitter 只接受用户通过 Cookie-Editor 手工导出的内容；Agent-Reach 不替用户执行小红书登录，也不读取小红书浏览器 Cookie；OpenCLI 只使用用户已存在且明确控制的 Chrome 会话；agent-reach configure xhs-cookies 不会把 Cookie 注入 OpenCLI/Chrome。Twitter Cookie 保存后仅供 agent-reach doctor 检查配置是否齐全，直接运行上游 twitter 命令前仍需在当前进程环境中显式设置 TWITTER_AUTH_TOKEN 和 TWITTER_CT0。 官方提醒：使用 Cookie 登录的平台（Twitter、小红书等）通过脚本/API 调用存在被平台检测并封号的风险，务必使用专用小号，不要用主账号，原因是封号风险和 Cookie 等同完整登录权限的安全风险。 本地电脑不需要代理；代理仅在部署到服务器时需要（约 $1/月）。 卸载会清除 ~/.agent-reach/（含所有 token/cookie）、各 Agent 的 skill 文件、mcporter 中的 MCP 配置；卸载 Python 包本身使用 pip uninstall agent-reach。
【生态与依赖】 涉及的上游工具包括 OpenCLI、twitter-cli、rdt-cli、xiaohongshu-mcp、xhs-cli、bili-cli、yt-dlp、Jina Reader、Exa、mcporter、feedparser、mcp-server-linkedin。项目作者表示会持续维护，追踪平台变化、接入新渠道，保证渠道尽量能用、好用、免费。
关于具体收费、价格、平台完整清单、各渠道详细步骤等，官方资料未逐一提供，暂未提供。
