inspect_page
Analyze web pages to generate structured maps of interactive elements, headings, forms, links, and images with unique CSS selectors for reliable automation workflows.
Instructions
Inspect a web page and get a structured map of all interactive elements, headings, forms, links, and images — each with a unique CSS selector. Use this BEFORE run_sequence or record_video to discover what elements exist on the page and get reliable selectors. Returns text (not an image), so it is fast and cheap. Costs 1 API request.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | URL to inspect (required if no html) | |
| html | No | Raw HTML to inspect (required if no url) | |
| width | No | Viewport width in pixels (default: 1280) | |
| height | No | Viewport height in pixels (default: 720) | |
| viewportDevice | No | Device preset for viewport emulation (e.g. "iphone_14_pro"). Use list_devices to see all presets. | |
| viewportMobile | No | Enable mobile meta viewport emulation | |
| viewportHasTouch | No | Enable touch event emulation | |
| viewportLandscape | No | Landscape orientation | |
| deviceScaleFactor | No | Device pixel ratio (default: 1) | |
| waitUntil | No | When to consider navigation finished (default: networkidle2) | |
| waitForSelector | No | Wait for this CSS selector to appear before inspecting | |
| navigationTimeout | No | Navigation timeout in ms (default: 25000) | |
| darkMode | No | Emulate dark color scheme (default: false) | |
| reducedMotion | No | Emulate prefers-reduced-motion | |
| mediaType | No | Emulate CSS media type | |
| timeZone | No | Override browser timezone | |
| geolocation | No | Emulate geolocation | |
| userAgent | No | Override the browser User-Agent string | |
| cookies | No | Cookies to set — array of "name=value" strings or { name, value, domain? } objects | |
| headers | No | Extra HTTP headers to send with the request | |
| authorization | No | Authorization header value (e.g. "Bearer <token>") | |
| bypassCSP | No | Bypass Content-Security-Policy on the page | |
| hideSelectors | No | Array of CSS selectors to hide before inspecting | |
| injectCss | No | Custom CSS to inject before inspecting | |
| injectJs | No | Custom JavaScript to execute before inspecting | |
| blockBanners | No | Hide cookie consent banners (default: false) | |
| blockAds | No | Block advertisements on the page | |
| blockChats | No | Block live chat widgets | |
| blockTrackers | No | Block tracking scripts | |
| blockRequests | No | URL patterns to block | |
| blockResources | No | Resource types to block |