工具说明：web-access

1. 项目介绍

它是什么。 web-access 是一个 Skill：一份 SKILL.md 加几个 Node.js 脚本，教智能体在联网任务里选工具。简单的用搜索、网页读取和 curl（静态层），读不到或要登录的，就通过本机一个小服务去操作你日常在用的那个 Chrome（浏览器层），带着你已有的登录状态。

CDP Proxy 是 web-access 自带的一个本机小服务，它通过 Chrome DevTools Protocol（浏览器提供的远程控制接口）替智能体操作浏览器。

核心能力：

• 按任务选静态层或浏览器层，先用省事的办法；
• 经 CDP Proxy 操作日常浏览器，带已有登录态打开、点击、读取页面；
• v2.6.0 起支持 Chrome、Edge 等任意 Chromium 内核浏览器，能读跨站 iframe（嵌在页面里的另一个网站的页面）；
• 读取本地浏览器书签和历史记录找网址（v2.5.0 起）。

在同类工具里的位置： Playwright MCP、agent-browser 另开一个干净浏览器，web-access 接管你正在用的浏览器，方便的同时，风险也落在你的真实账号上（第 4 节）。

国内网络： 官网能打开；GitHub 能下载但慢。静态层里的 Jina Reader 和 Claude Code 自带的 WebFetch 在国内网络下不可用，静态层能用的是 curl 和 DeepSeek 搜索与读取。

两层的分工：

2. 官方链接与版本

核查日期：2026-10。

版本：

3. 能做什么、不能做什么

能做：

• 按任务自己选工具：先搜索找来源，再用网页读取或 curl 读原文，读不到再进浏览器。SKILL.md 里强调“一手信息优于二手信息”，核实类任务要找发布机构官网原文。
• 浏览器层能打开新的后台标签页、执行页面脚本读页面内容、点击、滚动触发懒加载、截图、上传文件、对视频截帧；v2.6 能读跨站 iframe。
• 按域名记“站点经验”（URL 规律、反爬特点、已知陷阱），下次复用。v2.4.3 存在技能目录 references/site-patterns/，v2.6 存在 ~/.web-access/site-patterns/。
• 多个子智能体共用一个 Proxy，各开各的标签页并行抓取。
• v2.5 起能查你本地浏览器的书签和历史记录（find-url.mjs），用来找“我上次看过的那篇”或校内系统网址。

不能做或做不好：

• 不处理验证码、扫码登录、短信验证，这些要你自己在浏览器里完成。
• 不保证账号安全。SKILL.md 要求智能体在操作前先展示一句须知，说明存在账号封禁风险，智能体继续操作即视为你接受。
• 静态层不带登录态；能不能用 WebSearch 取决于你的客户端和模型服务商。Jina 和 Claude Code 的 WebFetch 国内网络下连不上，SKILL.md 里写到它们的步骤会失败，要在提示词里写明“不要用 WebFetch 和 r.jina.ai”。
• 它不是独立程序，效果取决于模型能不能读懂 SKILL.md 里的“浏览哲学”。接 DeepSeek 等国内模型时，如果它选错工具，就在提示词里写明这一步用什么。

适合本课的任务： 读公开但难抓的政府、交易所、央行页面，读动态渲染的财经数据页，把一组公开文章存成 Markdown。不建议用来操作社交平台账号、批量抓取、替你发帖。

4. 与“另开干净浏览器”的工具有什么不同

Playwright MCP 也能用 --cdp-endpoint 或 --extension 接已开着的浏览器，那时风险与 web-access 同类：它能碰到那个浏览器里所有的登录。

5. 安装与配置

5.0 先决定要不要装

web-access 自己的说明写着有封号风险，本课不强推。不装它，用 DeepSeek Fetch（Claude Code、WorkBuddy 都可）、WorkBuddy 自带的网页读取、Playwright MCP 或 agent-browser 也能完成本课的网页读取任务。Claude Code 自带的 WebFetch 国内网络下不可用，不在此列。

如果要装，建议分两步：

1. 只装技能文件、不开远程调试：静态层里的 curl 可以用，浏览器层连不上就会停下来报错，不会碰你的浏览器。
2. 确实需要读登录后的页面时，再开远程调试；开之前看完第 8 节。

5.1 前置依赖

WorkBuddy 可能自带一份 Node.js。它执行命令时用的是哪个版本，以在 WorkBuddy 里让它运行 node --version 的结果为准。

5.2 首选：交给智能体装技能文件

