PP
Browser Automation
Puppeteer proxy integration
Puppeteer accepts a proxy server via a launch arg, and handles authentication with page.authenticate(). Put the targeting suffix in the username you pass to authenticate(), and the page routes through a residential IP.
Setup steps
- 1Install Puppeteer: npm install puppeteer.
- 2Launch Chrome with --proxy-server=proxy.aethyn.io:2099.
- 3Call page.authenticate() with your username and password.
- 4Navigate as usual.
Code
Puppeteer (Node.js)
import puppeteer from "puppeteer";
const browser = await puppeteer.launch({
args: ["--proxy-server=proxy.aethyn.io:2099"],
});
const page = await browser.newPage();
await page.authenticate({
username: "aethyn-XXXXX-country-us",
password: "PASSWORD",
});
await page.goto("https://httpbin.org/ip");
console.log(await page.content());
await browser.close();Replace aethyn-XXXXX and PASSWORD with your dashboard credentials. See the full targeting reference and protocol/port list. Or use the official proxy-builder-sdk to build targeting strings without hand-assembling usernames.
Tips
- page.authenticate() must be called before page.goto().
- One proxy server per browser instance — launch separate browsers for different exits.
- Combine with puppeteer-extra-plugin-stealth to reduce automation fingerprints.
Puppeteer proxy FAQ
Can each Puppeteer page use a different IP?
Within one browser the proxy server is shared, but rotation still gives fresh IPs per request. For distinct geos, launch a separate browser per proxy configuration.
Docs, solutions & blog
Related solution guideEnd-to-end workflow that pairs with this integration.Node.js SDKproxy-builder-sdk on npm — TypeScript types, forPlaywright(), and multi-provider support.Premium residential proxiesCost-efficient rotating residential pool from €2.00/GB for bulk scraping and monitoring.Elite residential proxiesCurated high-trust pool with city and ISP targeting for hard anti-bot targets.Quickstart docsCredentials, endpoints, and your first proxied request.Related blog articleDeeper context on proxies, errors, and anti-bot for this stack.