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