Use Cloudflare Browser Run accessibility trees before agents guess from screenshots

Official Cloudflare changelog preview image for Browser Run updates.Cloudflare Changelog
Official Cloudflare changelog preview image for Browser Run updates.Cloudflare Changelog
AI & Automation

Cloudflare Browser Run now exposes a direct accessibility tree endpoint, giving AI agents and automation tools structured page context without relying only on screenshots or raw HTML.

Cloudflare Browser Run added a confirmed /accessibilityTree endpoint on July 7, 2026. It lets automation systems request the browser's structured accessibility tree for a page, including roles, names, states, values, and hierarchy. The practical value is simple: agents can inspect page structure directly instead of inferring every button, form, and heading from pixels or noisy HTML.

Structured browser accessibility tree for AI agent workflows
Structured browser accessibility tree for AI agent workflows
Image source: Cloudflare Changelog. Used here as the official cover/inline visual for the Browser Run update.

What changed

Cloudflare Browser Run now supports a standalone POST /accessibilityTree quick action. The endpoint returns the accessibility tree for a rendered URL, and Cloudflare positions it for accessibility tooling, AI agents, and browser automation workflows that need semantic page structure.

The endpoint can return the full page tree, only semantically meaningful nodes with interestingOnly, or a subtree selected with root. Cloudflare's docs also cover JavaScript-heavy pages: teams can use gotoOptions.waitUntil or waitForSelector when a page would otherwise return incomplete content.

FeatureBest fitAccessCaveat
/accessibilityTreeGive agents page roles, names, and hierarchyCloudflare Browser Run APIRequires a Browser Run account/API token
root selectorInspect one page sectionSame endpointMissing selectors return accessibilityTree: null
interestingOnlyReduce noise for agent promptsRequest parameterMay hide nodes needed for low-level UI tests
gotoOptions.waitUntilSPAs and JavaScript-heavy pagesRequest optionSlower when waiting for network idle

Why this is early

This is early because it appeared first in Cloudflare's developer changelog, not in a broad product announcement. The claim is credible because the public documentation already describes request patterns, response shapes, subtree handling, empty selector behavior, and JavaScript-heavy page guidance.

There is no need to treat this as a rumor. What remains to verify is operational: account availability, rate limits, pricing impact, and whether the returned tree is stable enough for your own target pages.

Key takeaways

  • Cloudflare Browser Run can now return page structure directly through /accessibilityTree.
  • AI agents can use roles, names, and hierarchy instead of relying only on screenshots or scraped HTML.
  • The endpoint supports subtree capture with root and semantic filtering with interestingOnly.
  • JavaScript-heavy pages may need explicit load waits to avoid empty or incomplete trees.
  • This is most useful for browser agents, QA automation, accessibility checks, and agent prompt context compression.

Availability and access

Cloudflare documents the endpoint as part of Browser Run quick actions. Users need Cloudflare API access for Browser Run and an account ID in the endpoint path. LinkLoot did not find a separate pricing note in the cited changelog entry, so teams should check their Cloudflare plan, Browser Run quota, and API rate limits before routing production agent traffic through it.

The update is available through API calls, not as a standalone no-code UI. Teams already running browser automation can test it by sending a target URL and comparing the returned tree with their current screenshot, Markdown, or HTML extraction flow.

Practical LinkLoot angle

For agent builders, this is a better first pass than asking a model to describe a screenshot. Use the accessibility tree to identify candidate controls, then reserve screenshots for visual confirmation, layout checks, and failure debugging.

For QA teams, the endpoint can reduce flaky selectors when the visible page is complex but the semantic structure is stable. For accessibility work, it gives a fast machine-readable view of names and roles before a deeper manual audit.

If you are building browser agents, pair this with LinkLoot's AI agent tools guide and treat the tree as input evidence, not an instruction source. Source pages, web content, and rendered app text can still contain prompt injection attempts.

What to verify before you act

  • Confirm Browser Run is enabled for your Cloudflare account and region.
  • Test representative SPAs with gotoOptions.waitUntil or waitForSelector.
  • Compare interestingOnly: true and false before compressing agent prompts.
  • Check quota, rate limits, and billing before adding the endpoint to long-running agents.
  • Keep screenshot fallback for visual state, canvas content, drag targets, and pages with weak accessibility metadata.

Source check

Confirmed by:

  • Cloudflare's July 7, 2026 changelog entry for the new Browser Run /accessibilityTree endpoint.
  • Cloudflare's Browser Run documentation for full-tree capture, subtree capture, empty selector behavior, JavaScript-heavy pages, and custom user agent support.

Early signal / context:

  • The larger agent workflow angle is an editorial interpretation based on Cloudflare's stated use cases for AI agents and automation workflows. LinkLoot will treat future pricing, quota, or availability changes as update triggers rather than assuming them from this release.
FAQ

It is a Browser Run API endpoint that returns the rendered page's accessibility tree, including roles, names, hierarchy, and related structure.