web_scrape
Scrape a URL into markdown, HTML, links or metadata. A URL that maps onto a dedicated endpoint (currently Reddit pages) returns that endpoint's structured response instead; pass dedicated=false for the scraped page.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "web_scrape"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The absolute http(s) URL to scrape. | |
| proxy | No | Optional: route egress through your OWN proxy (http/https/socks5 URL, credentials allowed) — e.g. your residential/mobile proxy. Used for the HTTP tier and the proxy-capable browser backend. Must resolve to a public address. | |
| render | No | Fetch strategy: auto (Chrome-impersonated HTTP, then escalate to a real headless browser when blocked or JS-rendered), http (Chrome-impersonated HTTP, no JavaScript), browser (headless browser that executes JavaScript), or unblocker (route through a managed anti-bot unblocker for the hardest sites — premium, billed higher; only when configured). Defaults to auto. | |
| backend | No | Advanced (browser render only): pin a single headless-browser backend instead of the auto-selected fleet, e.g. camoufox, cloakbrowser, lightpanda, chrome-headless-shell. Mainly for diagnosing which engine gets through a given site. Unknown/unavailable backend falls back to the HTTP tier. | |
| formats | No | Output formats to include. Allowed values: markdown, html, raw_html, links, link_details, metadata. 'links' is a deduplicated list of absolute URLs; 'link_details' is one {text, href, rel} object per anchor (not deduplicated). Defaults to ["markdown"]. | |
| max_age | No | Cache: return a recently-cached copy if it is younger than this many milliseconds, otherwise re-fetch and refresh the cache. 0 forces a fresh fetch (bypasses the cache read). Omitted uses the server default (7 days); capped at 7 days. A cache hit is billed at a reduced credit weight. Bypassed when 'proxy' or 'backend' is set. | |
| wait_for | No | Browser rendering only: extra milliseconds to wait for client-side content to settle after load (0-25000). Ignored for the HTTP tier. Default 0. | |
| dedicated | No | Routing: when the URL maps onto a dedicated endpoint this API already offers for that site (currently Reddit listings, searches, comment threads, user and domain pages), the dedicated endpoint's own structured response is returned instead of a scraped page, at that endpoint's credit price. Defaults to true. Set false to always get the scraped page content. Ignored when proxy or backend is set. | |
| store_in_cache | No | Cache: whether to store this fetch in the response cache for later requests. Defaults to true. Set false to fetch without writing to the cache. | |
| only_main_content | No | Strip navigation, header, footer, scripts and other boilerplate before converting. Defaults to true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The tool result payload (shape varies per tool; see each tool's docs resource). |