capture-web-screenshot

Capture web screenshots & PDFs

Turn any public URL into an image or PDF hosted on a permanent CDN URL. Use the microlink_screenshot and microlink_pdf MCP tools.

Pick the tool

Goal	Tool	Result field
Image of a page (PNG/JPEG)	microlink_screenshot	microlink.data.screenshot.url
Printable/paginated document	microlink_pdf	microlink.data.pdf.url
Image plus metadata/palette in one call	microlink_extract with screenshot: true	microlink.data.screenshot.url

The response is structuredContent. Read the asset URL from microlink.data.<feature>.url, and check microlink.status === "success" first.

Screenshot recipes

Give each request a url plus a screenshot value. Pass screenshot: true for defaults, or an object to configure it. screenshot: {} behaves like true.

• Full page (entire scroll height): { "url": "...", "screenshot": { "fullPage": true } }
• Single element (crop to a selector): { "screenshot": { "element": "#hero" } }
• JPEG for smaller files: { "screenshot": { "type": "jpeg" } } (default is png)
• Transparent background: { "screenshot": { "omitBackground": true } }
• Marketing / OG image — wrap the page in browser chrome on a gradient: { "screenshot": { "overlay": { "browser": "dark", "background": "linear-gradient(45deg, #757abf, #8583be)" } } }
• Code snippet page — syntax theme: { "screenshot": { "codeScheme": "dracula" } }

Control the browser before capturing

These parameters work on both screenshot and PDF:

• device: emulate a device, e.g. "iPhone 12", "Pixel 5", "Macbook Pro 16".
• viewport: custom size, e.g. { "width": 1200, "height": 630 } (ideal OG ratio).
• colorScheme: "dark" or "light" to trigger the page's theme.
• click: CSS selector(s) to click first (dismiss a cookie banner, open a tab).
• scroll: CSS selector to scroll into view before shooting.
• styles / scripts: inject CSS/JS to hide clutter (e.g. hide a sticky nav).
• waitForSelector: wait until an element exists (good for lazy content).
• waitForTimeout: wait N ms extra for animations to settle.
• adblock: true: strip ads before capture.