SuperAPI AI 工具集

cloudflare-browser

通用与其它

查看项目

更新于 10-15 20:12

技能介绍

用途:通过 Cloudflare Browser Rendering 服务,以 CDP(Chrome DevTools Protocol)over WebSocket 控制无头浏览器,适用于截图、页面导航、抓取和视频捕获等场景。

前提条件:需设置 CDP_SECRET 环境变量;并在 openclaw.json 中配置浏览器 profile,其 cdpUrl 指向 worker 端点,例如 "browser": {"profiles": {"cloudflare": {"cdpUrl": "https://your-worker.workers.dev/cdp?secret=..."}}}。

快速开始:截图命令为 node /path/to/skills/cloudflare-browser/scripts/screenshot.js https://example.com output.png;多页视频命令为 node /path/to/skills/cloudflare-browser/scripts/video.js "https://site1.com,https://site2.com" output.mp4。

连接方式:worker 在 WebSocket 连接时自动创建 page target,需监听 Target.targetCreated 事件获取 targetId。常用 CDP 命令包括 Page.navigate(导航)、Page.captureScreenshot(截图 PNG/JPEG)、Runtime.evaluate(执行 JavaScript)、Emulation.setDeviceMetricsOverride(设置视口)。常见模式为导航后等待渲染再截图,也可用 Runtime.evaluate 执行 window.scrollBy 滚动、设置视口尺寸。

视频制作:导航过程中捕获 PNG 帧,再用 ffmpeg 拼接,命令为 ffmpeg -framerate 10 -i frame_%04d.png -c:v libx264 -pix_fmt yuv420p output.mp4。

限制与排错:未创建 target 可能是竞态条件,需等待 Target.targetCreated 事件并设超时;命令超时可能因 worker 冷启动,可将超时增至 30-60 秒;WebSocket 挂起需确认 CDP_SECRET 与 worker 配置一致。