插件与Skills

Web Access

Web Access是什么 Web Access...

标签:

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:兼容所有支持 SKILL.md 的 Agent,包括 Claude Code、Cursor、Gemini CLI、Codex CLI 等。


Q:为什么需要 Chrome 远程调试,不能直接 headless 吗?
A:通过 Chrome DevTools Protocol 连接用户日常浏览器,天然携带 Cookie 和登录态,可处理需要登录的动态页面(如小红书、微博),且所有操作在后台 Tab 进行,不抢夺屏幕焦点。


Q:同时操作 100 个网页会卡吗?
A:所有操作在后台 Tab 进行,不干扰前台使用。Proxy 会自动追踪通过 /new 创建的 tab,闲置 15 分钟后自动关闭,防止留下孤儿 tab。


Q:站点经验是如何存储和复用的?
A:按域名自动保存验证有效的 URL 模式、平台特征、已知陷阱、交互逻辑等,跨 session 复用,实现「越用越顺」的学习循环。


Q:Windows 系统能用吗?
A:v2.4.1 起已全面支持跨平台,脚本从 bash 迁移到 Node.js,Windows / Linux / macOS 均可使用。v2.4.3 还修复了 Windows Git Bash 的路径转换错误。


Q:如何检索本地 Chrome 书签和历史记录?
A:v2.5.0 新增 scripts/find-url.mjs,支持按关键词、时间窗、访问频度排序,典型场景包括查找组织内部系统(公网搜不到的目标)或回查之前访问过但不记得地址的页面。


Q:CDP Proxy 提供哪些 API 端点?
A:主要端点包括:/new(新建 tab)、/eval(执行 JS)、/click(JS 点击)、/clickAt(真实鼠标点击)、/setFiles(文件上传)、/screenshot(截图)、/scroll(滚动)、/close(关闭 tab)、/health(状态检查)。

相关导航