SuperAPI AI 工具集

web-access-claude-skill

通用与其它

查看项目

更新于 10-13 20:10

技能介绍

Web Access Skill for Claude Code 是由 ara.so 发布、收录于 Daily 2026 Skills 合集的技能,为 Claude Code 提供完整的互联网访问能力。

一、项目用途 Claude Code 自带 WebSearch 和 WebFetch,但缺少三方面能力:一是调度策略,即不知道何时该用哪个工具;二是浏览器自动化,如点击、滚动、文件上传、动态页面处理;三是累积的站点知识,即可在不同会话间复用的特定域名模式。Web Access 旨在补齐这三个缺口。

二、主要能力 技能提供以下能力:自动工具选择,根据场景在 WebSearch / WebFetch / curl / Jina / CDP 之间选择;CDP 代理,直接连接正在运行的 Chrome 并继承登录状态;三种点击模式,/click(JS)、/clickAt(真实鼠标事件)、/setFiles(上传);并行调度,多个目标交由子智能体共享同一个 Proxy,标签页相互隔离;站点经验存储,按域名记录 URL 模式、特殊行为与陷阱并跨会话持久化;媒体提取,从 DOM 中抓取图片/视频 URL,并可截取任意视频帧。

三、安装方式 方式 A,让 Claude 安装:向 Claude 发送“帮我安装这个 skill:https://github.com/eze-is/web-access”,或英文“Install this skill for me: https://github.com/eze-is/web-access”。 方式 B,手动安装:git clone https://github.com/eze-is/web-access ~/.claude/skills/web-access。技能文件为 ~/.claude/skills/web-access/SKILL.md,Claude Code 会自动加载 ~/.claude/skills/ 下的所有 SKILL.md 文件。

四、前置条件 需要 Node.js 22+,可用 node --version 校验(须 >= 22);需启用 Chrome 远程调试,在 Chrome 中打开 chrome://inspect/#remote-debugging 并勾选 “Allow remote debugging for this browser instance”,如有提示需重启 Chrome;依赖校验可运行 bash ~/.claude/skills/web-access/scripts/check-deps.sh,预期输出 Node.js 22.x、Chrome DevTools 在 localhost:9222 可达、curl 可用。

五、核心组件:CDP 代理 代理是一个轻量 Node.js WebSocket 桥,连接 Claude 与本机 Chrome。启动命令:node ~/.claude/skills/web-access/scripts/cdp-proxy.mjs &(后台启动,空闲 20 分钟后自动退出)。可用 curl -s http://localhost:3456/ping 确认运行,返回 {"status":"ok"}。 HTTP API 覆盖:标签页管理(/new 打开新标签返回 targetId、/close 关闭标签)、页面内容(/eval 执行 JavaScript 并返回结果、获取完整页面 HTML)、交互(/click JS 点击、/clickAt 通过 CDP 发送真实鼠标点击、/setFiles 通过 input 元素上传文件)、导航(/scroll 到顶部或底部)、视觉(/screenshot 截图到文件或返回 base64)。

六、三层通道调度 技能会教会 Claude 自动选择工具:一般搜索查询用 WebSearch;静态页面、文档或 API 用 WebFetch 或 Jina;需要登录或动态页面用 CDP Proxy;大量 JS 或 SPA 用 CDP Proxy;视频或 canvas 交互用 CDP Proxy(clickAt);批量文本提取用 Jina(更省 token);原始 HTTP 或自定义请求头用 curl。Jina 可将任意 URL 转为干净的 markdown,适合文档与文章,示例:curl -s "https://r.jina.ai/https://docs.example.com/api"。

七、典型使用示例 技能资料给出了若干代码示例:打开页面并提取数据(打开标签、等待加载后用 /eval 提取标题、再关闭标签);登录受限页面(在用户真实 Chrome 中开标签,CDP 自动继承 cookie,无需重新登录);文件上传自动化(先用 /clickAt 点击上传触发按钮,等待后 /setFiles 设置文件,再 /click 提交,最后截图确认);使用子智能体并行研究(对多个 URL 并发开标签,每个子智能体持有自己的 targetId,用 Promise.all 汇总结果);视频帧截图(通过 /eval 将 video.currentTime 定位到时间点并暂停,再截图)。

八、常见模式 CDP 任务前先检查代理是否在线,未在线则启动;文本密集页面用 Jina 读取;发现 URL 用 WebSearch、读取静态内容用 WebFetch、交互与登录与动态内容用 CDP;可用 /eval 加 DOM 查询一次性提取页面上所有图片与视频 URL。

九、故障排查 代理无法启动时可检查 3456 端口是否被占用(lsof -i :3456)、杀掉已有代理后重启;Chrome 不可达时用 curl -s http://localhost:9222/json/version 验证远程调试是否开启,为空则需在 chrome://inspect/#remote-debugging 启用;/clickAt 无效果时元素可能需先滚动进入视口,可先用 /eval 执行 scrollIntoView 再重试;页面内容为空或 JS 未渲染时,在 /new 之后、/eval 之前加入等待;文件上传输入框找不到时,部分 SPA 只在点击触发后才渲染 input[type=file],应先 /clickAt 可见上传按钮、等待 500ms 再 /setFiles;子智能体标签互相干扰时,每个子智能体应保存各自的 targetId 且不共享,代理按标签无状态。代理空闲 20 分钟会自动关闭,长任务可用后台循环 ping 保活。

十、站点经验存储 技能会在本地 JSON 存储中累积域名知识,例如访问 twitter.com 时会读取已保存的可用 URL 模式、登录流程特殊行为、稳定与动态选择器、限流行为等,并跨 Claude 会话持久化。存储路径为 ~/.claude/skills/web-access/data/site-experience.json,可手动查看或编辑以添加自己的域名知识。

十一、项目结构 ~/.claude/skills/web-access/ 下包含 SKILL.md(技能文件,由 Claude 加载)、scripts/cdp-proxy.mjs(CDP 代理服务器,需 Node.js 22+)、scripts/check-deps.sh(依赖检查器)、data/site-experience.json(累积的域名知识)。

十二、任务路由能力概要 用户说“搜索 X”时用 WebSearch;“读取这个 URL”时用 WebFetch 或 Jina;“打开 X 上的我的仪表盘”时用 CDP(继承登录状态);“点击 X 上的提交按钮”时用 CDP /click 或 /clickAt;“把这个文件上传到 X”时用 CDP /setFiles;“研究这 5 个产品”时用 CDP 并行子智能体;“从 X 提取图片”时用 CDP /eval 加 DOM 查询;“截取 X 视频 1:23 处的画面”时用 CDP /eval 定位加 /screenshot。

关于该技能的收费方式、价格、具体平台支持范围等更多信息,资料中暂未提供。