Headless Browser

Connects to Oxylabs remote headless browsers via Chrome DevTools Protocol using Playwright or Puppeteer, with anti-detection, CAPTCHA…

You say
Buy it · $99 Read it before you buy $99 Written by oxylabs · unverified publisher
Context cost
3.4k tokensestimated from the bundle, loaded when it triggers
Bundle
2 files · 13.5 kBtext throughout, nothing executable
Licence
MITpaid listing
Last change
no release on file
Servers it uses
Noneruns standalone

What it does

Connects to Oxylabs remote headless browsers via Chrome DevTools Protocol (CDP) using Playwright or Puppeteer. Provides anti-detection, CAPTCHA handling, residential proxies, and geo-targeting built in. Use when browser automation needs remote execution, stealth capabilities, rendered pages, screenshots, PDFs, or complex JavaScript interaction.

Installed, it changes the agent in these ways.

What this skill changes about the agent is not written down here yet. The listing was collected from its source, and the description is in its own SKILL.md.

Expertise

Domain judgement the base model does not have.

headlesscdpproxyscreenshots

The skill itself

This is the whole product. A skill is instructions the model reads, so there is nothing behind the listing you cannot see first — the front matter loads with every session, and the body below it loads when the skill triggers.

SKILL.md6.2 kB · 149 lines
--- name: headless-browser description: Connects to Oxylabs remote headless browsers via Chrome DevTools Protocol (CDP) using Playwright or Puppeteer. Provides anti-detection, CAPTCHA handling, residential proxies, and geo-targeting built in. Use when browser automation needs remote execution, stealth capabilities, rendered pages, screenshots, PDFs, or complex JavaScript interaction. ---
6# Oxylabs Headless Browser
7
8Remote headless browser service with built-in anti-detection and proxy integration. Chrome supports Playwright, Puppeteer, and any CDP-compatible library. Firefox is legacy and uses Playwright's Firefox connection API.
9
10## Environment Variables
11
12Prefer OXY_UNBLOCKER_USERNAME and OXY_UNBLOCKER_PASSWORD for Headless Browser credentials. OXY_HB_USERNAME and OXY_HB_PASSWORD are supported aliases in older setups.
13
14## Connection URLs
15
16| Browser | Global endpoint | US endpoint |
17|---------|-----------------|-------------|
18| Chrome | wss://USERNAME:PASSWORD@ubc.oxylabs.io | wss://USERNAME:PASSWORD@ubc-us.oxylabs.io |
19| Firefox (legacy) | wss://USERNAME:PASSWORD@ubs.oxylabs.io | wss://USERNAME:PASSWORD@ubs-us.oxylabs.io |
20
21## Browser Types
22
23| Type | Best For | Notes |
24|------|----------|-------|
25| **Chrome** | High performance, dedicated servers, residential proxies | Use chromium.connect_over_cdp / connectOverCDP |
26| **Firefox (legacy)** | Alternative engine for targets that perform better outside Chrome | Use firefox.connect; supported Playwright versions are 1.51 and 1.56 via ?o_pw=1.56 |
27
28## Quick Start
29
30**Playwright (Python):**
31```python
32from playwright.sync_api import sync_playwright
33import os
34
35username = os.environ.get("OXY_UNBLOCKER_USERNAME") or os.environ["OXY_HB_USERNAME"]
36password = os.environ.get("OXY_UNBLOCKER_PASSWORD") or os.environ["OXY_HB_PASSWORD"]
37endpoint = "ubc.oxylabs.io"
38
39with sync_playwright() as p:
40 browser = p.chromium.connect_over_cdp(
41 f"wss://{username}:{password}@{endpoint}"
42 )
43 page = browser.new_page()
44 page.goto("https://example.com")
45 print(page.content())
46 browser.close()
47```
48
49**Playwright (JavaScript):**
50```javascript
51const { chromium } = require("playwright");
52
53const username = process.env.OXY_UNBLOCKER_USERNAME || process.env.OXY_HB_USERNAME;
54const password = process.env.OXY_UNBLOCKER_PASSWORD || process.env.OXY_HB_PASSWORD;
55const endpoint = "ubc.oxylabs.io";
56
57(async () => {
58 const browser = await chromium.connectOverCDP(
59 wss://${username}:${password}@${endpoint}
60 );
61 const page = await browser.newPage();
62 await page.goto("https://example.com");
63 console.log(await page.content());
64 await browser.close();
65})();
66```
67
68**Puppeteer:**
69```javascript
70const puppeteer = require("puppeteer");
71
72const username = process.env.OXY_UNBLOCKER_USERNAME || process.env.OXY_HB_USERNAME;
73const password = process.env.OXY_UNBLOCKER_PASSWORD || process.env.OXY_HB_PASSWORD;
74const endpoint = "ubc.oxylabs.io";
75
76(async () => {
77 const browser = await puppeteer.connect({
78 browserWSEndpoint: wss://${username}:${password}@${endpoint}
79 });
80 const page = await browser.newPage();
81 await page.goto("https://example.com");
82 console.log(await page.content());
83 await browser.close();
84})();
85```
86
87## Rate Limits
88
89- **Concurrent sessions:** 100 per browser type
90- **Launch rate:** up to 10 sessions per second per browser type
91- **Higher limits:** Available upon request to support
92
93## Features
94
95- **Anti-detection:** Built-in fingerprint management
96- **Residential proxies:** Automatic proxy rotation
97- **Geo-targeting:** Country, city, and US state targeting via connection parameters
98- **US endpoints:** Lower latency for US-based users; not the same as proxy geolocation
99- **CAPTCHA handling:** Automatic load-time solving; manual trigger available with window.postMessage({action: 'solve_captcha', type: '<captcha type>'}, '*')
100- **Session inspection:** Enable VNC debugging with o_vnc=true
101- **No local browsers:** All execution happens remotely
102
103## Connection Parameters
104
105Append query parameters to the WebSocket URL:
106
107| Parameter | Browser | Description |
108|-----------|---------|-------------|
109| p_cc=US | Chrome, Firefox | Route traffic through a 2-letter country code |
110| p_city=los_angeles | Chrome, Firefox | Target a city; combine with p_cc or p_state |
111| p_state=texas | Chrome, Firefox | Target a US state; takes priority over p_cc |
112| p_device=mobile | Chrome | Emulate desktop, mobile, or tablet device fingerprints |
113| o_vnc=true | Chrome, Firefox | Enable Session Inspection for visual debugging |
114| o_pw=1.56 | Firefox | Select supported Firefox Playwright version 1.51 or 1.56 |
115| bargs=disable-notifications | Chrome | Pass supported Chrome browser arguments |
116
117Supported Chrome bargs values: force-color-profile:<profile>, window-position:X,Y, hide-scrollbars, enable-features:<feature1>,<feature2>, disable-notifications.
118
119Repeat bargs for multiple browser arguments, e.g., ?bargs=force-color-profile:srgb&bargs=window-position:100,100. p_city requires p_cc or p_state; p_state overrides p_cc.
120
121## CAPTCHA Handling
122
123- Listen for oxylabs-captcha-solve-start, oxylabs-captcha-solve-end, and oxylabs-captcha-solve-error window messages.
124- Register CAPTCHA listeners before navigation when possible so page-load challenges are captured.
125- For CAPTCHAs shown after page load, trigger solving with window.postMessage({action: 'solve_captcha', type: '<captcha type>'}, '*').
126- Supported manual CAPTCHA types: hcaptcha, recaptcha, turnstile.
127
128## When to Use
129
130| Scenario | Use Headless Browser |
131|----------|------------------------|
132| Complex JavaScript sites | Yes |
133| Anti-bot protected sites | Yes |
134| Browser automation with stealth | Yes |
135| Screenshot/PDF generation | Yes |
136| Simple HTML scraping | Consider Web Scraper API instead |
137
138## Supported Libraries
139
140Any library supporting Chrome DevTools Protocol (CDP):
141- Playwright (recommended)
142- Puppeteer
143- Selenium with CDP
144- Custom CDP implementations
145
146Firefox is legacy and should use Playwright firefox.connect with supported Playwright versions 1.51 or 1.56.
147
148For more examples, see [examples.md](examples.md).
149
In the file
SKILL.md697 words
Files2
LicenceMIT
Why you can read it

