给 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
v2.5.2 能力
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 <chrome|edge>
不擅自降级 — 偏好/指定的浏览器没启动或没开 toggle 时硬错并给出明确处理步骤,不会悄悄连到别的浏览器;proxy 首次成功连接后 pin 住浏览器 id,避免运行中漂移
find-url 也支持 Edge — 本地书签/历史检索默认遍历 Chrome 与 Edge,可用 --browser <chrome|edge> 限定单一浏览器
本地 Chrome 资源检索 — 新增 scripts/find-url.mjs ,从本地 Chrome 书签/历史按关键词/时间窗/访问频度定位 URL。典型场景:用户提到组织内部系统("我们的 XX 平台"等公网搜不到的目标)、回查之前访问过但不记得地址的页面、查看最近高频访问网站等(场景感谢 @MVPGFC 在 #60 提出)
修复 CLAUDE_SKILL_DIR 路径问题 — bash 代码块改用 ${CLAUDE_SKILL_DIR} 字符串替换语法,修复 Windows Git Bash 路径转换错误和变量未设置问题(#47 #46)
站点经验列表合并到前置检查 — 启动检查通过后自动输出已有站点经验列表,移除不可靠的 ! 内联注入
跨平台支持 — 脚本从 bash 迁移到 Node.js,Windows / Linux / macOS 均可使用
DOM 边界穿透 — 新增技术事实:eval 递归遍历可穿透 Shadow DOM、iframe 等选择器不可跨越的边界
站点内 URL 可靠性 — 新增事实说明:站点生成的链接自带完整上下文,手动构造的 URL 可能缺失隐式必要参数
平台错误提示不可信 — 新增技术事实:平台返回的"内容不存在"等提示可能是访问方式问题而非内容本身问题
小红书站点经验增强 — xsec_token 机制、创作者平台状态校验、暂存草稿流程
浏览哲学重构 — 更清晰的「像人一样思考」框架,强调目标驱动而非步骤驱动
Jina 积极推荐 — 明确鼓励在合适场景主动使用 Jina 节省 token
子 Agent prompt 指引优化 — 明确加载写法,增加避免动词暗示执行方式的说明
安装
方式一:npx skills 一键安装(推荐)
skills CLI 是开源的 Agent Skill 包管理器,自动检测你的 Agent 环境并安装到正确位置。
方式二:让 Agent 自动安装
方式三:Plugin 安装(Claude Code)
方式四:手动
前置配置(CDP 模式)
CDP 模式需要 Node.js 22+ 和浏览器(Chrome / Edge)开启远程调试:
在你想用的浏览器地址栏打开对应 inspect 页面: Chrome: chrome://inspect/#remote-debugging Edge: edge://inspect/#remote-debugging
Chrome: chrome://inspect/#remote-debugging
Edge: edge://inspect/#remote-debugging
勾选 Allow remote debugging for this browser instance (可能需要重启浏览器)
浏览器偏好(config.env)
skill 长期偏好保存在 ${CLAUDE_SKILL_DIR}/config.env (首次运行自动从 config.env.template 创建,gitignored):
合法值: chrome / edge
临时用别的浏览器 (不修改 config.env):
切换浏览器 (proxy 已连接旧的):
环境检查(Agent 运行时会自动完成前置检查,无需手动执行):
CDP Proxy API
Proxy 通过 WebSocket 直连浏览器(兼容 chrome://inspect / edge://inspect 方式,无需命令行参数启动),提供 HTTP API:
Proxy 会自动追踪通过 /new 创建的 tab,闲置 15 分钟后自动关闭,防止 Agent 异常退出时留下孤儿 tab。可通过环境变量 CDP_TAB_IDLE_TIMEOUT (单位毫秒)调整超时时间。
⚠️ 使用前提醒
通过浏览器自动化操作社交平台(如小红书)存在账号被平台限流或封禁的风险。 强烈建议使用小号进行操作。
使用
安装后直接让 Agent 执行联网任务,skill 自动接管:
"帮我搜索 xxx 最新进展"
"读一下这个页面:[URL]"
"去小红书搜索 xxx 的账号"
"帮我在创作者平台发一篇图文"
"同时调研这 5 个产品的官网,给我对比摘要"
设计哲学
Skill = 哲学 + 技术事实,不是操作手册。讲清 tradeoff 让 AI 自己选,不替它推理。
详见 SKILL.md 中的浏览哲学部分。
License
MIT · 作者: 一泽 Eze · 官网
Star History
Clawhub Download History