session_screenshot
Captures the current page of an open browser session and returns it inline as an image, so you can visually inspect layout, images, captcha, or rendering.
Instructions
Take a screenshot of the session's current page and return it as an image.
Use it when you need to SEE the page (layout, images, a captcha, whether something rendered); session_snapshot is cheaper for reading text and finding selectors. Requires a session opened with profile_start first. The image comes back inline — nothing is written to disk.
Size is capped so it does not flood your context: at most 2000 px on the longest side, in CSS pixels. A full page bigger than that falls back to the visible viewport (scroll with session_eval, e.g. "window.scrollBy(0, innerHeight)", and take another); a PNG over 1 MB is re-taken as JPEG. What happened is said in the returned info.
Args: name: identity name, exactly as profiles_list reports it. full_page: true for the whole scrollable page, false (default) for what is visible in the window.
Returns the image, then {format, width, height, full_page, bytes, note?}. Fails with a readable message if the session is not open (409 — call profile_start first), the identity does not exist (404), or the visible window itself is over 2000 px (needs Nullprint 0.2.31+ on high-DPI displays; otherwise make the window smaller).
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": {
"name": "<name>"
},
"name": "session_screenshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| full_page | No |