这一步只是把文件放到对的目录，可以让智能体做。打开远程调试开关、在浏览器弹窗里点“允许”不能交给它，见 5.3。

Claude Code 端（在你的课程项目文件夹里打开 Claude Code，粘贴）：

帮我安装 web-access 技能，只装文件，不要运行它。
1. 来源：https://github.com/eze-is/web-access ，用发布版 v2.6.0（git clone --branch v2.6.0 --depth 1）。没有 git 就从 Releases 页下载 v2.6.0 的源码压缩包解压。
   GitHub 在国内访问慢、时好时坏，clone 超时就重试一次或改下载压缩包；不要自己找 Gitee 或其他镜像地址，找不到就停下来告诉我。
2. 装到当前项目的 .claude/skills/web-access/ 下（项目级），不要装到用户目录 ~/.claude/skills/，不要用 npx skills add，不要用 claude plugin install。
3. 装完后打开 .claude/skills/web-access/SKILL.md，把开头 description 里“所有联网操作必须通过此 skill 处理”这一句改成“只有当我明确说‘用 web-access’时才使用此 skill”，其余内容不改。把改动给我看。
4. 自查：运行 node --version，告诉我是否 ≥ 22；列出 .claude/skills/web-access/ 下的文件；读出 SKILL.md 里的 version。
5. 不要运行 check-deps.mjs、cdp-proxy.mjs 或任何连接浏览器的命令，不要打开浏览器，不要改浏览器设置。
6. 需要装 Node.js、需要联网下载以外的权限、或者遇到报错时，停下来问我。

WorkBuddy 端（在 WorkBuddy 里选中你的工作空间文件夹，粘贴）：

帮我把 web-access 技能装进当前工作空间，只装文件，不要运行它。
1. 来源：https://github.com/eze-is/web-access ，发布版 v2.6.0。
2. 放到当前工作空间的 .workbuddy/skills/web-access/ 下，保留它的 README.md、SKILL.md、scripts/、references/、templates/。不要放到用户级技能目录。
   GitHub 在国内访问慢，下载失败就重试一次；不要自己找其他镜像地址。
3. 把 SKILL.md 开头 description 里“所有联网操作必须通过此 skill 处理”改成“只有当我明确说‘用 web-access’时才使用此 skill”，改动给我看。
4. 运行 node --version 告诉我版本。
5. 不要运行 check-deps.mjs、cdp-proxy.mjs，不要打开浏览器。遇到要装软件、要权限或报错就停下来问我。

装的过程中它会请求的权限：

5.3 要你亲手做的部分

Windows 上打开开关：

• Chrome：地址栏输入 chrome://inspect/#remote-debugging，勾选 Allow remote debugging for this browser instance，按提示重启浏览器。
• Edge：地址栏输入 edge://inspect/#remote-debugging，勾选同名选项。web-access 要 v2.5.2 以上才认 Edge；用 v2.4.3 等旧版、电脑上只有 Edge 的，会报“chrome: not connected”。
• 不要按旧教程用 chrome.exe --remote-debugging-port=9222 启动：v2.6 不再扫描固定端口，这种方式不在支持范围内（v2.6.0 发布说明）。

建议的隔离做法： v2.6 支持任意 Chromium 浏览器。可以把一个平时不用的浏览器（例如日常用 Chrome，就把 Windows 自带的 Edge 留给智能体）只用于智能体任务，里面只登录小号或不登录，只在这个浏览器里打开远程调试开关。首次运行时智能体会列出本机浏览器、问你用哪个，写进 ~/.web-access/config.env 的 WEB_ACCESS_BROWSER。开关对整个浏览器实例生效，同一个浏览器里换“个人资料”不起隔离作用（同一用户数据目录）。

macOS：Chrome 同样在 chrome://inspect/#remote-debugging 勾选；首次连接时浏览器会弹授权框。

5.4 参考：手动安装命令

Claude Code，Windows 11（PowerShell，在项目文件夹里运行）：

git clone --branch v2.6.0 --depth 1 https://github.com/eze-is/web-access .claude\skills\web-access
node --version

GitHub 在国内能连上但慢，失败时重试；或在浏览器打开 https://github.com/eze-is/web-access/releases/tag/v2.6.0 下载 Source code (zip)，解压后把文件夹改名为 web-access 放进 .claude\skills\。不要用来源不明的镜像。

Claude Code，macOS：

