eze-is /web-access

给你的本机 Agent(如 Claude Code、Grok Bot 等)装上完整联网能力的 Skill:三层通道调度 + 浏览器 CDP + 并行分治,自动积累站点经验,不断优化联网效率

★ 9,417⑂ 664👁 17⑃ 66● 65▤ 3
JavaScriptCreated 2026-03-18
下载:v2.6.0v2.6.0 ↓2.6.02026-10-14
+1
日增长
9,417
stars
664
forks
17
watchers
66
prs
65
issues
3
releases

README

🌐 Language
    
      
        English
        | 简体中文
        | 繁體中文
        | 日本語
        | 한국어
        | Français
        | Deutsch
        | Español
        | Português
        | Русский
      
    
  





  给 AI Agent 装上完整联网能力的 Skill。
  🌐 官网 · 📖 设计详解 · ⚡ 快速安装


AI Agent 原本的联网能力(WebSearch、WebFetch)缺少调度策略和浏览器自动化能力。这个 Agent Skill 补上的是:联网策略 + CDP 浏览器操作 + 站点经验积累。兼容所有支持 SKILL.md 的 Agent(Claude Code、Cursor、Gemini CLI、Codex CLI 等)。

 推荐必读:Web Access:一个 Skill,拉满 Agent 联网和浏览器能力 ,完整介绍了 Web-Access Skill 的开发细节与 Agent Skill 设计哲学,帮助你也能写出类似通用、高上限的 Skill


 [!IMPORTANT]
 从旧版本升级到 v2.6 之前,请把下面这段话发给你的 Agent(浏览器偏好和站点经验从 v2.6 起改放在 ~/.web-access/,npx skills update 会先删除旧目录,不先搬就会丢):

 text
 我要把 web-access 升级到 v2.6。升级前请先迁移我的数据:找到当前 web-access skill 的安装目录,把其中的 config.env 复制到 ~/.web-access/config.env,把 references/site-patterns/ 整个文件夹(含子文件夹)复制到 ~/.web-access/site-patterns/(Windows 上 ~ 指 %USERPROFILE%),已存在的文件不要覆盖;确认复制成功后再按 https://github.com/eze-is/web-access 的说明升级,升级后运行一次 check-deps.mjs,确认浏览器配置和站点经验都还在。
 

 用 git 或 Claude Code 插件安装的,升级后也会自动迁移;照着这段话做一遍同样安全(只复制、不覆盖)。详见 references/migration-2.6.md。

---

 v2.6.0 能力

| 能力 | 说明 |
|------|------|
| 联网工具自动选择 | WebSearch / WebFetch / curl / Jina / CDP,按场景自主判断,可任意组合 |
| CDP Proxy 浏览器操作 | 直连用户日常浏览器(Chrome / Edge / Brave / Arc / Dia 等任意 Chromium 内核浏览器),天然携带登录态,支持动态页面、交互操作、视频截帧 |
| 点击与 iframe | /click(JS click)、/clickAt(CDP 真实鼠标事件)、/clickXY(坐标点击,可点进跨站 iframe、不激活标签页)、/setFiles(文件上传);/frames + /eval?frame= 读取跨站 iframe 内容 |
| 本地浏览器书签/历史检索 | find-url.mjs 跨 Chrome / Edge 查询公网搜不到的目标(内部系统)或用户访问过的页面,支持关键词/时间窗/访问频度排序 |
| 并行分治 | 多目标时分发子 Agent 并行执行,共享一个 Proxy,tab 级隔离 |
| 站点经验积累 | 按域名存储操作经验(URL 模式、平台特征、已知陷阱),跨 session 复用 |
| 媒体提取 | 从 DOM 直取图片/视频 URL,或对视频任意时间点截帧分析 |

v2.6.0 更新:
- 升级必读:用户数据移到 ~/.web-access/ — 浏览器偏好和站点经验不再放在 Skill 目录里,之后任何方式升级都不会被覆盖。用 npx skills 从旧版本升级的,升级前按 references/migration-2.6.md 先备份;git 与 Claude Code 插件安装会自动迁移
- 任意 Chromium 内核浏览器可用 — WEB_ACCESS_BROWSER 改填浏览器的用户数据目录,Brave、Arc、Dia、Vivaldi、Opera 等都能用;旧值 chrome / edge 继续有效。首次配置时 Agent 只看应用数据目录最外层的文件夹名认出浏览器,再用 browser-probe.mjs 只进入认出的文件夹确认(思路来自 173,感谢 @zhangweijian97)
- 跨站 iframe — GET /frames 列出页面 iframe,/eval?frame= 在其中执行;GET /clickXY 按坐标真实点击,可点中跨站 iframe 且不激活标签页
- 不再扫描 9222 等固定端口;/health 的 browser.id 改为数据目录真实路径
- 修复 — proxy-maintenance.mjs stop/restart 对真实服务报错、restart 不拉起新服务;并发维护误报;探测遇到无权限目录崩溃;迁移失败重试丢偏好

v2.5.4 更新

- 修复新标签页空白竞态 — /new 先创建 about:blank 并完成 CDP attach,再显式导航;不再把浏览器初始空白文档误判为目标页面
- 目标内容就绪契约 — 导航成功或 readyState 完成不等于任务完成;遇到验证页、登录跳转和异步渲染时继续观察,直到目标内容出现或确认受阻
- 完整 URL 安全传输 — /new 和 /navigate 从 v2.5.3 起使用 POST body 传 URL,查询参数中的 & 不再被错误切分


v2.5.2 更新

- Microsoft Edge 支持 — CDP Proxy 不再绑定 Chrome,新增 Edge 适配(及 Chromium、Chrome Canary 等 Chromium 系,通过同一套自动发现机制接入)。在 edge://inspect/remote-debugging 勾选 "Allow remote debugging for this browser instance" 即可
- 浏览器偏好持久化 — 新增 config.env(gitignored,首次运行从模板创建),通过 WEB_ACCESS_BROWSER 固定默认浏览器;多浏览器同时开启 toggle 时 Agent 会询问偏好。也支持单次覆盖 --browser 
- 不擅自降级 — 偏好/指定的浏览器没启动或没开 toggle 时硬错并给出明确处理步骤,不会悄悄连到别的浏览器;proxy 首次成功连接后 pin 住浏览器 id,避免运行中漂移
- find-ur

Top issues

Latest release

v2.6.0 v2.6.0 2026-10-14
升级必读

- 升级前把 README 顶部那段提示词发给你的 Agent,它会先把数据搬到 ~/.web-access/ 再升级。
- 用户数据(config.env、站点经验)移到 ~/.web-access/(Windows 为 %USERPROFILE%\.web-access\),之后任何方式升级都不会再被覆盖。
  - 用 npx skills update 升级的,升级前先备份,做法见 references/migration-2.6.md。
  - git clone 和 Claude Code 插件安装,升级后由前置检查自动复制旧数据。
- 升级后等共享服务空闲时运行一次 proxy-maintenance.mjs restart。

 任意 Chromium 内核浏览器可用

- WEB_ACCESS_BROWSER 改为填浏览器的用户数据目录,Brave、Arc、Dia、Vivaldi、Opera 等都能用。
- 旧值 chrome / chrome-canary / chromium / edge 仍然有效,老配置不用改。
- 首次配置:前置检查只列出应用数据目录最外层的文件夹名(Linux 含 ~/.config、~/snap、~/.var/app),Agent 认出浏览器后用 browser-probe.mjs 只进入认出的文件夹确认,再询问用户。
- 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON