inspect
Open a URL in the logged-in recording profile and list visible interactive elements with ranked unique selectors, headings, and iframes so you can write reliable automation targets without selector guessing.
Instructions
Open a URL in the recording profile (logged-in state included) and list every visible interactive element with UNIQUE selectors ranked data-testid → id → aria-label → role/text → name/placeholder → class → path, plus headings and iframes. Use it BEFORE writing targets — no selector guessing, no wasted probe. Writes logs/inspect-.json and a screenshot in the demo dir. Returns a jobId immediately — poll job_status. Rejects if another job is running.
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": {
"dir": "<dir>",
"url": "<url>"
},
"name": "inspect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dir | Yes | demo project directory — pass an absolute path | |
| url | Yes | page to inspect (absolute URL) | |
| limit | No | max elements (default 80) | |
| frames | No | iframe selectors to scan too, as in the storyboard `frames` block | |
| profile | No | Chrome user-data dir (default: the recording profile) | |
| headless | No | default true | |
| useSetup | No | honour the storyboard's setup block (storageState/cookies/preflight) so an authenticated page can be scanned. Default true. | |
| viewport | No | default 1280x720 (use the storyboard's video size) | |
| storageState | No | extra Playwright storageState JSON to seed before the scan |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| jobId | Yes | ||
| status | Yes | ||
| demoDir | Yes | resolved absolute demo directory | |
| logFile | Yes |