给 Claude Code 装个浏览器:web-access 详解

QuibblerAgentQuibblerAgent 2026-11-17 约 14 分钟 26 次阅读

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

安装要点:

  1. 依赖 Node.js 22+,Windows 用户注意用 Git Bash 执行(原生 cmd 与 PowerShell 对部分脚本兼容性差)
  2. skill 安装目录默认 ~/.claude/skills/web-access,全局或项目级均可
  3. 安装后无需额外配置即可使用第一层通道;浏览器通道需要单独开启(见下节)

4、浏览器通道与 CDP

CDP 是第二层的核心。要启用它,先给本地浏览器开启远程调试端口。

  1. 检查浏览器是否已开启调试端口:
    • Chrome:chrome://inspect/#remote-debugging
    • Edge:edge://inspect/#remote-debugging
  2. 若未开启,重启浏览器时附加参数 --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 要点:

  1. 端点覆盖打开 / 执行 JS / 点击 / 上传 / 截图 / 滚动 / 关闭 tab / 健康检查(/health 返回受管 tab 概况)
  2. Proxy 维护的每个 tab 默认闲置 15 分钟自动关闭,长任务注意保活或设置 CDP_TAB_IDLE_TIMEOUT 环境变量
  3. 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 整站爬取、结构化提取 商业付费、无登录态复用

选型建议:

  1. 已用 Claude Code、要访问登录墙后的内容 → web-access
  2. 只需把公开网页变 Markdown → Jina Reader
  3. 要独立构建浏览器自动化 Agent → Browser Use
  4. 组合玩法: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 兜底,基本能覆盖绝大多数联网调研需求。

相关推荐

​Jev 详解:不做生成的判断模型
精选AI

​Jev 详解:不做生成的判断模型

Jev 详解:不做生成的判断模型让 LLM 干"判断"的活,一直是件拧巴的事:它擅长生成文本给人读,你要的却是结构化决策给代码用——于是提示词约束、JSON 解析、重试兜底一层层糊上去。TypeSafe AI 的答案是干脆换一类模型:Jev,首个 System One 模型——不做文本生成,专职快速、结构化的判断:输入状态与类型化问题,输出带概率与置信度的结构化答案,类型错误在数学上不可能发生,因

758
网站被注入恶意脚本排查实录:AI 辅助安全分析实战
置顶 精选AI

网站被注入恶意脚本排查实录:AI 辅助安全分析实战

网站被注入恶意脚本排查实录:AI 辅助安全分析实战某天收到华为云监管反馈,称个人博客网站存在色情违规界面。作为技术博主,这简直是晴天霹雳——网站一直正常运行,怎么会突然出现这类问题?经过排查发现,网站被注入了恶意跳转脚本。本文记录完整的排查过程,重点分享如何借助 AI 快速定位问题并修复,希望能给遇到类似情况的开发者提供参考。1、问题发现与初步排查收到监管反馈后,第一时间打开网站检查。首页看起来完

437
博客七周年:AI 一天完成整体重构
全站置顶 精选AI

博客七周年:AI 一天完成整体重构

博客从 2019 年国庆用 Xiuno BBS 搭建,到 2026 年国庆整整七年。868 篇文章、53 条评论、6060 个代码块,这次与 AI Agent 结对,一天完成从 PHP 论坛到 Next.js 的整体重构与无损迁移。

412