Playwright Proxy: One Authenticated IP per Browser Context

Why Playwright needs a proxy

Playwright drives a real browser, but every page it loads still leaves from your machine's IP. Run many contexts from one server and the site sees one address doing the work of many visitors. The usual reply is HTTP 429 Too Many Requests — the server telling you to slow down — or a block.

Proxy support is built in. You can set one proxy for the whole browser or a separate proxy for each browser context, so parallel workers leave through different IPs. Playwright documents the username and password fields for HTTP proxies.

Use HTTP for password-protected proxies in Chromium. Chrome supports no authentication method for SOCKS5 and won't use credentials written into proxy settings, so a socks5:// server with a password fails in Chromium even though Playwright accepts socks5:// addresses.

• Sources:
• MDN — 429 Too Many Requests
• Playwright docs — Network: HTTP proxy
• Playwright API — browserType.launch(): proxy option
• Chromium — Proxy support in Chrome

Recommended Playwright setup

Scroll horizontally with the arrow keys to read all content.

The button below opens Static Datacenter Proxies with the AI and automation use case. Choose Region, Term, Protocol and Quantity (up to 100 IPs at a time) before you pay.

• Sources:
• Proxy302 console — Static Datacenter Proxies

Which Proxy302 proxy to buy

Scroll horizontally with the arrow keys to read all content.

Prices in US dollars. Top up your wallet once and pay any line from it. Nothing renews unless you switch auto-renew on for an IP in My assets — or renew by hand there; renewing normally keeps the same IP.

• Sources:
• Proxy302 pricing

Set up Playwright proxies in 5 steps

1. Choose the region and term

   The button below opens Static Datacenter Proxies (Per IP and term) with the AI and automation use case. Under Connection settings pick the Region, choose a Term and set Protocol to HTTP. Set Quantity to the number of IPs you need (one for each parallel worker, up to 100 at a time). Then click Review cost and generate.

2. Copy each IP

   In My assets, Copy gives a ready line in host:port:user:password form. Put host and port in PROXY_HOST and PROXY_PORT, user and password in PROXY_USER and PROXY_PASS — environment variables keep the password out of your code.

3. Add the proxy to Playwright

   Use the code below. A proxy on newContext() gives each worker its own IP; a proxy on launch() applies one IP to the whole browser. The server must be http://host:port.

4. Check the exit IP

   The script opens api.ipify.org and prints the IP the site sees.

   Expected result The printed IP is the proxy's address, not your server's.

5. If a site blocks datacenter IPs

   Open Rotating Residential Proxies instead: set Line to Budget, use Add traffic to buy a package (from 1 GB), then set Exit mode to Global rotation for new exits on new connections, or to Choose region / sticky IP to stay in one country or major city. Rotating residential connects through proxy.proxy302.com:2222 for HTTP.

Playwright proxy with username and password (Node.js)

Scroll horizontally with the arrow keys to read all content.

// npm i playwright   then   npx playwright install chromium
import { chromium } from 'playwright'

// From Proxy302 → My assets → Copy (host:port:user:password)
const { PROXY_HOST, PROXY_PORT, PROXY_USER, PROXY_PASS } = process.env

const browser = await chromium.launch()
// One proxy per browser context: each parallel worker gets its own exit IP
const context = await browser.newContext({
  proxy: {
    server: `http://${PROXY_HOST}:${PROXY_PORT}`, // HTTP: Chromium can't send a SOCKS5 password
    username: PROXY_USER,
    password: PROXY_PASS,
  },
})
const page = await context.newPage()
await page.goto('https://api.ipify.org?format=json')
console.log(await page.textContent('body')) // {"ip":"..."}: the proxy's exit IP, not your server's
await browser.close()

Checked on 2026-10-18 with Playwright 1.63.0 and Chromium 153 against a local password-protected proxy: the right credentials loaded the page, a wrong password loaded nothing. Swap the IP-check URL for your target.

