web-access

name

web-access

description

This skill should be used when the user needs to access the web beyond simple search or static page fetching — including logging into sites, interacting with dynamic pages, scraping content behind authentication, automating browser operations, or performing any task that requires operating a real browser. Triggers include: "帮我登录", "抓取这个页面", "自动点击", "浏览器操作", "需要登录才能看", "动态页面", "截个图", and similar web interaction requests.

web-access

完整联网能力扩展：三层通道调度 + 浏览器 CDP 直连 + 并行分治。

前置检查

开始任何浏览器 CDP 操作前，先运行环境检查脚本确认就绪：

node ~/.workbuddy/skills/web-access/scripts/check-deps.mjs

若检查未通过，引导用户完成设置：

• Node.js 22+：必需（使用原生 WebSocket）。低于 22 可用但需安装 ws 模块。
• Chrome remote-debugging：在 Chrome 地址栏访问 chrome://inspect/#remote-debugging，勾选 "Allow remote debugging for this browser instance"，可能需重启浏览器。

检查通过后，在回复中向用户直接展示以下须知，再执行 CDP 操作：

温馨提示：部分站点对浏览器自动化操作检测严格，存在账号封禁风险。已内置防护措施但无法完全避免，继续操作即视为接受。

浏览哲学

像人一样思考，兼顾高效与适应性完成任务。

执行任务时不过度依赖预设步骤，而是带着目标进入，边看边判断，遇到阻碍就解决，发现内容不够就深入——全程围绕「我要达成什么」做决策。

联网工具选择

确保信息真实性，一手信息优于二手信息。

场景	工具
搜索摘要或关键词结果，发现信息来源	WebSearch 工具
URL 已知，需定向提取特定信息	WebFetch 工具
URL 已知，需要原始 HTML 源码	execute_command: curl
非公开内容，或已知静态层无效的平台	浏览器 CDP
需要登录态、交互操作，或需要在浏览器内自由导航探索	浏览器 CDP

Jina（可选预处理层）：第三方服务，可将网页转为 Markdown，节省 token 但可能有信息损耗。 curl -s "https://r.jina.ai/https://example.com"

浏览器 CDP 模式

通过 CDP Proxy 直连用户日常 Chrome，天然携带登录态，无需启动独立浏览器。

启动 Proxy

node ~/.workbuddy/skills/web-access/scripts/check-deps.mjs

check-deps.mjs 会自动检测 Chrome 调试端口并以后台守护进程方式启动 cdp-proxy.mjs（监听 localhost:3456）。Proxy 启动后保持运行，重启需 Chrome 重新授权。

Proxy API 调用（通过 execute_command 执行 curl）

# 列出用户已打开的 tab
curl -s http://localhost:3456/targets

# 创建新后台 tab
curl -s "http://localhost:3456/new?url=https://example.com"

# 执行任意 JS（POST body 为表达式）
curl -s -X POST "http://localhost:3456/eval?target=TARGET_ID" -d 'document.title'

# 截图保存到本地
curl -s "http://localhost:3456/screenshot?target=TARGET_ID&file=/tmp/shot.png"

# 点击元素（CSS 选择器）
curl -s -X POST "http://localhost:3456/click?target=TARGET_ID" -d 'button.submit'

# 滚动页面
curl -s "http://localhost:3456/scroll?target=TARGET_ID&y=3000"

# 关闭 tab
curl -s "http://localhost:3456/close?target=TARGET_ID"

详细 API 参考：加载 references/cdp-api.md

三种点击方式

1. /click — JS 层面 .click()，简单快速，覆盖大多数场景
2. /clickAt — 真实 CDP 鼠标事件，可触发文件对话框、绕过部分反自动化检测
3. /setFiles — 直接设置文件 input，绕过文件选择对话框

并行调研：子 Agent 分治策略

任务包含多个独立调研目标时，合理分治给子 Agent 并行执行，提升效率。

信息核实类任务

核实目标是一手来源，而非更多二手报道。

站点经验

操作中积累的特定网站经验，按域名存储在 ~/.workbuddy/skills/web-access/references/site-patterns/ 下。

确定目标网站后，读取对应站点经验文件（如存在）：

~/.workbuddy/skills/web-access/references/site-patterns/{domain}.md

References 索引

• references/cdp-api.md：需要 CDP API 详细参考时加载
• references/site-patterns/{domain}.md：确定目标网站后读取对应站点经验