puppeteer_screenshot
Capture screenshots of web pages or specific elements using CSS selectors, with customizable dimensions, for browser automation tasks on Linux display servers.
Instructions
Take a screenshot of the current page or a specific element
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| height | No | Height in pixels (default: 600) | |
| name | Yes | Name for the screenshot | |
| selector | No | CSS selector for element to screenshot | |
| width | No | Width in pixels (default: 800) |
Implementation Reference
- index.ts:225-259 (handler)The main handler logic for the 'puppeteer_screenshot' tool. Sets the viewport to specified dimensions, captures a screenshot of the entire page or a specific element using the provided selector, stores the base64-encoded image, notifies the client of resource changes, and returns the image along with a success message.case "puppeteer_screenshot": { const width = args.width ?? 800; const height = args.height ?? 600; await page.setViewport({ width, height }); const screenshot = await (args.selector ? (await page.$(args.selector))?.screenshot({ encoding: "base64" }) : page.screenshot({ encoding: "base64", fullPage: false })); if (!screenshot) { return { content: [{ type: "text", text: args.selector ? `Element not found: ${args.selector}` : "Screenshot failed", }], isError: true, }; } screenshots.set(args.name, screenshot); server.notification({ method: "notifications/resources/list_changed", }); return { content: [ { type: "text", text: `Screenshot '${args.name}' taken at ${width}x${height}`, }, { type: "image", data: screenshot, mimeType: "image/png", }, ], isError: false, }; }
- index.ts:114-127 (schema)The tool schema definition, specifying the name, description, and input schema with required 'name' parameter and optional 'selector', 'width', and 'height'.{ name: "puppeteer_screenshot", description: "Take a screenshot of the current page or a specific element", inputSchema: { type: "object", properties: { name: { type: "string", description: "Name for the screenshot" }, selector: { type: "string", description: "CSS selector for element to screenshot" }, width: { type: "number", description: "Width in pixels (default: 800)" }, height: { type: "number", description: "Height in pixels (default: 600)" }, }, required: ["name"], }, },
- index.ts:447-449 (registration)Registers the puppeteer_screenshot tool (among others) by including it in the TOOLS array returned in response to ListToolsRequest.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS, }));
- index.ts:451-451 (registration)Registers the call handler for all tools, including puppeteer_screenshot, which dispatches to the specific implementation in handleToolCall.server.setRequestHandler(CallToolRequestSchema, async (request) => handleToolCall(request.params.name, request.params.arguments ?? {}));