從 Browser Rendering 改名而來
Cloudflare 在 2026-04-15 把原本的 Browser Rendering 改名為 Browser Run,同時大幅擴充功能。改名是因為原本的名字沒有傳達出它真正在做什麼——它不只是「渲染」頁面,而是讓你跑完整的瀏覽器 session、讓 AI 驅動它、錄製它、在需要時讓人類接手。
你的 AI agent 想要瀏覽網頁,但網頁需要 JavaScript 渲染、登入驗證、甚至 CAPTCHA。
AI agent 需要瀏覽器,而瀏覽器應該是基礎設施,不是你要自己維護的東西。Browser Run 讓 agent 直接操作一個跑在 Cloudflare 全球網路上的真實 Chrome,免費方案就能用。
五種接入方式,從簡單到完整控制
Browser Run 提供多種接入方式,視你的需求從最簡單的 REST API 到完整的底層 CDP 協定都可以選擇。
對一個 URL 發一個 POST,直接拿到截圖、PDF、Markdown 或完整 HTML。適合一次性任務,不需要互動。
原本就在用 Puppeteer 或 Playwright?只需要改一行 config,把 wsEndpoint 指向 Cloudflare 的 API,其餘程式碼不用動。
直接暴露 Chrome DevTools Protocol。任何語言、任何環境都能連,不需要寫 Cloudflare Worker。對 agent 來說,CDP 讓它能直接傳 raw 訊息給瀏覽器,省 token 又快。
透過 chrome-devtools-mcp,在 MCP 設定檔加一段 config,Claude Desktop 或 Cursor 就有一個跑在 Cloudflare 上的遠端瀏覽器。AI coding agent 可以直接測試 web UI、debug 頁面。
Google Chrome 團隊推的新規格。網站可以宣告「這頁有 search_flights(origin, dest, date) 工具」,agent 直接呼叫,不需要截圖猜 UI。Browser Run 率先支援 Chrome beta 的 WebMCP。
如果你用的是 Claude Desktop,設定方式如下:
{
"mcpServers": {
"browser-run": {
"command": "npx",
"args": [
"-y",
"chrome-devtools-mcp@latest",
"--wsEndpoint=wss://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/browser-rendering/devtools/browser?keep_alive=600000",
"--wsHeaders={\"Authorization\":\"Bearer <API_TOKEN>\"}"
]
}
}
}
設定完成後,重啟 Claude Desktop,就可以直接叫 Claude 去開網頁、截圖、測試 UI。
看到 agent 在做什麼,需要時接手
Browser Run 提供三個工具,讓你對 agent 的瀏覽器操作有完整的可見性和控制權。
即時看 agent 的瀏覽器畫面,包含 DOM、console、網路請求。按鈕找不到、頁面需要登入,立刻看到。
Agent 卡在登入、CAPTCHA、或意外頁面時,可以 handoff 給真人。人處理完,控制權還給 agent 繼續跑。
錄下每個 session 的 DOM 變化、滑鼠鍵盤、頁面跳轉,事後可以回放。出問題時不用瞎猜。
這次同時也把預設並發瀏覽器從 30 提高到 120(4 倍)。大量並行任務不用另外申請就能跑更多。
什麼時候你會需要它?
SPA、動態載入的內容,用一般 HTTP request 拿不到。Browser Run 執行完整的 JS,拿到真正的頁面內容。
Agent 幫你登入後台、填資料、下訂單。遇到二步驟驗證或 CAPTCHA,Human in the Loop 讓你接手一秒,之後繼續。
把 Browser Run 接到 Claude Desktop 或 Cursor,讓 AI agent 直接開你的 localhost、截圖、確認 UI 結果,不需要你手動驗證。
每小時截圖一次你的競品網站或自家服務,存到 R2。搭配 AI 做視覺差異比對,自動告警。
用 Quick Actions 的 /crawl endpoint,一個 API call 爬整個網站,回傳 Markdown 或結構化 JSON。適合做 RAG 知識庫的資料收集。
Agent 定期巡邏競品的定價頁、功能更新、職缺變化,整理成報告。需要登入的頁面也可以用 session 持久化保留登入狀態。
最簡單的入口:Quick Actions
不想設定框架?用 Quick Actions 的 REST API 直接試試:
# 截圖
curl -X POST \
'https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/browser-rendering/screenshot' \
-H 'Authorization: Bearer <API_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{"url": "https://example.com"}'
# 爬取整個網站
curl -X POST \
'https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/browser-rendering/crawl' \
-H 'Authorization: Bearer <API_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{"url": "https://blog.example.com/"}'
Browser Run 在 Workers Free 和 Paid 方案都可以使用。登入 Cloudflare Dashboard,到 Workers & Pages → Browser Run 就可以開始。
| 限制項目 | Workers Free | Workers Paid |
|---|---|---|
| Browser hours(每日) | 10 分鐘 | 無上限(依用量計費) |
| 同時開啟的 browser 數 | 3 個 | 120 個 |
| 新建 browser 頻率 | 1 個 / 20 秒 | 1 個 / 秒 |
| Quick Actions 請求頻率 | 1 個 / 10 秒 | 10 個 / 秒 |
| Browser timeout(閒置) | 60 秒(可設定最長 10 分鐘) | |
| /crawl 每日工作數 | 5 個 / 天,最多 100 頁 | 無限制 |
遇到 concurrency 瓶頸的常見解法:同一個 browser 開多個 tab,或用 incognito context 替代每次新建 browser。
/crawl endpoint 是有道德設計的爬蟲——它會遵守 robots.txt、有 Web Bot Auth 簽名、不繞過 Cloudflare 的 bot 防護。爬取他人網站前請確認你有權限。