@kentcdodds: 通过 Kody 使用浏览器：https://kody.codes/@kody/browser-run… 大多数现代代理都支持浏览器，这在大多数情况下没问题 m…

X AI KOLs Following 工具
browser-automation cloudflare puppeteer dev-tool scripting browser-run

摘要

本文介绍了 Kody 的 browser-run 包，它提供了一种轻量级、隔离的方式来使用 Cloudflare Browser Run 进行浏览器自动化，包括快速操作和共享会话，用于可重复的脚本编写，无需 AI 介入。

通过 Kody 使用浏览器：https://kody.codes/@kody/browser-run… 大多数现代代理都支持浏览器，这在大多数情况下没问题。这个包对于需要浏览器完成的可重复任务很有用，这些任务可以脚本化，因此不需要模型介入。
查看原文
查看缓存全文

缓存时间: 2026/09/29 19:55

通过 Kody 使用浏览器：https://kody.codes/@kody/browser-run… 大多数现代智能体都支持浏览器，且通常已足够应对一般需求。本软件包则适用于那些可通过脚本完成、因而无需模型介入的重复性浏览器操作任务。

@kody/browser-run — Kody 公共软件包

来源：https://kody.codes/@kody/browser-run

  • 集成 (https://kody.codes/community?category=integrations)
  • cloudflare
  • browser-run
  • browser-rendering
  • puppeteer
  • screenshot
  • cdp
  • sessions

版本：1.0.0
许可证：已发布
发布时间：2026年9月29日
固定提交：ee5297c
评分：暂无评分
分支数：0
适配工作量：—

设计目标

为智能体和开发者提供一种轻量且隔离安全的调用方式，用于访问Cloudflare Browser Run（原 Browser Rendering）服务：支持一次性快速操作（截图、PDF生成、数据抓取等）以及会话共享辅助功能，内置会话复用和每次请求的createBrowserContext()隔离机制。其成功标志在于：实现可靠的浏览器自动化，无需为每次请求冷启动新浏览器，也无需在共享会话中调用browser\.close()。

本软件包功能

  • 快速操作——通过 REST POST 请求至/accounts/\{accountId\}/browser\-rendering/\{action}，支持content、screenshot、pdf、markdown、scrape、links、json、snapshot及accessibilityTree。
  • 会话管理——支持列表查看、获取、申请、连接元数据及受保护的关闭操作。
  • open\-isolated（自动化默认模式）——流程为：列表查询 → 复用（随机起始） → 申请；返回 WebSocket 端点及隔离操作指引：先使用createBrowserContext创建隔离上下文，完成操作后依次调用context\.close()和browser\.disconnect()。
  • worker\-recipe——提供复制粘贴式的 Worker 配置及 Wrangler 部署指南，需配合@cloudflare/puppeteer≥ 1.1.0（本软件包内不可直接运行）。

本软件包不依赖 Puppeteer 或 Playwright（此类依赖会导致 Worker 隔离环境负载激增）。密集的 CDP 控制应在您的 Cloudflare Worker 或 Node 进程中执行；Kody 仅负责 REST/CDP 元数据的协调工作。

安装设置

  1. API 令牌——创建具有Browser Rendering - Edit权限的 Cloudflare API 令牌。将其保存为 Kody 用户密钥cloudflareApiToken，并设置允许的主机为api\.cloudflare\.com：
    https://kody.codes/account/secrets/new?name=cloudflareApiToken&description=Cloudflare%20API%20token%20with%20Browser%20Rendering%20-%20Edit&allowedHosts=api.cloudflare.com&scope=user
  2. 账户 ID——在实时调用中传入accountId。可在控制台 URL（dash\.cloudflare\.com//...）或Workers & Pages → 概览 → 账户 ID中找到。分支用户需使用自己的账户——本软件包未硬编码任何 Cloudflare 账户信息。
  3. 可选——可通过apiTokenSecret参数传入备用密钥的名称（切勿传递原始令牌值）。

使用场景指南

需求推荐方案
单次截图/PDF/抓取/Markdown转换\./quick\-action 或 \./screenshot、\./pdf 等
多步骤自动化/共享浏览器环境\./open\-isolated（默认模式）
在 Workers 上部署 Puppeteer\./worker\-recipe
验证密钥/连接配置\./smoke\-test

文档：Cloudflare Browser Run · 会话复用

成功路径设计

多个客户端可共享同一个 Browser Run 会话（每个 Worker 使用独立的puppeteer\.connect连接，并通过不同浏览器上下文隔离）。连接后请遵循：
1. const context = await browser\.createBrowserContext\(\)
2. 在该上下文中执行操作
3. await context\.close\(\)
4. await browser\.disconnect\(\)

注意：在会话可能被共享时，切勿调用browser\.close()——这将中断所有并发客户端连接。

完成状态检查

  • 当accountId/密钥缺失时，smoke\-test应返回配置指引而非晦涩错误
  • 已配置令牌和accountId后，sessions/list或smoke\-test应能列出会话（或返回明确的认证错误）
  • 智能体在自动化任务中默认选择open\-isolated，在一次性操作中使用快速操作

举报此条目：请登录后举报。

相似文章