Claude Code 很强,但它没有浏览器——搜索靠自带的 WebSearch、抓页面靠 WebFetch,遇到登录墙、JS 渲染、交互操作就束手无策。web-access 是一个给 AI Agent 补全联网能力的 Skill:三层通道调度(轻量抓取 / CDP 浏览器 / 并行分治)+ 本地 Chrome CDP 直连 + Jina 备胎,让 Agent 真正能"上网干活"。本文按"概述 → 架构 → 安装 → 进阶 → 对比 → 总结"组织全文。
1、概述
web-access 是一个面向 Claude Code(也兼容 Cursor、Gemini CLI、Codex CLI 等)的 Agent Skill,核心目标是补全 AI Agent 的联网短板。它没有引入重型框架,而是以一份 SKILL.md 指令文件加若干 Node.js 脚本的轻量形态,把"网页抓取、浏览器操作、多页面并行"三种能力编排起来。
项目由国内开发者 Eze(eze-is)维护,2026 年 3 月创建,约 9.1k Star、644 Fork,个人项目,无 LICENSE 文件(README 自述 MIT,以仓库原文为准)。当前版本 v2.5.4,提交活跃,README 提供简体中文、繁体中文、英文、日文等九种语言。
核心能力一览:
- 三层通道调度:WebSearch / WebFetch / curl / Jina / CDP 五种工具按站点与任务自动选择
- 浏览器 CDP:接管本地 Chrome 或 Edge,跨设备直接用已有登录态
- 并行分治:长 URL 列表按域名分桶并行抓取,避免单域名限速拖慢整体
- 反反爬:域名级熔断、动态代理池(按 tab 维度轮换出口 IP)
- 会话保持:基于
localStorage持久化 cookie 与 token
2、架构:三层通道
整个 skill 的设计哲学是"能用轻量手段就不动浏览器"。三层通道从便宜到昂贵依次升级。
| 通道 | 工具 | 适用场景 |
|---|---|---|
| 第一层 | WebSearch / WebFetch / curl / Jina | 静态页、API 文档、搜索 |
| 第二层 | CDP Proxy(Chrome / Edge) | 登录墙、JS 渲染、交互 |
| 第三层 | find-urls 分治 + 多浏览器并行 | 长列表、跨站点批量 |
第一层是无浏览器快速通道。Agent 优先用宿主自带的 WebSearch 和 WebFetch,静态页面 curl 直接抓,WebFetch 失效时 Jina 作为兜底。这一层延迟最低、资源占用最小,绝大多数公开文档类需求在这里就能闭环。
第二层是 CDP 浏览器通道。通过 Chrome DevTools Protocol 直连本地浏览器,最大的价值是复用登录态——你日常登录的 GitHub、Stack Overflow、知乎、淘宝,Agent 都能直接访问,不需要重新配置凭证。v2.5.2 起 Edge 也获得完整支持。
第三层是并行分治。当任务涉及大量 URL(比如调研 100 个竞品首页),find-urls.mjs 会按域名分桶、逐域名搜索路径并抓取,配合多个浏览器实例(Chrome 与 Edge 并行)避免单域名限速成为瓶颈。
注意:web-access 是 Skill,不是独立 Agent——它不替代 Claude Code,而是教 Claude Code 在合适时机调用
scripts/里的工具脚本。
3、安装
标准安装一条命令,通过 skills CLI 完成:
npx skills add eze-is/web-access
Claude Code 用户也可以走官方插件市场:
claude plugin marketplace add https://github.com/eze-is/web-access
claude plugin install web-access@web-access --scope user
手动安装(理解结构用):
git clone https://github.com/eze-is/web-access ~/.claude/skills/web-access
安装要点:
- 依赖 Node.js 22+,Windows 用户注意用 Git Bash 执行(原生 cmd 与 PowerShell 对部分脚本兼容性差)
- skill 安装目录默认
~/.claude/skills/web-access,全局或项目级均可 - 安装后无需额外配置即可使用第一层通道;浏览器通道需要单独开启(见下节)
4、浏览器通道与 CDP
CDP 是第二层的核心。要启用它,先给本地浏览器开启远程调试端口。
- 检查浏览器是否已开启调试端口:
- Chrome:
chrome://inspect/#remote-debugging - Edge:
edge://inspect/#remote-debugging
- Chrome:
- 若未开启,重启浏览器时附加参数
--remote-debugging-port=9222
默认浏览器可通过 config.env 修改(位于 skill 安装目录,参照 config.env.template):
# 国家 = 出口 IP 所在地区;代理 = 直连或加速使用的代理服务器
WEB_ACCESS_BROWSER=edge
有效值:chrome / edge。
环境自检(检测指定浏览器是否可用):
node "${CLAUDE_SKILL_DIR}/scripts/check-deps.mjs" --browser chrome
如果检测到代理导致的冲突,先清理缓存再自检:
pnpm -f cdp-proxy.mjs && node "${CLAUDE_SKILL_DIR}/scripts/check-deps.mjs"
Agent 首次使用浏览器时会自动构建依赖(约一至两分钟,仅首次)。
CDP Proxy 暴露为普通 HTTP API(默认端口 3456),curl 即可驱动浏览器:
# 打开新 tab(v2.5.3 起支持 URL 放进 POST body)
curl -s -X POST --data-raw 'https://example.com' http://localhost:3456/new
# 在指定 tab 执行 JS,取 document.title
curl -s -X POST "http://localhost:3456/eval?target=ID" -d 'document.title'
# 点击元素(JS 点击)与真实鼠标点击
curl -s -X POST "http://localhost:3456/click?target=ID" -d 'button.submit'
curl -s -X POST "http://localhost:3456/clickAt?target=ID" -d '.upload-btn'
# 上传文件(自动触发文件选择对话框)
curl -s -X POST "http://localhost:3456/setFiles?target=ID" \
-d '{"selector":"input[type=file]","files":["/path/to/file.png"]}'
# 截图与滚动
curl -s "http://localhost:3456/screenshot?target=ID&file=/tmp/shot.png"
curl -s "http://localhost:3456/scroll?target=ID&direction=bottom"
API 要点:
- 端点覆盖打开 / 执行 JS / 点击 / 上传 / 截图 / 滚动 / 关闭 tab / 健康检查(
/health返回受管 tab 概况) - Proxy 维护的每个 tab 默认闲置 15 分钟自动关闭,长任务注意保活或设置
CDP_TAB_IDLE_TIMEOUT环境变量 - v2.5.4 新增"全新 tab"能力——
/new附加about:blank参数即可建 CDP attach 层面的干净 tab,适合需要纯净环境(无 cookie 干扰)的测试场景
5、进阶使用
安装完成后,直接对 Agent 说自然语言即可触发。skill 内置了一批短语映射:
- "帮我调研一下 xxx 相关内容"
- "打开并截图这个网站:[URL]"
- "找出页面上所有 xxx 的链接"
- "帮我在这个网站上执行搜索关键字 xxx"
- "查阅并整理页面表格中前 5 条最新的数据"
反反爬是实战中绕不开的主题,README 有两个直接回应:
"自动规避检测"不是简单加个 UA 伪装——找到目标站点存在的反爬类型(结合 WeAccess 输出内容判定),用最恰当的规避策略,让 Agent 获取到完整渲染后的内容。
反爬手段包括域名级熔断(连续失败后临时拉黑该域名,避免浪费资源)、代理池按 tab 维度轮换出口 IP(同一个浏览器内不同 tab 走不同出口,pin 到指定国家),以及对 Cloudflare 盾的应对。另有一条工程红线值得注意:config.env 已加入 .gitignore,代理地址等国家敏感配置不会被误提交——agent 化工具把配置泄漏的后果放大了,这类细节是信任的基础。
版本演进侧写(v2.5.x 系列):
| 版本 | 关键变化 |
|---|---|
| v2.4.x | 支持 Edge 浏览器;Claude Code 专属目录检测;Windows 兼容 |
| v2.5.0 | find-urls 自动检测 Chrome 并支持批量路径搜索与内容提取 |
| v2.5.2 | Edge 完整 CDP 支持;`--browser <chrome |
| v2.5.3 | /new 支持 POST body 传 URL,规避 & 引发的参数截断 |
| v2.5.4 | 全新 tab 能力(about:blank 参数);readinessState 静默退出 |
6、横向对比
同类"给 Agent 联网能力"的方案各有侧重,选型看需求:
| 方案 | 形态 | 优势 | 局限 |
|---|---|---|---|
| web-access | Claude Code Skill | CDP 直连本地登录态、三层调度、零额外服务 | 强绑定本地浏览器,云端跑不了 |
| Jina Reader | SaaS API | 前缀即用、无需本地环境、自带代理池 | 无交互能力,登录墙无解 |
| Browser Use | Python 库 | 完整浏览器 Agent 框架、视觉理解 | 重、需要独立安装、与 Claude Code 集成弱 |
| Firecrawl | SaaS API | 整站爬取、结构化提取 | 商业付费、无登录态复用 |
选型建议:
- 已用 Claude Code、要访问登录墙后的内容 → web-access
- 只需把公开网页变 Markdown → Jina Reader
- 要独立构建浏览器自动化 Agent → Browser Use
- 组合玩法:web-access 日常用,重爬取任务交给 Jina 或 Firecrawl
7、总结
web-access 用一份 SKILL.md 加一组 Node 脚本,把"轻量抓取、浏览器操控、并行分治"三层联网能力装进 Claude Code:第一层 curl / Jina 兜底快速通道,第二层 CDP 直连本地 Chrome / Edge 复用登录态,第三层 find-urls 域名分桶并行。CDP Proxy 暴露为纯 HTTP API(打开 / 点击 / 上传 / 截图 / 滚动),curl 即可驱动;反爬走域名熔断与 tab 级代理池;v2.5.4 的"全新 tab"补上了纯净测试场景。
它适合在本地把 Claude Code 当主力开发助手的场景——尤其是需要 Agent 访问登录墙后内容(内部系统、付费文档、个人账号数据)的时候,这是目前同类方案里最顺手的路径。需要注意的是:仓库无 LICENSE 文件(README 自述 MIT,商用前以仓库原文为准);CDP 直连意味着 Agent 拥有你浏览器的全部权限,敏感账号环境请谨慎评估;云端 CI 场景没有本地浏览器,此路不通。对于日常重度 Claude Code 用户,装上它再配合 Jina 兜底,基本能覆盖绝大多数联网调研需求。

