obscura-windows

Drive the Obscura headless browser on Windows for scraping, screenshots, and CDP automation.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/narr07/permadi --skill obscura-windows-narr07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obscura-windows
Source: https://github.com/narr07/permadi/tree/main/.roo/skills/obscura-windows
Command: npx skills add https://github.com/narr07/permadi --skill obscura-windows-narr07

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Scraping JavaScript-heavy pages and automating browsers on Windows usually requires installing Chromium, Node.js, and managing drivers. This Skill sets up and operates Obscura, a single-binary Rust + V8 headless browser, so you can fetch rendered pages, extract content, and automate browsers without that toolchain. ## Core Features & Use Cases - CLI scraping and extraction: Use obscura fetch and obscura scrape to dump rendered HTML, text, links, markdown, cookies, or raw binary resources from one or many URLs in parallel. - CDP server for Puppeteer/Playwright: Run obscura serve on port 9222 and connect existing Puppeteer or Playwright scripts unmodified for multi-step flows like logins, form fills, and navigation. - MCP server for agents: Expose 38 browser_* tools (navigate, click, fill, screenshot, PDF, storage state) to Claude Desktop or Cursor via obscura mcp over stdio or HTTP. - Use Case: You need to scrape a JavaScript-rendered product listing on Windows. The Skill installs the stealth build, runs obscura fetch --stealth --dump markdown --output page.md, and returns the rendered markdown without any Chromium install. ## Quick Start Ask the agent to fetch a rendered page as markdown using Obscura with stealth mode on, for example: "Use Obscura to fetch https://example.com and save the markdown to page.md."

Frequently Asked Questions about obscura-windows

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape a JavaScript-heavy page on Windows without installing Chrome?▼

Use Obscura, a single-binary Rust + V8 headless browser. Run `obscura fetch "<url>" --stealth --dump markdown --output page.md` in PowerShell to get the rendered page as markdown, with no Chromium or Node.js required.

Can I use Puppeteer or Playwright with Obscura instead of headless Chrome?▼

Yes. Start `obscura serve --port 9222 --stealth` and connect with `puppeteer.connect({ browserWSEndpoint: 'ws://127.0.0.1:9222/devtools/browser' })` or Playwright's `connectOverCDP`. Existing scripts targeting Chrome work unmodified.

Does Obscura work as an MCP server for Claude Desktop?▼

Yes. Run `obscura mcp --stealth` over stdio and add the full obscura.exe path to claude_desktop_config.json. The agent then gets 38 browser_* tools for navigation, clicking, form filling, screenshots, and session state.

Why is the obscura command not recognized in PowerShell after install?▼

The setup script adds the install folder to the user PATH via the registry, so terminals opened before installation will not see it. Open a new terminal or call the full path at %LOCALAPPDATA%\obscura\obscura.exe directly.

What are the limitations of Obscura's stealth mode and file access?▼

Stealth blocks roughly 3,500 tracker domains, so some analytics scripts will not load. Also, testing on v0.2.2 showed CDP clients can navigate to file:// URLs even without --allow-file-access, so never bind the server beyond 127.0.0.1.