Browser Run - New Browser Run endpoint for accessibility trees

概要

Browser Run に standalone の /accessibilityTree エンドポイントが追加され、エージェントや自動化ワークフローがレンダリング済みページのブラウザアクセシビリティツリーに直接アクセスできるようになりました。

アクセシビリティツリーは、レンダリングされたページの構造化ビュー（roles、names、states、values、階層など）です。アクセシビリティツール向けに有用であるだけでなく、AI エージェントや自動化ワークフローが生の HTML のノイズやスクリーンショットのコストを避けてページ構造を取得するのに役立ちます。

主な利点:

• AI エージェント: ピクセルからの推論や HTML のパースを減らし、ページ上の利用可能な要素を直接識別して実行可能なアクションを判断しやすくなります。
• 自動化ワークフロー: 意味的な構造のみを取得することで、不要なデータ取得や処理を削減できます。

/accessibilityTree エンドポイントは、ページのセマンティックな構造だけが必要な場合に直接リクエストしてください。複数形式（Markdown、HTML、スクリーンショットなど）が同一 API 呼び出しで必要な場合は、/snapshot エンドポイントを使用してください。

---

使い方（リクエスト例）

次は典型的な curl リクエスト例です。<accountId> と <apiToken> は適宜置き換えてください。

curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-run/accessibilityTree' \
  -H 'Authorization: Bearer <apiToken>' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://example.com/" }'

---

レスポンス例

以下はサンプルの JSON レスポンスです。

{
  "success": true,
  "result": {
    "accessibilityTree": {
      "role": "RootWebArea",
      "name": "Example Domain",
      "children": [
        { "role": "heading", "name": "Example Domain", "level": 1 },
        { "role": "link", "name": "Learn more" }
      ]
    }
  }
}

---

パラメータ

• interestingOnly: 意味的に重要なノードのみを返すオプション。ノイズとなる補助的ノードを除外して、主要な要素に集中できます。
• root: 特定のサブツリーのアクセシビリティツリーをキャプチャするためのオプション。ページ全体ではなく部分ツリーを取得したい場合に使用します。

詳細な使用例やサポートされているパラメータについては、/accessibilityTree ドキュメントを参照してください。

---

参照

• 複数フォーマット（Markdown、HTML、スクリーンショット等）が必要な場合: /snapshot
• ドキュメント: /accessibilityTree（利用例とパラメータ参照）

Published: Jul 07, 2026