| --- |
| title: Obscura Browser |
| emoji: 🌐 |
| colorFrom: purple |
| colorTo: blue |
| sdk: docker |
| app_port: 7860 |
| pinned: false |
| --- |
| |
| # Obscura Browser - Headless CDP Server |
|
|
| A headless browser engine running on HuggingFace Spaces, accessible via Chrome DevTools Protocol (CDP) for remote browser automation. |
|
|
| ## Features |
|
|
| - **Stealth Mode**: Anti-fingerprinting, TLS spoofing, and tracker blocking enabled by default |
| - **CDP Compatible**: Works with Puppeteer and Playwright |
| - **Lightweight**: ~30MB memory footprint, instant startup |
| - **V8 JavaScript**: Full JavaScript execution via V8 engine |
|
|
| ## Connection |
|
|
| ### Puppeteer |
|
|
| ```javascript |
| import puppeteer from 'puppeteer-core'; |
| |
| const browser = await puppeteer.connect({ |
| browserWSEndpoint: 'wss://Xocen-obx.hf.space/devtools/browser' |
| }); |
| |
| const page = await browser.newPage(); |
| await page.goto('https://example.com'); |
| console.log(await page.title()); |
| |
| await browser.disconnect(); |
| ``` |
|
|
| ### Playwright |
|
|
| ```javascript |
| import { chromium } from 'playwright-core'; |
| |
| const browser = await chromium.connectOverCDP({ |
| endpointURL: 'wss://Xocen-obx.hf.space' |
| }); |
| |
| const context = browser.contexts()[0]; |
| const page = await context.newPage(); |
| await page.goto('https://example.com'); |
| console.log(await page.title()); |
| |
| await browser.close(); |
| ``` |
|
|
| ## API Reference |
|
|
| The CDP server supports standard Chrome DevTools Protocol domains: |
|
|
| - **Target**: createTarget, closeTarget, attachToTarget |
| - **Page**: navigate, getFrameTree, lifecycleEvents |
| - **Runtime**: evaluate, callFunctionOn, getProperties |
| - **DOM**: getDocument, querySelector, querySelectorAll |
| - **Network**: enable, setCookies, getCookies, setExtraHTTPHeaders |
| - **Fetch**: enable, continueRequest, fulfillRequest, failRequest |
| - **Input**: dispatchMouseEvent, dispatchKeyEvent |
|
|
| ## Environment Variables |
|
|
| | Variable | Default | Description | |
| |----------|---------|-------------| |
| | `OBSCURA_NAV_TIMEOUT_MS` | 30000 | Navigation timeout in milliseconds | |
| | `OBSCURA_TIMEZONE` | Europe/Berlin | Browser timezone | |
| | `OBSCURA_PROXY` | None | HTTP/SOCKS5 proxy URL | |
|
|
| ## License |
|
|
| Apache 2.0 |
|
|
