playwright-browser-take-screenshot

To take a screenshot of a page or element, capture an image for visual verification.

⭐6stars🔀3forks📁View on GitHub🕐Updated Jan 7, 2026⬇️1downloads

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.
nameplaywright-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>"}}