agentleFS
tdiminotdimino/claude-code-minoan/skills/integration-automation/obscura/SKILL.md

obscura

Skill41 starsChanged 7 months agoMITView on GitHub

Stealth headless browser with CDP server for anti-fingerprint browsing, parallel scraping, and low-memory CDP automation. This skill should be used when stealth browsing, anti-detection scraping, headless CDP automation with fingerprint protection, or tracker-free page fetching is needed. Triggers on 'stealth browse', 'anti-fingerprint', 'obscura', 'stealth CDP', 'undetectable scraping', 'headless stealth', 'tracker-free browsing'.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Start CDP server (port 9224 to avoid Chrome conflict on 9222):

    line 35
  2. Very specific:

    --proxy is a global flag: Place it before fetch/serve/scrape, not after.

    line 55
  3. Very specific:

    --quiet suppresses the banner: Use it when piping output.

    line 56

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Obscura

Rust headless browser with built-in anti-fingerprinting and CDP server. Fills the gap between Lightpanda (CDP, no stealth) and Scrapling (stealth, no CDP). Binary at ~/tools/obscura/obscura.

When to Use

ScenarioTool
Clean single-page markdownFirecrawl
Cloudflare Turnstile bypassScrapling
RedditLightpanda / Scrapling
Twitter/XJina
Interactive @ref automationagent-browser
Stealth CDP automationObscura
Batch stealth scrapingObscura
Low-RAM headless (30MB)Obscura

Usage

Fetch a page with stealth:

obscura fetch --stealth --quiet https://example.com --eval "document.title"

Parallel batch scrape:

obscura scrape URL1 URL2 URL3 --concurrency 25 --format json

Start CDP server (port 9224 to avoid Chrome conflict on 9222):

obscura serve --port 9224 --stealth

Chain through Proxelar for defense-in-depth — --proxy is a global flag, goes before the subcommand:

obscura --proxy http://127.0.0.1:8080 serve --port 9224 --stealth
obscura --proxy http://127.0.0.1:8080 fetch --stealth https://example.com

Connect Puppeteer: browserWSEndpoint: "ws://127.0.0.1:9224/devtools/browser" Connect Playwright: endpointURL: "ws://127.0.0.1:9224"

CDP domain coverage: see references/cdp-coverage.md. Includes non-standard LP.getMarkdown for DOM-to-Markdown.

Gotchas

  • Port 9224 is convention, not default. The binary defaults to 9222 (Chrome's port). Always pass --port 9224.
  • --stealth is off by default. Pass it explicitly for anti-fingerprinting and tracker blocking.
  • --proxy is a global flag. Place it before fetch/serve/scrape, not after.
  • --quiet suppresses the banner. Use it when piping output.
  • WebSocket path differs from Lightpanda. Obscura: /devtools/browser. Lightpanda: bare endpoint.
  • Ad-hoc signed binary, no notarization. SHA-256 recorded at ~/tools/obscura/obscura.sha256. Verify on update.

Helper Scripts

ScriptPurpose
scripts/obscura_serve.shStart CDP server on 9224 with cleanup trap, PID file, optional --with-proxelar

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.