nodemaven_check_proxy
Send a test request through the proxy to verify exit IP, country, and latency before scraping, ensuring targeting resolves to the expected pool.
Instructions
Send one request through the proxy and report the exit IP, its geo and latency.
Use this before a scraping run to confirm the targeting resolves to a real pool and that the exit IP is where you expect. Over-narrow targeting (a rare city plus an ISP filter) is the usual reason a connection fails.
Returns: str: Markdown or JSON with the schema: { "exit_ip": str, # e.g. "104.28.51.7" "country": str, # e.g. "US" "region": str, "city": str, "org": str, "latency_ms": int, "proxy": str, # password-masked proxy URL "session_id_used": bool } On failure: "Error: "
Examples: - "am I really coming out of Germany?" -> country='de' - "does this sticky session hold?" -> session_id='ab12cd', call twice - Don't use when: you need the catalogue of available cities (use nodemaven_list_locations)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| isp | No | ISP or mobile carrier to pin, e.g. 't-mobile usa'. | |
| 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'. | |
| 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. | |
| 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 |