Tooluck logoTooluck
SKILL.md

agent-browser

Agent skill fromoxylabs/agent-skills

Connects to Oxylabs remote agent browsers over the Chrome DevTools Protocol (CDP) with Playwright or Puppeteer. Managed browser environment, residential proxies, geo-targeting, persistent sessions and profiles, session recording and live VNC inspection for debugging. Use instead of WebFetch or a local browser whenever a site renders with JavaScript, serves access challenges, verification interstitials or bot-management block pages, or needs a full browser session, screenshots or PDFs. Covers connection, retries, error recovery, built-in challenge handling (the page_handler parameter, the oxylabs-page-status page state reported by the page handler, manual triggering), telling a handled challenge from a block that needs a fresh identity, and reliable access to publicly available data without manual intervention.

How to install agent-browser

install agent-browser
# install the agent-skills pack with the skills CLI
npx skills add oxylabs/agent-skills

# or add only this skill to Claude Code: copy the folder

skills/agent-browser/

# into

~/.claude/skills/agent-browser/ (all projects)

.claude/skills/agent-browser/ (one project)

skills/agent-browser/SKILL.md

MITFull file
1# Oxylabs Agent Browser
2
3Remote Chrome sessions in a managed browser environment with proxy rotation and geo-targeting built in.
4Nothing runs locally: you connect over a WebSocket, drive the browser with the CDP library you already
5use, and close the session when done. This file holds the rules; the detail lives next to it:
6`scripts/` (copyable templates), `parameters.md`, `errors.md`, `examples.md`, `targets.md`, `challenges.md`.
7
8## 1. Connect
9
10| Item | Value |
11|------|-------|
12| Endpoint | `wss://USERNAME:PASSWORD@hb.oxylabs.io` |
13| Credentials | `OXY_AB_USERNAME` / `OXY_AB_PASSWORD` |
14| Options | URL query parameters only, e.g. `?p_cc=US&session_name=job-42` (see `parameters.md`) |
15| Browser engine | Default engine with the `oxyfp_win` browser profile; `p_src=oxybrowser` selects the new engine (see `parameters.md`) |
16| Libraries | Playwright `chromium.connectOverCDP` (recommended), Puppeteer `puppeteer.connect`, any CDP client |
17| Dashboard / support | `https://hb.oxylabs.io/dashboard` · `support@oxylabs.io` |
18
19Rules that prevent the most common `401`:
20
21- Use `wss://`. Plain `ws://` is accepted but sends your password unencrypted.
22- Build the URL by string concatenation with the **raw** password. Do not pass the finished URL through
23 `new URL()` or `urllib.parse`: they percent-encode the password and authentication fails.
24- Use the full username exactly as shown in the dashboard, including any suffix such as `_ab12`.
25…

Excerpt shown under the repository's MIT license.

More skills in agent-skills

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates