前言¶
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 按場景選擇工具，並強調一手信息優先於二手轉載：
| 場景 | 建議工具 |
|---|---|
| 搜索摘要、發現信息來源 | WebSearch |
| URL 已知，定向提取頁面信息 | WebFetch |
| 需要原始 HTML（meta、JSON-LD 等） | curl |
| 非公開內容或靜態層無效的平臺（文檔舉例：小紅書、微信公衆號等） | 瀏覽器 CDP |
| 需要登錄態、交互或像人一樣在站內導航 | 瀏覽器 CDP |
可選預處理：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