git clone --branch v2.6.0 --depth 1 https://github.com/eze-is/web-access .claude/skills/web-access
node --version

上游 README 还给了三种方式，本课不推荐：

WorkBuddy： 把整个 web-access 文件夹复制到 <工作空间>\.workbuddy\skills\web-access\。WorkBuddy 的项目技能读 .workbuddy/skills/，不读 .claude/skills/。也可以用 WorkBuddy 技能市场的“上传技能包”。

项目级＋规则文件加一道同意： 技能放在项目级目录（工作空间选到这一层就能用），再在工作空间根目录的 AGENTS.md（Claude Code 用 CLAUDE.md）写一句：

读网页链接，先用 WorkBuddy 自带的网页读取。读不到正文就告诉我，我同意了再用 web-access。

这样默认用自带的网页读取，不用 web-access 也能做完任务。要更新版本时，替换整个文件夹为 v2.6.0。

5.5 SKILL.md 描述“接管联网任务”的影响

上游 SKILL.md 的 description（v2.4.3 与 v2.6.0 相同）第一句是：

所有联网操作必须通过此 skill 处理，包括：搜索、网页抓取、登录后操作、网络交互等。

Claude Code 和 WorkBuddy 都按 description 决定什么时候加载技能。这一句的后果：

• 装在哪一层，那一层里任何带“查、搜、看网页”的请求都可能先加载它。装在用户级 ~/.claude/skills/ 就影响你所有项目。
• 加载后 SKILL.md 第一步要求运行 check-deps.mjs。这个脚本在 Proxy 没运行时会在后台启动 Proxy 并连接浏览器。也就是说，你只想查一条 CPI 新闻，它也可能先去连你的 Chrome。浏览器没开远程调试时脚本报错退出，不会连上。
• 它和其他联网技能、MCP（Tavily、Playwright 等）抢任务，你看到的工具调用可能和预期不同。

处理办法（任选，前两条在 5.2 的提示词里已经包含）：

1. 装在项目级，不装用户级。
2. 改 description，例如改成“只有当我明确说‘用 web-access’时才使用此 skill”。改的是你本地的副本，升级时要重改。
3. Claude Code 可以在 SKILL.md 的 frontmatter（文件开头两行 --- 之间的设置区）加一行 disable-model-invocation: true，模型就不会自动加载，只能你输入 /web-access 调用。WorkBuddy 用第 2 条。
4. 在 AGENTS.md 或 CLAUDE.md 里写“读不到再问我，我同意了再用 web-access”（见 5.4）。

5.6 怎样确认装好了

6. 使用教程：读人民银行最新 LPR 公告

选这个例子：公开信息、不需要登录，人民银行网站对直接请求常返回脚本校验页，静态层可能读不到正文，正好看两层怎么切换。

第一步：只用静态层。 粘贴：

用 web-access。找中国人民银行最近一期贷款市场报价利率（LPR）公告，先只用搜索和 curl，不要连接浏览器。
不要用 WebFetch 和 r.jina.ai（国内网络连不上）；装了 deepseek-web 技能的，可以用它的 search 和 fetch。
要求：
1. 给出公告标题、发布日期、1 年期和 5 年期以上 LPR 数值、公告原文链接（人民银行官网 pbc.gov.cn 的页面，不用新闻转载）。
2. 正文照原文摘录，不改写。
3. 存成 LPR_最新公告.md，开头写取得日期和来源链接。
4. 读不到官网原文就停下来告诉我读到了什么，不要换别的来源顶替。

deepseek-web 技能的装法见 DeepSeek 搜索与读取。

预期看到的工具调用：WebSearch（或 deepseek-web 的 search）搜“LPR 公告 中国人民银行”→ curl（或 deepseek-web 的 fetch）读 pbc.gov.cn 页面。读到了就写文件；读不到会报告返回的是校验页或空壳，这时进入第二步。如果它仍去调 WebFetch 或 r.jina.ai，会失败或超时，提醒它按提示词换 curl。

第二步（可选，需要已开远程调试）：允许用浏览器层。

刚才读不到原文。这次允许你用 web-access 的浏览器模式：
1. 先运行前置检查，把它要求展示的提示原样给我看，等我回复“继续”。
2. 只在你自己新建的后台标签页里操作，不要动我已经打开的标签页，不要登录任何网站。
3. 只读这一个公告页，读完关闭你建的标签页。
4. 其余要求同上。

预期看到的工具调用：

