Screenshot

What it does

Takes a full-page PNG screenshot of any public URL using headless Chromium. Returns the image as a base64 PNG. SSRF-hardened — private IP ranges, 169.254.x metadata endpoints, and file:// URIs are blocked. Useful when an agent needs a visual record of a page state, or when content is rendered in a format that cannot be extracted as text.

When to use it

• Capture a dashboard state for a monitoring agent
• Archive a visual record of a web page at a point in time
• Render a UI for visual QA within an agent workflow

Request schema

{
  "url": "https://example.com",
  "full_page": true
}

Response schema

{
  "image": "iVBORw0KGgoAAAANSUhEUgA...",
  "encoding": "base64",
  "format": "png",
  "width": 1280,
  "height": 900
}

Code example — TypeScript via MCP

Install the MCP server once; all 16 services become tool calls.

// Configure @melis-ai/x402-tools-mcp in your MCP client
// Then call the tool:

const result = await mcpClient.callTool("screenshot", {
  "url": "https://example.com",
  "full_page": true
});

console.log(result);
// ["image","encoding","format","width","height"]...

Code example — Python via direct HTTP

import requests

# x402 payment header must be set by your wallet client
# See x402.org for client libraries

headers = {
    "Content-Type": "application/json",
    "x-payment": "<signed-x402-payment-header>",
}

resp = requests.post(
    "https://api.melis.ai/screenshot",
    json={
      "url": "https://example.com",
      "full_page": true
    },
    headers=headers,
)
print(resp.json())

Code example — curl with internal key bypass

For testing with an issued internal key (skips x402 payment flow):

curl -X POST https://api.melis.ai/screenshot \
  -H "Content-Type: application/json" \
  -H "x-internal-key: YOUR_KEY" \
  -d '{"url":"https://example.com","full_page":true}'

How is this different from alternatives?

Related services

FAQ