Browser Run — /snapshot エンドポイントの新しい formats パラメータ

概要

Browser Run の /snapshot エンドポイントは formats パラメータをサポートするようになり、1 回の API 呼び出しで複数のページ形式を返せるようになりました。従来、/snapshot は HTML コンテンツとスクリーンショットのみを返していましたが、これからは Markdown や accessibility tree も同じレスポンスに含めることができます。

これらのフォーマットは特に AI エージェントワークフローで有用です。

• Markdown: HTML マークアップを解析せずに LLM が直接処理できる、トークン効率の良いページ内容の表現を提供します。
• accessibility tree: 要素のロール、ラベル、階層構造を含むページの構造化された表現を提供し、LLM がページ構造を理解して内容をナビゲートするのに役立ちます。

使用例

以下の例はスクリーンショット、Markdown、accessibility tree を一度の呼び出しで返します。

curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/snapshot' -H 'Authorization: Bearer <apiToken>' -H 'Content-Type: application/json' -d '{ "url": "https://example.com/", "formats": ["screenshot", "markdown", "accessibilityTree"] }'

TypeScript (SDK) 例

import Cloudflare from "cloudflare";
const client = new Cloudflare({ apiToken: process.env["CLOUDFLARE_API_TOKEN"] });
const snapshot = await client.browserRendering.snapshot.create({
  account_id: process.env["CLOUDFLARE_ACCOUNT_ID"],
  url: "https://example.com/",
  formats: ["screenshot", "markdown", "accessibilityTree"],
});
console.log(snapshot.markdown);
console.log(snapshot.accessibilityTree);

Workers 例

interface Env { BROWSER: BrowserRun; }

export default {
  async fetch(request, env): Promise<Response> {
    return await env.BROWSER.quickAction("snapshot", {
      url: "https://example.com/",
      formats: ["screenshot", "markdown", "accessibilityTree"],
    });
  },
} satisfies ExportedHandler<Env>;

注意事項

• formats は少なくとも 2 つ指定する必要があります。もし 1 つだけ必要であれば、/screenshot や /markdown のような単一フォーマット専用のエンドポイントを使用してください。
• サポートされる値の全一覧は /snapshot ドキュメントを参照してください。

参照

• /snapshot ドキュメント（詳細な受け入れ値一覧およびレスポンス形式）

ご不明な点があればドキュメントを確認するかサポートにお問い合わせください。