# Browser Run

ヘッドレスブラウザーインスタンスをプログラムから制御し操作します

> 以下のリンクは、各ページの Markdown 版を直接指します。 任意のページは、`index.md` サフィックスなしの URL に `Accept: text/markdown` ヘッダーを付けて取得することもできます（例: `curl -H "Accept: text/markdown" https://developers.cloudflare.com/browser-run/`）。
>
> その他の Cloudflare 製品は、[Cloudflare ドキュメントディレクトリ](https://developers.cloudflare.com/llms.txt) を参照してください。

## 概要

- [Browser Run](https://developers.cloudflare.com/browser-run/index.md): Cloudflare の Workers Browser Run API でヘッドレスブラウザーを操作します。タスクの自動化、スクリーンショット、PDF 変換、ウェブアプリのテストができます。

## はじめに

- [はじめに](https://developers.cloudflare.com/browser-run/get-started/index.md): 連携方法を選び、Quick Actions、Puppeteer、Playwright のいずれかで最初の Browser Run プロジェクトをセットアップします。

## 例

- [例](https://developers.cloudflare.com/browser-run/examples/index.md): Quick Actions、Puppeteer、Playwright、CDP 連携向けの Browser Run コード例を確認します。

## Quick Actions

- [Quick Actions](https://developers.cloudflare.com/browser-run/quick-actions/index.md): Browser Run の Quick Actions HTTP エンドポイントで、スクリーンショットの取得、HTML の抽出、PDF の生成など、よく使うブラウザー作業を実行します。
- [/accessibilityTree - アクセシビリティツリーを取得](https://developers.cloudflare.com/browser-run/quick-actions/accessibility-tree-endpoint/index.md): Browser Run の /accessibilityTree エンドポイントで、JavaScript 実行後のウェブページからアクセシビリティツリーを取得します。
- [リファレンス](https://developers.cloudflare.comhttps://developers.cloudflare.com/api/resources/browser_rendering/index.md): 利用できるすべてのエンドポイントとパラメーターについて、Browser Run Quick Actions の API リファレンスを確認します。
- [/content - HTML を取得する](https://developers.cloudflare.com/browser-run/quick-actions/content-endpoint/index.md): Browser Run の /content エンドポイントを使い、JavaScript 実行後の完全にレンダリングされた HTML を取得します。
- [/crawl - Web コンテンツをクロールする](https://developers.cloudflare.com/browser-run/quick-actions/crawl-endpoint/index.md): Browser Run の /crawl エンドポイントで、設定可能な深さと出力形式を使い、サイト全体のリンクをたどってスクレイピングします。
- [/json - AI で構造化データを取得する](https://developers.cloudflare.com/browser-run/quick-actions/json-endpoint/index.md): Browser Run の /json エンドポイントと AI を使い、Web ページから構造化 JSON データを抽出します。
- [/links - ウェブページからリンクを取得する](https://developers.cloudflare.com/browser-run/quick-actions/links-endpoint/index.md): Browser Run の /links エンドポイントを使い、非表示のリンクを含めて、ウェブページからすべてのリンクを抽出します。
- [/markdown - Web ページから Markdown を抽出する](https://developers.cloudflare.com/browser-run/quick-actions/markdown-endpoint/index.md): Browser Run の /markdown エンドポイントで、Web ページのコンテンツを Markdown 形式に変換します。
- [/pdf - PDF をレンダリング](https://developers.cloudflare.com/browser-run/quick-actions/pdf-endpoint/index.md): Browser Run の /pdf エンドポイントで、ウェブページまたはカスタム HTML から PDF を生成します。
- [/scrape - HTML 要素をスクレイプする](https://developers.cloudflare.com/browser-run/quick-actions/scrape-endpoint/index.md): Browser Run の /scrape エンドポイントを使い、特定の Web ページ要素から構造化データを抽出します。
- [/screenshot - スクリーンショットを取得する](https://developers.cloudflare.com/browser-run/quick-actions/screenshot-endpoint/index.md): Browser Run の /screenshot エンドポイントを使い、完全にレンダリングされた Web ページのスクリーンショットを取得します。
- [/snapshot - 複数のページ形式を取得する](https://developers.cloudflare.com/browser-run/quick-actions/snapshot/index.md): Browser Run の /snapshot リクエスト 1 回で、Web ページから HTML、スクリーンショット、Markdown、アクセシビリティツリーを取得します。

## Chrome DevTools Protocol（CDP）

- [Chrome DevTools Protocol（CDP）](https://developers.cloudflare.com/browser-run/cdp/index.md): /devtools エンドポイント経由で Chrome DevTools Protocol（CDP）コマンドを使い、永続的なブラウザーセッションの作成、タブの管理、ブラウザー操作ができます。
- [MCP クライアントでの利用（CDP）](https://developers.cloudflare.com/browser-run/cdp/mcp-clients/index.md): chrome-devtools-mcp パッケージを使い、MCP 経由で AI コーディングエージェントが Browser Run セッションを操作できるように設定します。
- [Playwright での利用（CDP）](https://developers.cloudflare.com/browser-run/cdp/playwright/index.md): 任意の Node.js 環境から Playwright を Browser Run セッションに接続し、Chrome DevTools Protocol でブラウザー操作を自動化します。
- [Puppeteer で使う（CDP）](https://developers.cloudflare.com/browser-run/cdp/puppeteer/index.md): 任意の Node.js 環境から Puppeteer を Browser Run セッションに接続し、Chrome DevTools Protocol でブラウザー操作を自動化します。
- [セッション管理（HTTP）](https://developers.cloudflare.com/browser-run/cdp/session-management/index.md): HTTP エンドポイントでブラウザーセッションとタブを管理します。セッションの作成、ターゲットの一覧取得、Chrome DevTools UI の表示を含みます。

## Playwright

- [Playwright](https://developers.cloudflare.com/browser-run/playwright/index.md): Cloudflare Workers で Playwright を使い、ブラウザー自動化を行う方法を説明します。Playwright API の利用、セッション管理、Browser Run の最適化を扱います。
- [Playwright MCP](https://developers.cloudflare.com/browser-run/playwright/playwright-mcp/index.md): Browser Run を使う Playwright MCP サーバーをデプロイし、エージェントにブラウザー自動化機能を提供します。

## Puppeteer

- [Puppeteer](https://developers.cloudflare.com/browser-run/puppeteer/index.md): Cloudflare Workers で Puppeteer を使い、ブラウザを自動化します。Puppeteer API、セッション管理、Browser Run の最適化を確認します。

## Stagehand

- [Stagehand](https://developers.cloudflare.com/browser-run/stagehand/index.md): Browser Run を使う Stagehand サーバーをデプロイし、エージェントにブラウザー自動化を提供します。

## Kitesurf

- [Kitesurf](https://developers.cloudflare.com/browser-run/kitesurf/index.md): Cloudflare のステートレスでエージェント向けのブラウザー Kitesurf は、Workers 上で完結して動作します。Browser Run と組み合わせて、スクリーンショット、HTML 抽出、自動化に使えます。

## よくある質問

- [よくある質問](https://developers.cloudflare.com/browser-run/faq/index.md): Browser Run のエラー、トラブルシューティング、セッション管理など、よくある質問への回答です。

## 制限

- [制限](https://developers.cloudflare.com/browser-run/limits/index.md): Browser Run の制限について説明します。

## 料金

- [料金](https://developers.cloudflare.com/browser-run/pricing/index.md): Quick Actions と Browser Sessions の Browser Run 料金を把握します。ブラウザー時間と同時ブラウザー数のコストを含みます。

## 変更履歴

- [変更履歴](https://developers.cloudflare.com/browser-run/changelog/index.md): Browser Run の最近の変更を確認します。

## features

- [カスタムフォント](https://developers.cloudflare.com/browser-run/features/custom-fonts/index.md): スクリーンショットと PDF で使うカスタムフォントを、Browser Run に追加する方法です。
- [Guardrails](https://developers.cloudflare.com/browser-run/features/guardrails/index.md): 宛先ホスト名で HTTP と HTTPS リクエストを制限します。
- [Human in the Loop](https://developers.cloudflare.com/browser-run/features/human-in-the-loop/index.md): 認証、機密操作、完全な自動化が難しい作業では、ブラウザの操作を一時的に人間に引き継ぎます。
- [Live View](https://developers.cloudflare.com/browser-run/features/live-view/index.md): Dashboard、生成した Live View URL、または Chrome DevTools から、アクティブな Browser Run セッションを監視し、操作します。
- [セッションの再利用](https://developers.cloudflare.com/browser-run/features/reuse-sessions/index.md): 新しいインスタンスを起動せず、既存のブラウザーセッションに再接続して、Browser Run の性能を高めます。
- [セッション録画](https://developers.cloudflare.com/browser-run/features/session-recording/index.md): Browser Run セッションを録画し、再生して、ブラウザー自動化スクリプトを視覚的にデバッグします。
- [WebMCP](https://developers.cloudflare.com/browser-run/features/webmcp/index.md): WebMCP を使い、Web サイトが公開する構造化ツールを AI エージェントが発見して実行できるようにします。壊れやすいスクリーンショット解析とクリックの繰り返しを、直接の関数呼び出しに置き換えます。

## how-to

- [Durable Objects で Browser Run Worker をデプロイする](https://developers.cloudflare.com/browser-run/how-to/browser-run-with-do/index.md): Browser Run API と Durable Objects を使い、Web ページのスクリーンショットを撮影して R2 に保存します。
- [Browser Run Worker をデプロイする](https://developers.cloudflare.com/browser-run/how-to/deploy-worker/index.md): Browser Run を使って Web ページのスクリーンショットを取得する Cloudflare Worker を作成し、デプロイします。
- [Astro サイト向けに OG 画像を生成する](https://developers.cloudflare.com/browser-run/how-to/og-images-astro/index.md): Browser Run を使い、Astro サイトの各ページ向けに Open Graph のソーシャルプレビュー画像を自動生成します。
- [HTML と CSS で PDF を生成する](https://developers.cloudflare.com/browser-run/how-to/pdf-generation/index.md): Puppeteer または Quick Actions で Browser Run を使い、Web ページやカスタム HTML / CSS から PDF を生成します。
- [クローラー向けにページをプリレンダリングする](https://developers.cloudflare.com/browser-run/how-to/pre-render-pages/index.md): Browser Run で JavaScript が多いページをレンダリングし、Worker からクローラー向けの HTML を返します。
- [Queues と Browser Run で Web クローラーを作る](https://developers.cloudflare.com/queues/tutorials/web-crawler-with-browser-run/index.md): Cloudflare Queues と Browser Run を使い、URL を非同期処理するスケーラブルな Web クローラーを構築します。

## reference

- [自動リクエストヘッダー](https://developers.cloudflare.com/browser-run/reference/automatic-request-headers/index.md): Browser Run のすべてのリクエストに Cloudflare が自動で付けるヘッダー（User-Agent やボット検出用の識別子を含む）を確認します。
- [ブラウザー終了の理由](https://developers.cloudflare.com/browser-run/reference/browser-close-reasons/index.md): Browser Run セッションが終了した理由を特定し、ダッシュボードでよくある終了理由コードを確認します。
- [robots.txt とサイトマップ](https://developers.cloudflare.com/browser-run/reference/robots-txt/index.md): Browser Run がサイトへアクセスする方法を制御するため、robots.txt ルールとサイトマップを設定します。
- [対応フォント](https://developers.cloudflare.com/browser-run/reference/supported-fonts/index.md): Browser Run の Chromium 環境に事前インストールされているフォントの一覧です。スクリーンショットと PDF で使えます。
- [Quick Actions のタイムアウト](https://developers.cloudflare.com/browser-run/reference/timeouts/index.md): ページ読み込み、セレクター待機、アクション実行向けに、Browser Run Quick Actions のタイムアウトを設定します。
- [Wrangler](https://developers.cloudflare.com/browser-run/reference/wrangler/index.md): Cloudflare の Workers Browser Run API を使うプロジェクトを、コマンドラインツール Wrangler でデプロイします。
- [Wrangler コマンド](https://developers.cloudflare.com/browser-run/reference/wrangler-commands/index.md): Wrangler を使い、コマンドラインから Browser Run セッションを管理します。