take_screenshot
Take screenshots of web pages using Puppeteer. Capture viewport or full-page. Choose output mode: base64 inline, file, or auto based on size. Designed for debugging and visual inspection.
Instructions
截图工具（辅助调试）。支持视口截图和全页截图。建议在使用前询问用户希望的输出方式：如果用户需要直接查看图片，使用 inline 模式返回 base64；如果用户需要保存图片文件，使用 file 或 auto 模式保存为文件。对于全页截图或大图片，强烈建议使用 file/auto 模式避免响应过大。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | 页面 URL（可选） | |
| fullPage | No | 是否截取整页。true 表示截取整个页面（包括需要滚动才能看到的内容），false 表示只截取当前视口可见部分。全页截图会自动触发懒加载内容，确保完整截图。 | |
| outputMode | No | 输出模式（建议在使用前询问用户偏好）： - auto：根据图片大小自动选择（小于阈值返回 base64，大于阈值保存为文件，默认阈值 100KB） - file：始终保存为文件，返回文件路径（适合用户明确需要保存文件的情况） - inline：始终返回 base64 编码的图片数据（适合用户需要直接查看小图片的情况，不推荐用于全页截图，因为会导致响应过大） 选择建议： - 如果用户说"截图"、"保存截图"、"下载截图"等，使用 file 或 auto 模式 - 如果用户说"显示截图"、"查看截图"、"预览截图"等，且图片较小（非全页），可以使用 inline 模式 - 如果用户未明确说明，或进行全页截图，默认使用 auto 模式 - 如果不确定用户需求，建议询问："您希望截图以什么方式返回？1) 保存为文件（推荐，适合大图片） 2) 直接返回图片数据（仅适合小图片）" | auto |
| filePath | No | 文件保存路径（可选，仅在 file/auto 模式时有效）。如果未指定，默认保存到 ./screenshots/screenshot-{timestamp}-{random}.png。可以使用相对路径（相对于 MCP Server 工作目录）或绝对路径。 | |
| maxBase64SizeKB | No | auto 模式阈值（KB，base64 大小，默认 100KB）。当 auto 模式下，如果图片的 base64 大小超过此阈值，会自动保存为文件；否则返回 base64。 | |
| scrollDelay | No | 滚动后等待时间（毫秒，用于触发懒加载，默认 1000） | |
| waitForSelector | No | 等待特定选择器加载（可选，字符串） |