• Sources:
• Local proxy fixture run
• Playwright API — browserType.launch(): proxy option

The same in Python

Scroll horizontally with the arrow keys to read all content.

# pip install playwright   then   playwright install chromium
import os
from playwright.sync_api import sync_playwright

# From Proxy302 → My assets → Copy (host:port:user:password)
proxy = {
    "server": f"http://{os.environ['PROXY_HOST']}:{os.environ['PROXY_PORT']}",
    "username": os.environ["PROXY_USER"],
    "password": os.environ["PROXY_PASS"],
}

with sync_playwright() as p:
    browser = p.chromium.launch(proxy=proxy)  # or browser.new_context(proxy=proxy) per worker
    page = browser.new_page()
    page.goto("https://api.ipify.org?format=json")
    print(page.text_content("body"))  # the proxy's exit IP
    browser.close()

Playwright for Python takes the same proxy dictionary in launch() or new_context(). Syntax-checked; the Node.js version above was run end to end.

• Sources:
• Playwright docs — Network: HTTP proxy

Playwright MCP through a proxy

Playwright MCP lets an AI client such as Claude Code, Cursor or Codex drive a browser. Give it --proxy-server and that browser sends its traffic through your proxy. The credentials go inside the URL, as http://USER:PASS@HOST:PORT; there is no separate username option. --proxy-bypass takes a comma-separated list of domains that should not go through the proxy.

Use the HTTP endpoint of your proxy (port 2222 on Proxy302). The README also shows socks5:// addresses, but Playwright does not support SOCKS5 with a username and password: the request for it was closed as not planned on 31 October 2026. For an AI agent that drives a browser through its own library, see the browser-use proxy guide.

proxy302-mcp is the official Proxy302 MCP server, open source on GitHub and maintained by the Proxy302 team. Proxy302 also runs it at https://proxy302.com/v1/mcp: clients that can send an Authorization header, such as Claude Code, Cursor and VS Code, connect with an API key and install nothing. Install commands are in the proxy MCP server guide.

• Browser Use proxy setup
• proxy MCP server guide

• Sources:
• Playwright MCP README
• Playwright issue 10567: Support socks5 proxy with authentication
• proxy302-mcp README (official Proxy302 MCP server)

Playwright MCP through a proxy: mcpServers

Scroll horizontally with the arrow keys to read all content.

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--proxy-server",
        "http://USER:PASS@HOST:PORT",
        "--proxy-bypass",
        ".example.com"
      ]
    }
  }
}

Replace USER, PASS, HOST and PORT with the values from My assets. The mcpServers block goes into your MCP client's configuration file.

• Sources:
• Playwright MCP README

Proxy302 at a glance

Scroll horizontally with the arrow keys to read all content.

Prices are in PTC, paid from the wallet; 1 PTC = US$1. There is no free trial: the smallest purchase is 1 GB of rotating residential traffic or one IP for one day. Checked on 4 November 2026.

• Sources:
• Proxy302 product facts and price list
• Proxy302 ISP for AI subscriptions: public catalog

Quick fixes

Playwright proxy FAQ

A CAPTCHA recognition service: CaptchaAI

CaptchaAI is a paid CAPTCHA recognition API for automation software. It is a separate third-party service and a Proxy302 partner; it does not supply proxies. Use it only where the site’s terms allow.

• Visit CaptchaAI

Related setups

Selenium proxies

Selenium proxy with username and password in Chrome: HTTP proxy in ChromeOptions plus Selenium's BiDi auth handler, no extensions. Static datacenter IPs for test runs.

View options and pricing

Geo testing proxies

Geo proxies for testing: see your website as visitors in other countries and major cities see it — prices, language, banners — with matching locale and time zone.

View options and pricing

Datacenter proxies

Fast datacenter proxies with fixed IPs, low latency and high concurrency — the lowest cost per IP for APIs, testing and bulk jobs. Pick the country; pay per IP and term.

View options and pricing