The headless browser for AI agents and web scraping
Obscura documentation
Official documentation for Obscura, maintained in this repository.
Obscura is an independent headless browser engine written in Rust. It runs
JavaScript through V8 and provides a Chrome DevTools Protocol endpoint for
Puppeteer and Playwright. These docs describe the code on main; installed
release versions may differ.
Versus headless Chrome
| Metric | Obscura | Headless Chrome |
|---|---|---|
| Memory | 30 MB | 200+ MB |
| Binary size | ~70 MiB | 300+ MB |
| Startup | Instant | ~2s |
| Page load | 85 ms | ~500 ms |
| Anti-detect | Built-in | None |
| Puppeteer | Yes | Yes |
| Playwright | Yes | Yes |
Rendering and stealth are both first-class capabilities. Release builds support screenshots, scroll-aware layout, activity-driven CDP screencasting, and raster PDF export; stealth builds retain all of those surfaces while adding the wreq/BoringSSL transport and browser-identity protections.
Quickstart
Guides
- Build from source
- Configure stealth and proxies
- Markdown extraction
- Use with Puppeteer
- Use with Playwright
- Use the MCP server
- Watch agent sessions live
- Use as a Rust library
- Persist cookies and storage
- Intercept and modify requests
- Run in production at scale
Reference
Contributing
Links
- Source: https://github.com/h4ckf0r0day/obscura
- Releases: https://github.com/h4ckf0r0day/obscura/releases
- Issues: https://github.com/h4ckf0r0day/obscura/issues
License: Apache-2.0.