SuperAPI AI 工具集

cloudflare-browser-rendering

部署与运维

查看项目

更新于 10-16 03:14

技能介绍

用途:该资料是 Cloudflare Browser Rendering 的完整参考,面向需要在 Cloudflare 全球网络上运行无头 Chromium 的任务,例如网页截图、HTML/URL 转 PDF、动态网站抓取、爬取多页流程和前端自动化测试。提供 Workers Bindings 与 REST API 两种方式,本资料聚焦 Workers Bindings 这一完整使用 Puppeteer/Playwright API 的高级方式。

主要能力:支持 @cloudflare/puppeteer(1.0.4)与 @cloudflare/playwright(1.0.0,Playwright v1.55 GA)。Puppeteer 提供更完善的会话管理 API,如 sessions、history、limits、connect,适合截图、PDF、抓取;Playwright 具备自动等待,适合已有测试迁移或需要 MCP 集成。两者目前都只支持 Chromium,不支持 Firefox/Safari。可通过 createBrowserContext 隔离 cookie 与缓存,用多标签页代替多浏览器以节省并发。

使用方式:在 wrangler.jsonc 配置 browser binding,并启用 nodejs_compat。安装 npm install @cloudflare/puppeteer。调用时必须传入绑定:const browser = await puppeteer.launch(env.MYBROWSER),随后 newPage、goto、screenshot/pdf、evaluate 等,完成后按需 browser.close() 或 browser.disconnect() 复用会话;部署使用 npx wrangler deploy。本地开发可用 remote: true 绕过 1MB 请求限制。XPath 不直接支持,需用 CSS 选择器或 page.evaluate 配合 XPathEvaluator。

适用场景:截图缓存、AI 增强抓取、结构化数据提取、表单自动化、PDF 生成等。

限制:免费层 10 分钟/天、3 并发、3 次启动/分钟、60 秒超时;付费层每月含 10 小时、平均 10 并发、30 次启动/分钟、60 秒至 10 分钟超时。请求始终被识别为机器人,无法绕过机器人防护;并发与计费细节以官方最新说明为准。