capture_screenshot
Capture a screenshot of a specific Figma node or the entire page as PNG or SVG for visual inspection and automated analysis in design workflows.
Instructions
Capture a screenshot of a specific Figma node or the entire current page, returned as image data.
Prerequisites: Requires Figma bridge running and plugin connected. Use check_bridge_health to verify. Node IDs can be retrieved from get_selection or get_page_tree.
Returns on success: An image content block — { type: "image", data: base64 string, mimeType: "image/png" or "image/svg+xml" }. The image is returned directly in the response and can be passed to analyze_design for visual analysis.
Error behavior: Throws "Figma not connected" if plugin is not connected. Returns a bridge error if the node ID is invalid or the node is not visible.
Use this tool: to visually inspect a component or frame before/after mutations, as the first step in the self-heal loop (CREATE → SCREENSHOT → ANALYZE → FIX), or to feed a node image into analyze_design. Prefer SVG for vector components and PNG for complex frames.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nodeId | No | Figma node ID to capture (e.g. '123:456'). Omit to capture the entire current page. Obtain IDs from get_selection or get_page_tree. | |
| format | No | Export format. PNG for raster output (default, works for all node types). SVG for vector output (best for icons and simple components). | PNG |
| scale | No | Export scale multiplier (default 2 = @2x). Use 1 for quick inspection, 2–3 for high-quality analysis. |