Agent Reach 是一个为 AI 智能体提供互联网读取能力的命令行工具,目标是让智能体能够搜索和阅读多个互联网平台的内容。它采用只读模式,返回结构化 JSON 输出,并宣称零 API 费用。
用途 Agent Reach 主要用于让智能体在需要搜索、读取网页或平台内容时,通过一个统一 CLI 访问多个渠道。它适合需要从社交媒体、代码托管、视频平台、社区论坛等来源获取信息的自动化流程。
主要能力 工具支持多个渠道,分为默认和可选两类。默认渠道包括:web(通用网页读取、内容提取、搜索回退,基于 Jina Reader、Exa)、youtube(视频转录、字幕、音频转文字,基于 yt-dlp、whisper)、github(仓库、文件、issue、提交日志、拉取请求,基于 GitHub 公共 API)、bilibili(视频详情、字幕、弹幕评论,基于 bili-cli 和公共端点)、v2ex(主题阅读、社区讨论,基于 V2EX 公共 feed)。可选渠道包括:reddit(子版块搜索、帖子、评论树,基于 Reddit json/RSS)、linkedin(帖子、公司资料、职位发布,基于 OpenCLI / CloakBrowser)、twitter / x(推文、搜索、用户资料,基于 OpenCLI / CloakBrowser)、xiaohongshu(笔记描述、标签、评论,基于 CloakBrowser 会话)、boss(开发者职位列表、技能需求,基于 boss-agent-cli)、xueqiu(股票行情、金融情绪,基于雪球公共端点)、xiaoyuzhou(播客转录、摘要,基于 Groq Whisper API)。
使用方式 基本命令包括:agent-reach channels 列出可用渠道、操作和参数;agent-reach <channel> <action> [args] 执行具体操作,例如 agent-reach github search "vulnerability scanner";agent-reach read <url> 自动选择渠道并读取任意 URL。安装推荐使用 uv:uv tool install https://github.com/Panniantong/Agent-Reach/archive/refs/tags/v1.6.0.zip,然后运行 agent-reach setup。渠道和依赖管理命令包括:agent-reach add <channel> 安装可选渠道依赖;agent-reach remove <channel> 移除未使用渠道;agent-reach doctor --text 检查系统依赖和浏览器状态;agent-reach check <channel> 验证特定渠道连通性;agent-reach update 升级 Agent Reach 和已安装渠道工具。
结果结构与错误处理 输出为标准化 JSON,包含 { ok, channel, action, backend, items, meta, error }。当 ok 为 true 时,结果在 items 中,包含 title、url、author、published_at、text、raw 等字段。当 ok 为 false 时,需检查 error.code:NEED_SETUP 表示依赖缺失,需运行 agent-reach add <channel>,如需密钥则用户运行 agent-reach configure <key>;NEED_LOGIN 表示站点需要登录,用户需在自己的窗口中运行 agent-reach login <channel>,工具不会代用户登录;UPSTREAM_BROKEN 表示平台布局变化,需告知用户,如同意可运行 agent-reach update;TIMEOUT 表示请求超时,运行 agent-reach doctor --text,不要激进重试;RATE_LIMITED 表示平台限流,等待 meta 中指定的 retry_after_seconds;PLATFORM_BLOCKED 表示验证码或 Cloudflare 拦截,用户需打开官方页面解决验证码;NOT_FOUND 表示内容不存在,检查目标 URL 或关键词。
与 REA 集成 当与 REA(Reverse Engineer Anything)套件结合时,可用于威胁与漏洞研究:在审计网站或二进制文件时,使用 Agent Reach 快速查找 CVE、GitHub 讨论和安全公告,例如 agent-reach github search "package-name vulnerability CVE" 或 agent-reach reddit search "framework-name security breach"。深度网页读取:当网站或 API 被 Cloudflare 或机器人保护阻止标准 curl/fetch 时,使用 agent-reach read https://target-app.com/docs。教程与漏洞利用视频转录:直接从 YouTube 或 Bilibili 视频转录中提取技术解释,无需观看视频,例如 agent-reach youtube read "https://www.youtube.com/watch?v=..."。
安全与红线 Agent Reach 是只读的,从不发布、评论、点赞或发送消息。凭证安全方面,从不代用户登录,从不询问、捕获或记录密码。浏览器会话在 ~/.agent-reach/browser/profile 下的隔离配置文件中运行,并在空闲 10 分钟后关闭。
适用场景 适用于需要让智能体读取多平台内容的自动化任务,如信息检索、漏洞研究、技术教程提取、社区讨论分析等。
限制 工具为只读,不支持写入操作。部分渠道需要额外安装依赖或登录,且可能受平台限流、验证码或布局变化影响。具体收费、价格、平台支持范围等未在资料中提供的信息暂未提供。