Browser Run 无障碍树新端点

July 7, 2026

Browser Run 无障碍树新端点

Browser Run 现在支持独立的 /accessibilityTree 端点，为 Agent 和自动化工作流提供对已渲染网页浏览器无障碍树的直接访问。

无障碍树是浏览器对已渲染页面的结构化视图：角色、名称、状态、值和层级关系。它对无障碍工具很有用，同时也对需要页面结构而无需处理原始 HTML 噪音或截图成本的 AI Agent 和自动化工作流非常实用。

对于 AI Agent 而言，这意味着减少了从像素推断信息以及解析 HTML 的工作。您可以直接提供页面结构，帮助 Agent 识别可用元素并判断其可执行的操作。

使用新的 /accessibilityTree 端点，当您只需要页面的语义结构时，可以直接请求无障碍树。如果需要在单次 API 调用中获取多种页面格式，可以使用 /snapshot 端点，该端点同时返回 Markdown、HTML 和截图。

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/"
}'

{
	"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 文档以获取使用示例和支持的参数。