**摘要:**Cloudflare 的 Browser Run(前身 Browser Rendering)推出 Quick Actions,把截圖、PDF、HTML 與 Markdown 擷取這類常見瀏覽器工作包成固定端點,用 REST API 或 Workers binding 一個呼叫就能完成,不必自己寫 headless browser 腳本。對沒有平台工程師的小團隊來說,最無聊的瀏覽器雜務可以從「維運一套 Puppeteer」降級成「一個 HTTP 請求」。
十個端點,兩種接法
Quick Actions 提供十個固定端點:/content 抓 HTML、/Screenshot 截圖、/pdf 轉 PDF、/markdown 抽 Markdown、/snapshot 一次取多種頁面格式、/accessibilityTree 取無障礙樹、/scrape 抓指定元素、/json 用 AI 抽結構化資料、/links 取連結、/crawl 爬站——其中 /crawl 只開放 REST API。
兩種接法各有一套前置作業。走 REST API 要先建一個具備「Browser Run - Edit」權限的自訂 API Token;走 Workers binding 則在 wrangler.json 加一段設定,之後直接呼叫 env.BROWSER.quickAction(),不需要任何 token,token 外洩的風險也少一個:
{
"compatibility_date": "2026-03-24",
"browser": {
"binding": "BROWSER"
}
}
注意 .quickAction() 要求 compatibility date 為 2026-03-24 或之後,改動這個日期前先確認其他依賴不受影響。/json 是十個端點裡唯一動用到 AI 的:它靠 Workers AI 產生結構化資料,輸出形狀由 response_format.json_schema 指定。
本地開發的兩個例外
在 npx wrangler dev 底下,.quickAction() 用本機的 Chrome 執行,回應與錯誤和線上一致,只有兩個例外。第一,/json 只回傳佔位資料,因為 Workers AI 在本地不可用:schema 中設了 const、enum 或 default 的欄位會拿到對應值(enum 取第一個),其餘欄位給空值如 ""、0、false、[],Wrangler 會一併發出警告。第二,Kitesurf 瀏覽器本地不可用,傳 browser: "kitesurf" 會直接拋錯。想在本地拿到真實的 /json 結果或使用 Kitesurf,把 binding 加上 "remote": true 即可。
如果你在本地看到 /json 回傳一堆空字串,先別急著 debug schema——那多半就是佔位行為,不是你的 schema 寫錯。
用量與計費看哪裡
每個 Quick Actions 回應都帶一個 X-Browser-Ms-Used header,以毫秒回報該次請求消耗的瀏覽器時間;Cloudflare dashboard 的 Browser Run 頁面則顯示聚合數據,包括 Quick Actions 總請求數與總 browser hours。文件沒有列出 browser hours 的計價數字,高用量情境下實際成本要自己從 dashboard 累積的數據推算。
它不是 Puppeteer 的替代品
Cloudflare 自己把界線畫得很清楚:需要進階自動化、自訂工作流程或持久瀏覽器 session 時,請改用 Puppeteer、Playwright 或 CDP。Quick Actions 是「簡單任務」這一層——每次請求開一個頁面、做完一件事就結束。如果你的產品本來就有登入後逐步操作、跨頁面維持狀態的需求,這裡幫不上忙。
**我們的看法:**對要交付截圖預覽、PDF 產生、Markdown 擷取這類功能的小團隊,我們認為現在就該接:改動範圍是一個端點加一段 wrangler 設定,一個下午可完成、隨時可回退,卻省掉維運一套 headless browser 叢集的成本。前提假設是用量屬於中低量級——文件未提供計價數字,若 dashboard 顯示的 browser hours 換算下來貴過自架瀏覽器,或 /json 在真實頁面上的抽取品質不佳,就該退回 Firecrawl 這類專職擷取 API 或既有 Playwright 流程。已經跑著 Playwright 持久 session 的團隊可以忽略這則消息。
參考來源
在 X 上查看原貼文
