observe
Reads a browser page as compact, token-budgeted text and returns element IDs for use with the act tool.
Instructions
Read the page of a browser started with start_browser, as compact text: one line per element, [id] role "name" state, inside a token budget. Use the ids with the act tool. No Playwright or CDP needed, and no extra charge. Ids stay valid across observe and act calls until the page loads a new document. On a full-page bot check nothing is read and the first lines say so.
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": {
"browser_id": "<browser_id>"
},
"name": "observe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tab | No | Tab id, from the tabs line of an earlier observe. Default: the tab used last. | |
| scope | No | viewport (default): what is in the viewport, the rest counted. page: the whole page. | |
| budget | No | Approximate tokens for the view. Default 2000. | |
| expand | No | Id of a container, table, list or select to list in full. | |
| browser_id | Yes | The id returned by start_browser. |