Browser Snapshot Node

B

Automation/Browser/Snapshot

Captures the page accessibility tree as compact text with element refs (e1, e2, …) that any selector pin accepts as a Ref selector. Refs stay valid until the page navigates or the element is removed; a stale ref fails with a request to take a new snapshot. Covers the current tab including same-site and cross-site iframes (up to 20 frames). Requires Chrome or Edge.

browser_snapshotautomationLocal only

Inputs7

Outputs8

Security exposure6/10

Packageautomation

Ratings

Scores range from 0 to 10. Higher values mean more impact, exposure, or operational weight.

SecurityAttack surface and exposure impact.

6/10Medium

PrivacyPotential sensitivity of processed data.

4/10Medium

PerformanceRuntime or resource pressure.

6/10Medium

GovernancePolicy, audit, or compliance impact.

6/10Medium

ReliabilityOperational stability considerations.

8/10High

CostExternal or compute cost impact.

9/10High

Input Pins

7

▶

Execution

exec_in

Trigger

Session

Struct

session

Automation session

SchemaAutomationSessionAutomationSessionAutomationSession11 fields

session_refstringrequired

platformPlatformrequired

enum "Windows", "MacOS", "Linux"

default_delay_msinteger:uint64required

format uint64min 0

click_delay_msinteger:uint64required

format uint64min 0

debug_modebooleanrequired

browser_typeanyOf (2)

Browser context info if browser is attached

variant 1BrowserTypevariant

enum "Chrome", "Firefox", "Edge", "Safari"

variant 2nullvariant

browser_headlessboolean | null

browser_user_data_dirstring | null

current_page_refstring | null

Current page info if a page is open

current_window_handlestring | null

browser_frame_selectorsArray<Selector>

default []

itemsSelectorarray item

kindSelectorKindrequired

variant 1enumvariant

enum "Css", "Xpath", "TextExact", "TestId"...

variant 2constvariant

Visible text contained in the element; script, style and head content is ignored.

const "Text"

variant 3constvariant

ARIA role, optionally filtered by accessible name: `button`, `button|Sign in` (case-insensitive substring), `button|=Sign in` (exact) or `button|/^sign/i` (regex).

const "Role"

variant 4constvariant

Element ref from the latest Browser Snapshot, such as `e12`.

const "Ref"

valuestringrequired

confidencenumber | null

format double

scopestring | null

Interactive Only

Boolean

interactive_only

List only interactive elements (buttons, links, inputs, clickable elements) as a flat list; disable for the full page structure with text

Default true

Max Depth

Integer

max_depth

Maximum nesting depth of listed elements (-1 for unlimited)

Default -1

Scope Ref

String

scope_ref

Optional ref from an earlier snapshot of this page; only its subtree is captured

Max Characters

Integer

max_chars

Maximum length of the snapshot text; longer snapshots are cut and flagged as truncated

Default 15000

Detect Clickable

Boolean

detect_clickable

Also list elements without an interactive role that have a pointer cursor, onclick or tabindex

Default true

Output Pins

8

▶

Execution

exec_out

Continue

Session

Struct

session_out

Updated automation session

SchemaAutomationSessionAutomationSessionAutomationSession11 fields

session_refstringrequired

platformPlatformrequired

enum "Windows", "MacOS", "Linux"

default_delay_msinteger:uint64required

format uint64min 0

click_delay_msinteger:uint64required

format uint64min 0

debug_modebooleanrequired

browser_typeanyOf (2)

Browser context info if browser is attached

variant 1BrowserTypevariant

enum "Chrome", "Firefox", "Edge", "Safari"

variant 2nullvariant

browser_headlessboolean | null

browser_user_data_dirstring | null

current_page_refstring | null

Current page info if a page is open

current_window_handlestring | null

browser_frame_selectorsArray<Selector>

default []

itemsSelectorarray item

kindSelectorKindrequired

variant 1enumvariant

enum "Css", "Xpath", "TextExact", "TestId"...

variant 2constvariant

Visible text contained in the element; script, style and head content is ignored.

const "Text"

variant 3constvariant

ARIA role, optionally filtered by accessible name: `button`, `button|Sign in` (case-insensitive substring), `button|=Sign in` (exact) or `button|/^sign/i` (regex).

const "Role"

variant 4constvariant

Element ref from the latest Browser Snapshot, such as `e12`.

const "Ref"

valuestringrequired

confidencenumber | null

format double

scopestring | null

Snapshot

String

snapshot

Indented text such as `- button "Sign in" [ref=e12]`

Elements

Struct Array

elements

Listed elements in document order

SchemaSnapshotElementSnapshotElementSnapshotElement10 fields

refstring | null

Ref usable as a `Ref` selector until the document changes.

rolestringrequired

ARIA role; `text` for plain text lines.

namestring

default ""

valuestring | null

descriptionstring | null

textstring | null

levelinteger | null

format uint32min 0

urlstring | null

statesArray<string>

focused, disabled, checked, checked=mixed, pressed, expanded, collapsed, selected, required, readonly, invalid, cursor=pointer.

itemsstringarray item

depthinteger:uint32required

format uint32min 0

URL

String

url

Page URL

Title

String

title

Page title

Generation

Integer

generation

Snapshot counter for this session

Truncated

Boolean

truncated

Whether the snapshot exceeded Max Characters

Node Info

Internal name

browser_snapshot

Category

Automation/Browser/Snapshot

Version

1