Tool Find Element By Intent

Category: Browser Automation · Tier: All

AI-powered semantic element finding with ARIA-first selector strategy. Priority: aria-label > role > semantic HTML > ID > name > class. Returns selectorType, accessibilityScore (0-1), and alternatives. Set verbose=true for enriched failure responses.

When to Use

Browser automation tools map to human motor interaction research. Click accuracy, form filling speed, and scroll behavior follow HCI models.

Parameters

Parameter	Type	Required	Description
intent	string	Yes	Natural language description like 'the cheapest product' or 'login form'
verbose	boolean	No	Include alternative matches with confidence scores and AI suggestions

Example

Find the element that lets users submit their application

Tips

• Pass _browserToken from a previous tool call to maintain the same browser session
• The tool returns a _browserToken in its response — pass it to subsequent calls
• Without _browserToken, each call gets a fresh browser (blank page)

Research

• Grossman & Balakrishnan (2005) — Probabilistic pointing models for click targets
• Fitts' Law — Movement time = a + b × log₂(D/W + 1)

Related

• Tools Overview — All 120 tools by category