Setup (once)
Setup (once)
Use device Connect proxies, not task
vpnCountry, to switch markets on Cloud Android; attaching or disconnecting can restart the device.loc=) from the page as typed output. device.waitReady() returns once the device is ready again after a proxy change.
Check one country
Attach a German residential proxy, check a fresh page forDE, then disconnect.
Needs: Ready Cloud Android · Chrome with first-run prompts cleared · Connect access and proxy data · MOBILERUN_API_KEY, DEVICE_ID · Python 3.9+ or Node.js · no site account · one-shot, ~1–3 min · device minutes + residential traffic.
MCP prompt: On my test Cloud Android device with no proxy attached, connect a rotating residential Connect proxy in Germany. Force-stop Chrome without clearing its data, open a new network trace URL with a unique query, and read the country. Verify DE, then disconnect the proxy and wait for the device to be ready. Do not sign in.
Show the code (Python and TypeScript)
Show the code (Python and TypeScript)
Compare several markets
Compare DE, JP and BR inmarkets.json, adding GPS coordinates for location-aware apps—GPS alone does not change the network country.
Needs: Same setup · location-control capability · test device with no attached proxy · no site account · one-shot, ~2–5 min · device minutes + residential traffic.
Show the code (Python and TypeScript)
Show the code (Python and TypeScript)
Use any country with a proxy
Choose an available Connect country withCOUNTRY, LOCALE and TIMEZONE, use Smart IP for GPS alignment, and restore language/timezone afterward.
Needs: Same setup · language, timezone and location controls · dedicated test device · defaults: CA, en-CA, America/Toronto · no site account · one-shot, ~1–3 min · device minutes + residential traffic.
Show the code (Python and TypeScript)
Show the code (Python and TypeScript)
One device per market
Map countries to distinct device IDs and run the same country check on every device in parallel. Needs: Same setup on each device ·DEVICE_IDS JSON, e.g. {"DE":"device-id","JP":"another-device-id"} · one-shot, ~1–3 min · device minutes + residential traffic per device.
Show the code (Python and TypeScript)
Show the code (Python and TypeScript)
Next steps
- Replace the trace page with your app’s regional content or pricing screen.
- Find supported countries in the Connect country catalog.
- Explore proxies and Smart IP or read app data as JSON.
For AI agents
For AI agents
- Start with Check one country on a ready test device with no attached proxy.
- Use device proxy, deep-link and typed task output; map
DEVICE_IDSto distinct devices for parallel checks. - Ask before attaching a proxy: it can restart the device and uses residential traffic.
- Report requested versus observed countries and cleanup status.