Nothing in a skill executes. The client loads the text and the model follows it, so a skill can be audited the way a runbook is — by reading it.

What it costs in context

Skills are not billed by the call. They are paid for in context: every token the instructions occupy is a token your code, your diff and your conversation cannot use. Here is what this one takes and when it takes it.

≈100
always loaded
The name and description, so the model knows the skill exists and when to reach for it.
3,275
on trigger
The instruction body and 1 supporting file, read only when the skill fires.
1.7%
of a 200k window
Ten skills this size would take about 17% of the window before you open a file.
050k100k150k200k context window

3.4k tokens, estimated from the bundle at four bytes to the token, held for the rest of the session once it triggers. Middling. Fine to keep on in a project where you use it weekly, worth unloading in one where you never do.

Servers bill, skills cost

A server charges by the month. A skill charges once per session, in context, and then keeps charging it for as long as the session lives.

Before and after

The same question, put to the same model twice: once as it comes, and once with these instructions loaded.

No worked example has been published for this skill yet.

Adoption
Installsnone yet
Ratingno reviews yet

The procedure it runs

The procedure has not been published here. It is in the skill’s own SKILL.md, which its author has not sent to the marketplace yet.

Prose, not code

These steps are written for a model to follow, not executed by a runtime. It can still be told to skip one, and it will say so when it does.

