readfetch_scrape
Paid routes require a funded Base USDC wallet. Use readfetch-client / @readfetch/client or the MCP signing proxy (@readfetch/mcp-x402-proxy). Direct calls without a signing client will stop at 402. Load a public URL in headless Chromium and return Markdown, plain text, or HTML (format, plus status_code, title, billed; optional links via advanced.include_links). mode sets latency and depth: fast (15 s, minimal render), render (30 s, default, full JS), full (60 s, scroll the page). Put scroll, wait_for, js_code, headers, cookies, and auth in advanced (options is deprecated, same shape). Prefer readfetch_text when JavaScript is not required; readfetch_fetch for raw HTTP/API bytes; readfetch_residential when the site blocks datacentre IPs; readfetch_screenshot for a PNG/JPEG. Bot-check or empty extractions may return billed: false with a hint.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "readfetch_scrape"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public http(s) URL to load in Chromium. | |
| auth | No | Optional cookie, bearer, or basic auth for the page load. | |
| mode | No | Whole-call budget and render depth: fast (15 s), render (30 s, default), or full (60 s with page scroll). | render |
| format | No | Primary body field returned: markdown (default), plain text, or raw HTML. | markdown |
| options | No | Deprecated — use `advanced` instead (same ScrapeOptions shape). Scheduled for removal in a future API semver bump. | |
| advanced | No | Browser interactions: scroll, wait_for selector, js_code, headers, cookies, locale, include_links, etc. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| title | No | ||
| billed | No | ||
| status | No | ||
| markdown | No | ||
| status_code | No |