headless-browser

# Oxylabs Headless Browser Remote Chrome sessions with anti-detection, proxy rotation and geo-targeting built in. Nothing runs locally: you connect over a WebSocket, drive the browser with the CDP library you already use, and close the session when done. This file holds the rules; the detail lives next to it: `scripts/` (copyable templates), `parameters.md`, `errors.md`, `examples.md`, `targets.md`. ## 1. Connect | Item | Value | |------|-------| | Endpoint | `wss://USERNAME:PASSWORD@hb.oxylabs.io` | | Credentials | `OXY_UNBLOCKER_USERNAME` / `OXY_UNBLOCKER_PASSWORD` (aliases: `OXY_HB_USERNAME` / `OXY_HB_PASSWORD`) | | Options | URL query parameters only, e.g. `?p_cc=US&session_name=job-42` (see `parameters.md`) | | Libraries | Playwright `chromium.connectOverCDP` (recommended), Puppeteer `puppeteer.connect`, any CDP client | | Dashboard / support | `https://hb.oxylabs.io/dashboard` · `support@oxylabs.io` | Rules that prevent the most common `401`: - Use `wss://`. Plain `ws://` is accepted but sends your password unencrypted. - Build the URL by string concatenation with the **raw** password. Do not pass the finished URL through `new URL()` or `urllib.parse`: they percent-encode the password and authentication fails. - Use the full username exactly as shown in the dashboard, including any suffix such as `_ab12`. - A password containing `:` cannot be sent in the URL. Ask for a new password or send the `Authorization: Basic` header yourself (see `examples.md`). - Authen...