AGENTIC COMMONSAI 產業簡報

繁中EN

標籤Cloudflare出版

返回文章列表

Quick Actions:截圖、PDF 一個端點搞定

**摘要:**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 的團隊可以忽略這則消息。

參考來源

原始貼文
AGENTIC COMMONS由 PHLEGON LABS 經營
分享X電郵
支持我們

相關閱讀

  1. BotBase for Operators:讓網站主與機器人營運者不再互相猜測

    Cloudflare 推出 BotBase for Operators,把機器人提交流程從黑箱變成透明可追蹤的儀表板,並用新的行為與內容使用分類法加速審核。

    AI Agents

  2. Cloudflare 2026 美國期中選舉:攻擊避開投票日

    Cloudflare 報告:1,400 個選舉網站投票日流量增 363% 卻零重大 DDoS,漏洞掃描早在 10 月見頂,數量是 DDoS 的 180 倍。

    Cloudflare

  3. Clairic 開放權重:Clairic 與 Clairic-flash 怎麼選

    Clairic 與 Clairic-flash 開放權重上架,9B 版自架伺服器 p50 延遲 155 ms、輸入 token 每 M $0.10;27B

    Cloudflare