前言¶

Agent 要查资料、打开链接、处理登录页或反爬站点时，往往会在 WebSearch、curl、自建脚本和浏览器自动化之间来回切换，缺少一套可复用的判断顺序与安全边界。下面介绍 SkillHub 社区技能 Web访问技能（@user_3c6cb52e/web-access-png）：用标准 SKILL.md 把「何时用搜索 / 抓取 / curl / 浏览器 CDP」、CDP Proxy 调用方式，以及任务结束时的清理约定写进 Agent 上下文，便于在多平台 Agent 里一致执行。商店页标注 requires_api_key=false，不依赖额外 API Key。

这是什么¶

Web访问技能 是面向 AI Agent 的联网与页面操作指引包，版本 1.0.0，来源为 SkillHub community，发布者 user_3c6cb52e，分类 ai-agent。SkillHub 页面简介为：Web访问技能专用技能，帮助 AI Agent 高效完成相关任务。技能元数据中声明兼容 Claude Code、Codex、Hermes Agent、OpenClaw、QClaw、WorkBuddy 等框架，许可证 MIT；主页与仓库字段指向 https://github.com/1991513ccie-png。

官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/user_3c6cb52e/web-access-png
• 技能坐标：@user_3c6cb52e/web-access-png

核心功能¶

以下内容均来自该技能包内的 SKILL.md（经 skillhub install 安装核对）。

联网工具分层¶

技能要求 Agent 按场景选择工具，并强调一手信息优先于二手转载：

可选预处理：Jina（r.jina.ai/ 前缀，文档注明限 20 RPM），可与 WebFetch/curl 组合以节省 token，但可能有信息损耗。

浏览器 CDP 与本地资源¶

• 前置检查：通过 node "${CLAUDE_SKILL_DIR}/scripts/check-deps.mjs" 检查 Node.js（文档要求 22+）、调试端口与 CDP Proxy；支持 --browser chrome|edge 临时覆盖，持久偏好写入 config.env 的 WEB_ACCESS_BROWSER。
• Proxy API：默认 http://localhost:3456，提供列出 tab、/new、/eval、/screenshot、/navigate、/click、/scroll、/close 等 HTTP 接口（文档含完整 curl 示例）。
• 本地书签/历史：node "${CLAUDE_SKILL_DIR}/scripts/find-url.mjs" 按关键词检索 Chrome/Edge 书签或历史，用于「用户之前看过的页面」或内网系统入口。
• 行为原则：不主动操作用户已有 tab；在自建后台 tab 中完成操作后关闭；操作前向用户展示自动化与封号风险提示；支持子 Agent 并行分治与 references/site-patterns/ 站点经验沉淀。

任务类型补充¶

文档另含「浏览哲学」（目标导向、过程校验）、信息核实类任务的一手来源表、视频帧采样思路，以及 v2.5.3 起 /new、/navigate 使用 POST body 传 URL 的迁移说明。

安装与启用¶

1、安装 SkillHub CLI¶

若尚未安装 CLI，可按官方安装文档执行：

command -v skillhub && skillhub --version

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

说明见：https://skillhub.cn/install/skillhub.md

2、安装 Web访问技能¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。

skillhub install web-access-png --namespace user_3c6cb52e --dir <skills 目录>

SkillHub 技能页给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_3c6cb52e/web-access-png（与上式等价，坐标为 @user_3c6cb52e/web-access-png）。

常用 skills 目录（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

安装完成后按所用客户端要求重启或刷新 Agent，使 SKILL.md 进入技能列表。

3、包体说明（安装实测）¶

在本文写作环境中执行上述安装命令后，目录 @user_3c6cb52e/web-access-png 内仅有 SKILL.md 与 _meta.json。文档中引用的 scripts/、references/ 未出现在该次下载包中；若你本地同样缺少脚本，需以 SkillHub 页面或仓库 https://github.com/1991513ccie-png 的后续更新为准，再执行文档中的 check-deps.mjs 等步骤。

典型用法¶

联网前检查与风险提示¶

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

按退出码处理：0 继续；2 询问用户并写入 config.env；1 按 stdout 指引处理。检查通过后，Agent 须在回复中展示文档规定的「浏览器自动化与封号风险」温馨提示，再启动 CDP Proxy。

通过 Proxy 打开页面并读取标题¶

curl -s http://localhost:3456/targets
curl -s -X POST --data-raw 'https://example.com' http://localhost:3456/new
curl -s -X POST "http://localhost:3456/eval?target=ID" -d 'document.title'

ID 为 /targets 或 /new 返回的 target 标识；URL 通过 POST body 传入，避免 query 被截断。

从本地浏览器找回用户曾访问的 URL¶

node "${CLAUDE_SKILL_DIR}/scripts/find-url.mjs" 关键词 --only history --since 7d --limit 10

适合「上次看过的那篇文章」「公司内网面板」等公网搜索难以命中的入口。

子 Agent 并行调研¶

多目标彼此独立时，主 Agent 可分派子任务，并在子 Agent prompt 中写明「必须加载 web-access skill 并遵循指引」，由子 Agent 自行选择 WebSearch、WebFetch 或 CDP，各自 /new 与 /close tab。

适用场景与注意¶

适合谁：需要 Agent 稳定完成搜索、页面抓取、登录态浏览、反爬较重站点访问，并希望统一操作哲学与 CDP API 约定的团队或个人。

限制与注意：

• 文档依赖 Node.js 22+ 与本地 Chromium 系浏览器 CDP；切换浏览器时需先结束 cdp-proxy.mjs 再重跑检查。
• 部分站点对自动化敏感，技能已说明存在账号风险，需用户知情后继续。
• SkillHub 统计（抓取资料）：评分 100000，下载 1740，安装 0；与页面展示可能随时间变化，以商店为准。
• 当前实测包体可能仅含指引文本；若脚本未下发，CDP 相关命令无法直接运行，需确认完整包或仓库内容后再用于生产任务。

结尾¶

Web访问技能 把 Agent 联网与浏览器操作的选型、CDP Proxy 约定、风险告知和站点经验维护写进一份可安装的技能文档，适合挂在 Cursor、Claude Code、Codex 等环境的 skills 目录中长期使用。获取与安装请以 SkillHub 官方页为准：https://www.skillhub.cn/skills/user_3c6cb52e/web-access-png