技能包

web-access:给支持 SKILL.md 的 Agent 补上联网策略和 CDP

适合要让 Agent 按场景选择联网方式或用浏览器调试协议操作页面的人,但 CDP 需要 Node.js 22+ 以及 Chrome 或 Edge 开启远程调试。

官方来源 · web-access

安装

npx skills add eze-is/web-access

适合谁

如果你发现 Agent 自带的 WebSearch、WebFetch 缺少调度策略,也没有浏览器自动化,这个 Agent Skill 更合适。它补上的是联网策略、CDP 浏览器操作,以及站点经验积累。页面写到它兼容所有支持 SKILL.md 的 Agent,并举例了若干产品,后面还有「等」,所以不要把举例理解成封闭名单。

只用文本搜索、不打算开远程调试的人,可以先把它当策略层来用。一旦要走 CDP,必须满足:Node.js 22+,以及 Chrome 或 Edge 已打开远程调试。只想给浏览器装扩展、并不使用 SKILL.md Agent 的人,这不是给你的。

3 分钟完成第一次尝试

官方安装命令按页面写成这一条:

npx skills add eze-is/web-access

它会把技能写入当前支持 SKILL.md 的 Agent。先确认本机有 npx,并且这是你要改的环境,再执行。不要并列另一套安装器。

装好后先做只读联网,不要一上来控制浏览器。让 Agent 针对一个你指定的公开资料做检索或抓取,并让它说明这次选了 WebSearch、WebFetch、curl、Jina 还是组合。成功信号是:它能说出选择理由并返回页面内容,而不是提示技能未安装。到这里就停。

只有在只读通道不够、你明确要操作已打开的页面时,再进入 CDP。先在本机打开:

chrome://inspect/#remote-debugging

或

edge://inspect/#remote-debugging

确认远程调试已开,再允许 Agent 通过 CDP 操作。这会控制你的真实浏览器,运行前必须确认窗口和站点就是你要用的那一个。

使用案例

案例一:让技能按场景挑选联网工具。表格把能力写成:WebSearch / WebFetch / curl / Jina / CDP,按场景自主判断,可任意组合。任务应是「查这个问题,并告诉我用了哪几种通道」。摘录没有写选择规则,也没有写 Jina 是否要额外密钥。因此你能确认的是:这五种名字会被纳入调度;具体何时选谁,以实际运行为准。Agent 若直接打开 CDP 去点页面,就已经超出这次只读任务。

案例二:用 CDP 操作已调试的浏览器。前置是 Node.js 22+,以及 Chrome / Edge 远程调试页已打开。用途是浏览器自动化,而不是再做一次普通搜索。摘录没有写可点击选择器、截图命令或如何结束调试会话。所以第一次只要求一个可逆的只读动作(例如查看当前页),并事先确认调试目标。站点经验积累被写成能力,但没有说明存哪里、怎么清;不要让 Agent 把未说明的记忆机制当成已经配置好的数据库。

使用边界

CDP 模式绑定 Node.js 22+ 和 Chrome/Edge 远程调试。版本不够或 inspect 页未开,不要假定浏览器自动化可用。普通 WebSearch / WebFetch 不自动等于已经具备 CDP。

安装路径就是 npx skills add eze-is/web-access。不要再写第二条安装命令。客户端举例不是授权清单。

第一次停在只读检索或抓取。任何 CDP 点击、表单提交、登录,或写入站点经验的动作,都要先让 Agent 复述将操作的窗口和步骤,你确认后再继续。