nodemaven_fetch
Bypass geo-restrictions and datacenter blocks by fetching web pages through NodeMaven residential or mobile IPs, returning readable text or JSON.
Instructions
Fetch a URL through a NodeMaven residential or mobile IP and return its content.
Use this when a page is geo-restricted or blocks datacenter traffic. HTML is converted to readable text by default so it does not flood the context; set as_text=false when the markup itself matters.
Returns: str: Markdown or JSON with the schema: { "url": str, # final URL after redirects "status_code": int, "content_type": str, "title": str | None, # HTML when available "latency_ms": int, "truncated": bool, "bytes": int, "body": str, "proxy": str # password-masked proxy URL } On failure: "Error: "
Examples: - "read this page as a German visitor" -> url=..., country='de' - "check the price shown to US shoppers" -> url=..., country='us', city='new york' - Don't use when: the site is reachable without a proxy (use a plain fetch)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| isp | No | ISP or mobile carrier to pin, e.g. 't-mobile usa'. | |
| url | Yes | Absolute http(s) URL to fetch through the proxy. | |
| city | No | City to narrow the pool, e.g. 'los angeles'. | |
| port | No | Override the proxy port. Defaults to the port set for the protocol. | |
| region | No | State or region to narrow the pool, e.g. 'california'. | |
| as_text | No | Strip HTML markup and return readable text instead of raw HTML. | |
| country | Yes | Two-letter ISO country code for the exit IP, e.g. 'us', 'de', 'br'. | |
| protocol | No | Proxy protocol: 'http' or 'socks5'. | http |
| ipv4_only | No | Restrict the exit IP to IPv4. | |
| max_bytes | No | Truncate the response body to this many bytes. | |
| session_id | No | 4-10 alphanumeric characters. Reuse the same value to keep the same exit IP across calls (sticky session); omit it to rotate on every request. | |
| response_format | No | 'markdown' for a compact summary, 'json' for the full payload. | markdown |
| ip_quality_filter | No | NodeMaven IP quality tier, e.g. 'medium' or 'high'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |