web access

给 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> 限定单一浏览器

安装

方式一：npx skills 一键安装（推荐）

npx skills add eze-is/web-access

skills CLI 是开源的 Agent Skill 包管理器，自动检测你的 Agent 环境并安装到正确位置。

方式二：让 Agent 自动安装

帮我安装这个 skill：https://github.com/eze-is/web-access

方式三：Plugin 安装（Claude Code）

claude plugin marketplace add https://github.com/eze-is/web-access
claude plugin install web-access@web-access --scope user

方式四：手动

git clone https://github.com/eze-is/web-access ~/.claude/skills/web-access

前置配置（CDP 模式）

CDP 模式需要 Node.js 22+ 和浏览器（Chrome / Edge）开启远程调试：

1. 在你想用的浏览器地址栏打开对应 inspect 页面：
   • Chrome：chrome://inspect/#remote-debugging
   • Edge：edge://inspect/#remote-debugging
2. 勾选 Allow remote debugging for this browser instance（可能需要重启浏览器）

浏览器偏好（config.env）

skill 长期偏好保存在 ${CLAUDE_SKILL_DIR}/config.env（首次运行自动从 config.env.template 创建，gitignored）：

# 留空 = 每次启动都询问偏好；设值 = 固定使用该浏览器
WEB_ACCESS_BROWSER=edge

合法值：chrome / edge

临时用别的浏览器（不修改 config.env）：

node "${CLAUDE_SKILL_DIR}/scripts/check-deps.mjs" --browser chrome

切换浏览器（proxy 已连接旧的）：

pkill -f cdp-proxy.mjs && node "${CLAUDE_SKILL_DIR}/scripts/check-deps.mjs"

环境检查（Agent 运行时会自动完成前置检查，无需手动执行）：

node "${CLAUDE_SKILL_DIR}/scripts/check-deps.mjs"
# $CLAUDE_SKILL_DIR 是 skill 加载时自动设置的环境变量
# 手动运行请替换为实际路径，如 ~/.claude/skills/web-access

CDP Proxy API

Proxy 通过 WebSocket 直连浏览器（兼容 chrome://inspect / edge://inspect 方式，无需命令行参数启动），提供 HTTP API：

# 启动（Agent 会自动管理 Proxy 生命周期，无需手动启动）
node "${CLAUDE_SKILL_DIR}/scripts/cdp-proxy.mjs" &

# 页面操作
curl -s -X POST --data-raw 'https://example.com' http://localhost:3456/new  # 新建 tab（v2.5.3 起 URL 走 POST body）
curl -s -X POST "http://localhost:3456/eval?target=ID" -d 'document.title'  # 执行 JS
curl -s -X POST "http://localhost:3456/click?target=ID" -d 'button.submit'  # JS 点击
curl -s -X POST "http://localhost:3456/clickAt?target=ID" -d '.upload-btn'  # 真实鼠标点击
curl -s -X POST "http://localhost:3456/setFiles?target=ID" \
  -d '{"selector":"input[type=file]","files":["/path/to/file.png"]}'        # 文件上传
curl -s "http://localhost:3456/screenshot?target=ID&file=/tmp/shot.png"     # 截图
curl -s "http://localhost:3456/scroll?target=ID&direction=bottom"           # 滚动
curl -s "http://localhost:3456/close?target=ID"                             # 关闭 tab
curl -s "http://localhost:3456/health"                                      # 查看状态（含 managedTabs 数量）

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