Web Access是什么
Web Access 是开发者一泽 Eze开源的 Agent Skill,专为 Claude Code、Cursor、Gemini CLI、Codex CLI 等支持 SKILL.md 的 Agent 框架设计。通过联网策略 + CDP 浏览器操作 + 站点经验积累三层架构,彻底解决传统 Agent 联网能力弱、浏览器自动化差、无法处理登录态等痛点,让 Agent 像真人一样思考如何上网,支持同时操作 100+ 网页并发执行,所有操作在后台 Tab 完成,不干扰用户当前工作。
Web Access的主要功能
-
联网工具自动选择:WebSearch / WebFetch / curl / Jina / CDP,按场景自主判断,可任意组合。
-
CDP Proxy 浏览器操作:直连用户日常 Chrome,天然携带登录态,支持动态页面、交互操作、视频截帧。
-
三种点击方式:
/click(JS click)、/clickAt(CDP 真实鼠标事件)、/setFiles(文件上传)。 -
本地 Chrome 书签/历史检索:
find-url.mjs按关键词/时间窗/访问频度定位 URL,可查找公网搜不到的内部系统。 -
并行分治:多目标时分发子 Agent 并行执行,共享一个 Proxy,tab 级隔离。
-
站点经验积累:按域名存储操作经验(URL 模式、平台特征、已知陷阱),跨 session 复用。
-
媒体提取:从 DOM 直取图片/视频 URL,或对视频任意时间点截帧分析。
-
DOM 边界穿透:eval 递归遍历可穿透 Shadow DOM、iframe 等选择器不可跨越的边界。
如何使用Web Access
-
环境准备:确保系统已安装 Node.js 22+(低于 22 需额外安装
ws模块)和 Chrome 浏览器。 -
开启 Chrome 远程调试:在 Chrome 地址栏输入
chrome://inspect/#remote-debugging,勾选 “Allow remote debugging for this browser instance”,必要时重启浏览器。 -
一键安装(推荐):在终端执行
npx skills add eze-is/web-access,skills CLI 会自动检测 Agent 环境并安装到正确位置。 -
Agent 自动安装:直接向 Agent 发送指令
帮我安装这个 skill:https://github.com/eze-is/web-access。 -
Plugin 安装(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。 -
环境自检:Agent 运行时会自动调用
scripts/check-deps.mjs完成前置检查,无需手动执行;如需手动验证,可运行node "${CLAUDE_SKILL_DIR}/scripts/check-deps.mjs"。 -
激活使用:安装后输入
遵循 web-access skill或直接下发联网任务,如”帮我搜索 xxx 最新进展”、”去小红书搜索 xxx 的账号”。 -
CDP Proxy 自动管理:Agent 会自动管理 Proxy 生命周期,通过 WebSocket 直连 Chrome,提供 HTTP API 供页面操作(新建 tab、执行 JS、点击、截图、滚动等)。
-
并行分治使用:多目标调研时,Agent 会自动分发子 Agent 并行执行,共享一个 Proxy,tab 级隔离,主 Agent 只接收汇总结果。
-
关闭其他浏览器 MCP:建议关闭 Chrome Devtools、Playwright MCP 等其他浏览器 MCP 服务,避免模型”左右互搏”。
-
社媒操作风险提示:通过浏览器自动化操作社交平台(如小红书、微博)存在账号被限流或封禁的风险,强烈建议使用小号进行操作。
Web Access的官网地址
- 官网地址:https://web-access.eze.is/
- Github仓库:https://github.com/eze-is/web-access
Web Access的关键信息和使用要求
-
Node.js 22+ 为硬性要求,环境检查脚本位于
scripts/check-deps.mjs -
Chrome 必须开启远程调试:
chrome://inspect/#remote-debugging中勾选允许远程调试 -
建议关闭其他浏览器 MCP 服务(如 Playwright MCP、Chrome Devtools MCP),避免模型”左右互搏”
-
Proxy 自动管理生命周期:通过
/new创建的 tab 闲置 15 分钟后自动关闭,可通过环境变量CDP_TAB_IDLE_TIMEOUT调整 -
社媒操作风险提示:通过浏览器自动化操作社交平台存在账号被限流或封禁的风险,强烈建议使用小号
-
安装路径:Claude Code 默认位于
~/.claude/skills/web-access,环境变量CLAUDE_SKILL_DIR由 skill 加载时自动设置
Web Access的核心优势
-
自带登录态:复用用户日常 Chrome 的 Cookie,无需额外配置即可访问小红书、微博等需登录平台。
-
后台无干扰:所有操作在后台 Tab 进行,不抢夺屏幕焦点,用户可正常使用浏览器。
-
并发能力极强:支持同时操作 100+ 网页,10 个子 Agent 并行调研不同平台。
-
越用越聪明:站点经验自动沉淀,下次访问直接复用验证有效的 URL 模式与交互逻辑。
-
社媒自动化:支持自动打开平台、填写文案、上传图片、点击发布。
-
跨平台兼容:Windows / Linux / macOS 均可使用(v2.4.1+ 脚本已迁移至 Node.js)。
Web Access的应用场景
-
多平台舆情调研:10 个子 Agent 同时调研小红书、微博、B 站、Boss 直聘、GitHub 等平台,每个开 10 个 Tab 并行抓取今日热点并汇总报告。
-
登录态内容获取:复用已登录的小红书/微博账号,直接站内搜索、滚动加载、提取帖子正文与评论区内容。
-
信息真实性核实:绕过二手报道,直接访问官网/官方平台原文,避免循环印证假象。
-
自动化社媒发布:自动打开平台网页、填文案、传图、点击发布(需注意平台风控)。
-
内部系统检索:通过本地 Chrome 历史/书签查找公网搜不到的内部平台或之前访问过的页面。
-
Web 自动化测试:支持操作视频元素、表单填写、人机验证处理、视频任意时间点截帧。
Web Access的常见问题
Q:Web Access 支持哪些 Agent 框架?
A:兼容所有支持
A:兼容所有支持
SKILL.md 的 Agent,包括 Claude Code、Cursor、Gemini CLI、Codex CLI 等。
Q:为什么需要 Chrome 远程调试,不能直接 headless 吗?
A:通过 Chrome DevTools Protocol 连接用户日常浏览器,天然携带 Cookie 和登录态,可处理需要登录的动态页面(如小红书、微博),且所有操作在后台 Tab 进行,不抢夺屏幕焦点。
A:通过 Chrome DevTools Protocol 连接用户日常浏览器,天然携带 Cookie 和登录态,可处理需要登录的动态页面(如小红书、微博),且所有操作在后台 Tab 进行,不抢夺屏幕焦点。
Q:同时操作 100 个网页会卡吗?
A:所有操作在后台 Tab 进行,不干扰前台使用。Proxy 会自动追踪通过
A:所有操作在后台 Tab 进行,不干扰前台使用。Proxy 会自动追踪通过
/new 创建的 tab,闲置 15 分钟后自动关闭,防止留下孤儿 tab。
Q:站点经验是如何存储和复用的?
A:按域名自动保存验证有效的 URL 模式、平台特征、已知陷阱、交互逻辑等,跨 session 复用,实现「越用越顺」的学习循环。
A:按域名自动保存验证有效的 URL 模式、平台特征、已知陷阱、交互逻辑等,跨 session 复用,实现「越用越顺」的学习循环。
Q:Windows 系统能用吗?
A:v2.4.1 起已全面支持跨平台,脚本从 bash 迁移到 Node.js,Windows / Linux / macOS 均可使用。v2.4.3 还修复了 Windows Git Bash 的路径转换错误。
A:v2.4.1 起已全面支持跨平台,脚本从 bash 迁移到 Node.js,Windows / Linux / macOS 均可使用。v2.4.3 还修复了 Windows Git Bash 的路径转换错误。
Q:如何检索本地 Chrome 书签和历史记录?
A:v2.5.0 新增
A:v2.5.0 新增
scripts/find-url.mjs,支持按关键词、时间窗、访问频度排序,典型场景包括查找组织内部系统(公网搜不到的目标)或回查之前访问过但不记得地址的页面。
Q:CDP Proxy 提供哪些 API 端点?
A:主要端点包括:
A:主要端点包括:
/new(新建 tab)、/eval(执行 JS)、/click(JS 点击)、/clickAt(真实鼠标点击)、/setFiles(文件上传)、/screenshot(截图)、/scroll(滚动)、/close(关闭 tab)、/health(状态检查)。