Find elements by name
browser_findFind interactive elements by case-insensitive name match anywhere on a page, including off-screen areas, and tag them with refs for targeted clicks or form actions.
Instructions
Find interactive elements by case-insensitive name match anywhere on the page — including beyond the observe window on huge pages — and tag them with refs (f1, f2, ...). Free — no model call. The targeted way to act on dense pages: browser_find "Philips", then browser_click the returned ref. Works for links, buttons, and form fields. Returns {match_count, matches:[{ref, kind, role, name, value?, inViewport}]}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "browser_find"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| exact | No | Require the name to equal the query (case-insensitive) instead of substring matching. Default false. | |
| query | Yes | Text to match against element names/labels, e.g. "Philips" or "Sign in". | |
| max_results | No | Max matches (default 10); increase if the first result is not the one you want. |