Aluvia lets an agent change its IP geolocation through a global network of residential and mobile IPs, or a proxy URL you already have. The site then serves that country's page. Setup is one command.
First 10 MB free. No account. No API key. Then $2/GB.
Copy-paste to any agent.
Use with agents such as Grok Bot, Codex, Cursor, Claude computer use, OpenClaw, Hermes, or Playwright.
Germany · EUR
Show pricesMost sites infer country from the request IP. A cloud agent's IP is the datacenter's, so a UK catalog, a German price, or a not-available-in-your-region page is the machine, not the operator. Aluvia sends that same Chrome through a residential or mobile IP in the country you set. aluvia proxy-on --geo US (replace US; aluvia geos lists countries). Sticky sessions last up to 30 minutes.
Websites treat datacenter and cloud IPs as higher risk, so an agent browsing from a VM often hits a 403, CAPTCHA, Cloudflare challenge, or throttle. A residential or mobile IP in the right country sometimes clears that. It is not a guarantee.
Aluvia runs a small proxy next to the agent. One command turns it on, and every tab leaves through a residential or mobile IP. Aluvia does not claim to beat fingerprint, Linux Chrome, TLS, or canvas. Do not use it for a normal login wall. If a login page appeared because the IP is a datacenter, changing to a residential or mobile IP is the job. A password, SSO, or 2FA problem is not.
The agent sets a country. Every tab then leaves through a residential or mobile IP in that country. The same exit is reused for up to 30 minutes.
$ aluvia proxy-on --geo US { "egress": "aluvia", "targetGeo": "US", "next": "Reload the tab." }
If you already have an HTTP or HTTPS proxy URL, Aluvia will send traffic through it. You do not pay Aluvia for that bandwidth.
$ aluvia proxy-provider PROXY_URL { "provider": "custom" }
Agents run npx aluvia-cli setup. No account, API key, or payment is required during the free trial. See docs.
Every command prints JSON on stdout with a next field. Read next and run it. Never print API keys. If aluvia is not on the PATH, put npx aluvia-cli in front of it.
aluvia setup | Sets up Aluvia on the agent's machine. Once per machine. |
|---|---|
aluvia proxy-on | Send every tab through Aluvia, then reload the page. |
aluvia proxy-on --geo US | Use an IP in a specific country. Omit --geo for the global pool. Run aluvia geos for the list. |
aluvia proxy-off | Go back to the machine's own IP. The browser keeps running. |
aluvia rotate-ip | Get a new exit IP when the current one is still blocked. |
The full table, including the commands an agent needs and a human rarely does, is in llms.txt.
