playwright-browser-take-screenshot
To take a screenshot of a page or element, capture an image for visual verification.
When & Why to Use This Skill
The playwright-browser-take-screenshot skill enables Claude to capture high-quality visual snapshots of entire web pages or specific DOM elements. It supports multiple image formats (PNG/JPEG) and full-page rendering, providing essential visual verification capabilities for automated browser workflows, UI testing, and digital content documentation.
Use Cases
- Visual Regression Testing: Automatically capture screenshots of web interfaces to detect layout shifts or UI inconsistencies during the development lifecycle.
- Automated Bug Reporting: Generate and save visual evidence of front-end errors or rendering issues to provide developers with clear context for debugging.
- Web Content Archiving: Create full-length snapshots of scrollable web pages for compliance, historical records, or offline content review.
- UI/UX Design Audits: Extract specific UI components or elements as images to verify design system adherence and visual fidelity across different screen sizes.
| name | playwright-browser-take-screenshot |
|---|---|
| description | "To take a screenshot of a page or element, capture an image for visual verification." |
Usage
Use the MCP tool dev-swarm.request to send the payload as a JSON string:
{"server_id":"playwright","tool_name":"browser_take_screenshot","arguments":{}}
Tool Description
Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.
Arguments Schema
The schema below describes the arguments object in the request payload.
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"png",
"jpeg"
],
"default": "png",
"description": "Image format for the screenshot. Default is png."
},
"filename": {
"type": "string",
"description": "File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified. Prefer relative file names to stay within the output directory."
},
"element": {
"type": "string",
"description": "Human-readable element description used to obtain permission to screenshot the element. If not provided, the screenshot will be taken of viewport. If element is provided, ref must be provided too."
},
"ref": {
"type": "string",
"description": "Exact target element reference from the page snapshot. If not provided, the screenshot will be taken of viewport. If ref is provided, element must be provided too."
},
"fullPage": {
"type": "boolean",
"description": "When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Cannot be used with element screenshots."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}
Background Tasks
If the tool returns a task id, poll the task status via the MCP request tool:
{"server_id":"playwright","method":"tasks/status","params":{"task_id":"<task_id>"}}