+1
Daily
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-urTop issues
#33基于 Chromium 的 ARC 浏览器,在打开 remote-debugging 时没有弹窗3 comments · 2026-03-30#58与ccr端口冲突,该如何解决呢?2 comments · 2026-04-15#54CDP代理正常,但是访问 arm.com 触发了网络代理限制。3 comments · 2026-04-10#129Windows + Edge 环境使用反馈:Proxy 稳定性 / API 功能补充 / 路径兼容1 comments · 2026-06-10#117帮 web-access 做了在线试玩入口——粉丝点链接就能直接让 Agent 联网抓页面1 comments · 2026-05-24#40boss直聘怎么访问2 comments · 2026-04-02#109macbook 调用skill的时候工具报错,导致大模型超时0 comments · 2026-05-09#53CDP Proxy fails to connect in WSL2: missing UUID in WebSocket path1 comments · 2026-04-09
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 只进入认出的文件夹确认,再询问用户。 -