take_screenshot
Capture a screenshot of any URL and return a public image URL.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
url | string | Yes | - | The URL to screenshot |
width | number | No | 1280 | Viewport width in pixels (320-3840) |
height | number | No | 800 | Viewport height in pixels (240-2160) |
fullPage | boolean | No | false | Capture full scrollable page |
format | string | No | "png" | png, jpeg, or webp |
delay | number | No | 0 | Wait ms after page load (0-10000) |
cookieConsent | string | No | "auto" | Dismiss common cookie consent overlays before capture. Use none to preserve banners exactly as shown. |
waitFor | string | No | - | CSS selector or selector group to wait for before capture. Timeout is best-effort. |
waitUntil | string | No | "networkidle" | Navigation load state: networkidle, load, domcontentloaded, or none. |
timeoutMs | number | No | 10000 | Timeout for navigation, waitFor, and clickBefore. |
preScreenshotJs | string | No | - | JavaScript to evaluate immediately before capture. |
deviceScaleFactor | number | No | 1 | Browser DPR. Use 2 for retina mobile captures. |
clickBefore | string | No | - | CSS selector to click before waitFor and capture. |
Example
Take a screenshot of https://stripe.com at 1440x900Response
Returns the captured URL, public Evidence screenshot URL, dimensions, elapsed time, and job ID. MCP clients that render Markdown may also show the preview image inline.
Notes
- Screenshots are stored on Cloudflare R2 with global CDN delivery
- The page is loaded with a real Chromium browser with stealth mode enabled
- Cookie consent overlays are dismissed by default for cleaner product screenshots; pass
cookieConsent: "none"for compliance screenshots that must show the first-load banner - For JS-heavy SPAs, pass
waitForwith a selector group such asmain, h1, .hero; if it times out, DeepSyte returns the best-effort capture - Use
preScreenshotJsto remove chat widgets, dialogs, app banners, or other page chrome immediately before capture - Supports JavaScript-rendered pages (SPAs, React, etc.)