fix(geoip): add icanhazip.com as first IP-echo source

[Theyka]

What

Adds http://icanhazip.com as the first entry in IPECHO_URLS in both the Node and Python SDKs. The two existing sources (api.ipify.org, ip-api.com) are kept as fallbacks.

- const IPECHO_URLS = ["http://api.ipify.org", "http://ip-api.com/line/?fields=query"];
+ const IPECHO_URLS = ["http://icanhazip.com", "http://api.ipify.org", "http://ip-api.com/line/?fields=query"];

No other code changes — both looksLikeIp() (Node) and _looks_like_ip() (Python) already accept IPv6, and the cached MaxMind DB handles IPv6 lookups.

Why

Backconnect / residential proxy providers commonly block api.ipify.org and ip-api.com with HTTP 502 "Host Not Found or connection failed", so resolveGeo() returns null and the browser keeps its host-OS timezone / language / location instead of matching the proxy's region.

icanhazip.com works through such proxies and auto-adapts: it returns IPv4 when the egress is IPv4, IPv6 when the egress is IPv6 — no subdomain needed.

Verified

Reproduced clearcote's exact httpGetText request logic through a backconnect proxy (92.60.79.23):

URL	Result
http://api.ipify.org	502 "Host Not Found or connection failed"
http://ip-api.com/line/?fields=query	502 "Host Not Found or connection failed"
http://icanhazip.com	200 → 2a0f:ca81:b00b:1d:6141:7cbd:33e7:b0b0 (IPv6 egress)

MaxMind DB lookup of the IPv6 returned by icanhazip.com:

{ "country": "DE", "timezone": "Europe/Berlin", "lat": 51.2993, "lon": 9.491 }

Existing tests pass unchanged:

• Node: npm run typecheck ✓, npm run build ✓, vitest run test/geoip.test.ts → 4/4 ✓
• Python: pytest tests/test_geoip.py → 4/4 ✓

The Node test suite asserts only on acceptLanguageForCountry() and the SOCKS-null path, neither of which is touched by this change.

[Copilot]

Pull request overview

This PR improves the reliability of GeoIP resolution in Clearcote’s Node and Python SDKs when running behind backconnect/residential proxies by adding an additional IP-echo endpoint (http://icanhazip.com) as the first source used to discover the egress IP before performing MaxMind DB lookup.

Changes:

• Add http://icanhazip.com as the first entry in IPECHO_URLS for the Python SDK.
• Add http://icanhazip.com as the first entry in IPECHO_URLS for the Node SDK.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
sdk/python/clearcote/geoip.py	Prepends icanhazip.com to the IP-echo fallback list used to discover the proxy egress IP.
sdk/node/src/geoip.ts	Prepends icanhazip.com to the IP-echo fallback list used to discover the proxy egress IP.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.