Servers it uses

None. This skill calls no MCP servers at all.

Everything it needs is in the instructions, so it works in a project with nothing connected — the model reads the file and changes how it works with what it can already reach.

It writes no files and reaches no network. All it changes is how the model reasons and writes.

What it asks for
Writes filesno
Network accessno

Read from the allowed-tools line of this skill’s own SKILL.md. A skill grants no permissions of its own — it can only ask for tools your client already has.

What it will not do

Every skill is narrow, and the useful ones say where they stop. These are the jobs this one is the wrong tool for.

What this skill is not for has not been published here. Nothing is implied by that: it is a section the author has not filled in.

What is in the bundle

2 files, 13.5 kB on disk. A bundle is text throughout: the instructions the model reads, plus the templates it fills in.

  • SKILL.md6.2 kB
  • examples.md7.3 kB
What is not in it

No dependencies and nothing executable: a skill is text the agent reads, so the bundle is 2 files you can review in full before installing. The MIT licence covers the templates and examples as well as the instructions.

Install

Installing copies the bundle into your project. Nothing runs at install time — the files sit on disk until the model reads them.

$99 once
Headless Browser · MIT · oxylabs
one-time
Price$99 once
LicenceMIT — the author’s, unchanged by this purchase
Paid throughStripe, once, on the card you add at the checkout
Keeps workingfor good — the files are yours once they are on disk
Updatesevery update its author ships, delivered through this account

You can read the whole bundle before paying — the SKILL.md above is the product, not a preview of it. What the money buys is the delivery: the folder packaged and handed to your machine by key, every update its author ships, and our support if it does not do what this listing says. The terms of use are MIT, set by the author and unchanged by buying it here.

Payment runs through Stripe, on a page like this one rather than a redirect. Once there is an account it joins the same mcprush invoice as everything else you run, so there is never a second card to enter.

Which clients pick it up on their own

A skill is a folder of text. A client with a skills folder reads it without being told; everywhere else the same text works, it is just handed to the model rather than found.

Claude Code.claude/skills/
Claude Desktop
ChatGPT
Cursor.cursor/skills/
VS Code.github/skills/
Codex CLI.agents/skills/
Gemini CLI.gemini/skills/
Grok.grok/skills/
Zed.agents/skills/
Windsurf.windsurf/skills/
Agent SDK.claude/skills/
HTTP / API
This release
Versionnot versioned
Publishedno release date on file
Price$99
Referenceoxylabs/headless-browser

Versions

Its author publishes no version number, so there is nothing here to pin to: what you install is the folder as it stands today. Instructions change more often than APIs do — a skill can be rewritten entirely without anything it depends on moving.

v
  • No earlier releases have been published to the marketplace.
Pinning

Nothing to pin to: this skill carries no version number of its own. What you install is what the folder holds on the day you install it.

Reviews

no reviews yet · no installs yet

Nobody has reviewed this skill yet. The rating is the mean of the reviews written here, so there is none until somebody writes the first.

Who can post

Only accounts that have had the skill installed for fourteen days, so a review is written after living with it rather than after reading it. Publishers may reply once.

Who wrote it

OX
oxylabs

Publishes on mcprush.

0 servers listed2 skills listednot claimed
Profile
Publisher
Servers0