node ".../scripts/check-deps.mjs"                         前置检查，必要时后台启动 Proxy
curl -s -X POST --data-raw '公告网址' http://localhost:3456/new      新建后台标签页
curl -s -X POST "http://localhost:3456/eval?target=ID" -d '...'     读页面正文
curl -s "http://localhost:3456/close?target=ID"                     关闭标签页

浏览器可能弹出“允许远程调试”的授权框，由你点允许。v2.4.3 的 /new 用 ?url= 传网址，v2.6 改为 POST 传网址，两种写法都正常。

产出： LPR_最新公告.md。

验收：

1. 打开文件里的链接，确认是 pbc.gov.cn 的公告页，不是新闻网站。
2. 对照页面核对日期和两个数值。
3. 摘录文字与页面一致，没有被改写成摘要。
4. 浏览器里没有多出未关闭的标签页，你原来的标签页没被改动。

7. 常见问题与排错

8. 费用、隐私与安全

8.1 费用

• web-access 本身免费（README 标 MIT）。
• 模型调用费用照常计入你的 DeepSeek 等套餐；浏览器层把网页内容读回来交给模型，长页面消耗的 token 不少。
• Jina 免费使用有 20 次／分钟限制（SKILL.md 原文）；通过 Jina 读网页，等于把网址交给第三方服务器去取。国内网络连不上 Jina，本课不用。

8.2 封号风险

• SKILL.md 规定操作前要展示一句须知：部分站点对浏览器自动化检测严格，存在账号封禁风险，内置防护无法完全避免，继续操作即视为接受。README 建议操作社交平台时使用小号。
• “内置防护”的一部分是：Proxy 在页面里拦截网页对本机调试端口的探测，让网站更难发现浏览器被自动化（cdp-proxy.mjs 里这段代码的注释写“反风控”）。这降低被发现的概率，不改变平台规则：多数平台的用户协议禁止自动化抓取，被识别时封的是你登录在这个浏览器里的号。
• 短时间密集开很多页面更容易触发风控（SKILL.md 原文）。

8.3 隐私：模型能触达你登录过的所有网站

• 浏览器层连上后，智能体执行的 JavaScript 可以读写任一标签页的页面内容、提交表单、上传本机文件（/setFiles）、截图。你登录着的邮箱、网银网页版、教务系统、微信网页版都在它能到的范围内。SKILL.md 要求它只在自己建的标签页操作，但这是写给模型的约束，不是技术隔离。
• 页面内容会作为上下文发给模型服务商（经 CC Switch 接的 DeepSeek 等）。别让它打开含个人信息、成绩、财务信息的页面。
• v2.5 起的 find-url.mjs 会读本地浏览器书签和历史记录。
• 站点经验文件可能记下 URL 和平台细节；分享工作空间或打包材料前检查 references/site-patterns/（v2.4.3）或 ~/.web-access/site-patterns/（v2.6），不要把 config.env 和浏览器用户目录打进包里。
• Proxy 监听 127.0.0.1:3456，除维护用的 /shutdown 外各接口没有身份校验。Proxy 运行期间，本机任何程序都能通过它操作你的浏览器。Proxy 没有空闲自动退出，会一直运行到你停掉它。

8.4 用完怎样收回权限

1. 停 Proxy：v2.6 运行 node "<技能目录>/scripts/proxy-maintenance.mjs" stop；v2.4.3 在 macOS 运行 pkill -f cdp-proxy.mjs，Windows 在任务管理器结束对应的 node.exe。
2. 回到 chrome://inspect/#remote-debugging（或 edge://inspect/#remote-debugging）取消勾选。
3. 不用时把技能文件夹移出 .claude/skills/ 或 .workbuddy/skills/。

8.5 截图与共享

浏览器层的截图存在你电脑的临时目录里，可能拍到你的账号名和页面内容，分享给别人前看一遍。录屏演示时用不登录任何账号的浏览器。

9. 与同类工具的一句对比

Playwright MCP 和 agent-browser 默认另开一个干净浏览器、风险局限在那个窗口；web-access 直接借你日常浏览器的登录态，能进的网站更多，出事时牵连的账号也更多；Claude in Chrome 等浏览器扩展同属“接日常浏览器”一类，它要 Anthropic 账号，且 Chrome 应用店国内连不上，本课不推荐。Windows 上要用浏览器扩展类工具时改装 Edge 扩展，Edge 加载项商店国内能打开。

相关说明：DeepSeek 搜索与读取、Playwright MCP、agent-browser。

10. 参考链接