Oxylabs Agent Browser

Teaches Claude to drive Oxylabs' remote anti-detect Chrome sessions over CDP with Playwright/Puppeteer, including retries, session limits and anti-block escalation.

Web & APIAdvanced★ 876⑂ 2AI score 8/10Last updated: Sep 30, 2026

What it does

Gives exact rules for building the wss://USER:PASS@hb.oxylabs.io endpoint and connecting with Playwright connectOverCDP or Puppeteer connect (raw-password concatenation, never new URL() — the top cause of 401s).
Supplies an error triage tree separating retryable failures (429, 5xx, CDP_BAD_PROXY, close code 3000) from must-fix ones (400/401/403), plus exponential backoff with jitter and password redaction in logs.
Documents account limits: 10 new sessions/sec, 100 concurrent, 5 named sessions, 5 profiles, 10 recordings, 1-hour max session life, and why unclosed sessions cause phantom 429s.
Defines a disciplined escalation ladder for protected targets (fresh session → broader geo → mobile device → slower pacing → live inspection → recommend persistent profiles, only with user consent).
Covers debugging via live VNC viewer and session recordings, plus restricted target categories that fail with CDP error 1337.

Who it's for

Developers with an Oxylabs Agent Browser account running production scraping jobs.
Data engineers pulling pages from JavaScript-heavy or bot-protected sites (DataDome, Cloudflare, Akamai).
Teams letting an agent drive browsers who need guardrails against session leaks and blind retry loops.

Examples

"Fetch this product page's HTML from a US IP" → one fresh session with ?p_cc=US only, blocking images/CSS/fonts for speed.
"I keep hitting a 403 wall" → check for the X-Error-Description header to tell an Oxylabs network error from a target block, climb one escalation rung per attempt, and open live VNC after three consecutive failures.
"I need a login to survive between runs" → a single setup run with o_profile_save=true earns the cookies, and read-only consumer runs then pass o_profile=<name> with a matching sticky IP and geo.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/oxylabs/agent-skills/HEAD/skills/agent-browser/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)

Download the ZIP with the button below.
In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.

↓ Download ZIP

Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/agent-browser folder from the GitHub repo oxylabs/agent-skills into my ~/.claude/skills/oxylabs-agent-browser/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/oxylabs/agent-skills.git && mkdir -p ~/.claude/skills && cp -r agent-skills/skills/agent-browser ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

Open a terminal in your working directory.
Clone the repo: git clone https://github.com/oxylabs/agent-skills.git
Create the skills folder: mkdir -p ~/.claude/skills
Copy the skill in: cp -r agent-skills/skills/agent-browser ~/.claude/skills/
Get credentials from https://hb.oxylabs.io/dashboard and export them: export OXY_UNBLOCKER_USERNAME=... and export OXY_UNBLOCKER_PASSWORD=... (add to your shell profile to persist).
Install a CDP client: npm i playwright or pip install playwright.
Restart Claude Code and ask something like "use the Oxylabs agent browser to scrape this page" to confirm the skill activates.

View source on GitHub ↗License: MIT