Obscura 无头浏览器

这个 Agent 能做什么，适合哪些场景？

Obscura 是用 Rust 编写的开源无头浏览器引擎，面向网页抓取和智能体浏览器自动化。它直接嵌入 V8 执行页面 JavaScript，并通过 Chrome DevTools Protocol 提供可供 Puppeteer 和 Playwright 连接的服务。其独立渲染引擎能够生成 PNG 截图、实时页面录屏流和 PDF，而不必启动 Chromium。项目还提供单页 fetch、并行 scrape、CDP WebSocket 服务以及 stdio/HTTP 两种传输方式的 MCP 服务器。用户可以通过预编译二进制、Docker 镜像或 Rust 源码自行部署；官方发布包无需安装 Chrome、Node.js 或额外运行时依赖。

用户可用 obscura fetch <URL> 请求网页、运行页面脚本，并输出 HTML、正文、链接、Markdown、资源 URL 的 NDJSON 或原始响应体；还可等待加载条件、选择器或动态内容，并把结果写入文件。obscura scrape <URL...> 启动多个 worker 并发处理 URL，通过 JavaScript 表达式提取数据，输出 JSON 或文本。obscura serve --port 9222 暴露 CDP WebSocket 服务，使 puppeteer-core 的 puppeteer.connect 和 playwright-core 的 chromium.connectOverCDP 可以导航、查询 DOM、填写表单、维护 Cookie、拦截请求并生成截图或 PDF。渲染引擎处理 CSS 布局与绘制，支持视口及整页截图、CDP screencast 和栅格 PDF。启用 --stealth 后，它会随机化会话指纹、隐藏自动化特征并阻止列出的跟踪域名。obscura mcp 或 obscura mcp --http --port 8080 则向 MCP 客户端提供导航、快照、点击、填写、键盘输入、脚本求值、网络记录、控制台消息、截图和 PDF 等操作。

1. 维护抓取管线的工程团队，可用 obscura scrape 和多个 worker 并行处理一批页面，并将每页求值结果汇总为 JSON。
2. 构建自主浏览任务的智能体开发者，可通过 MCP 工具完成导航、页面快照、点击、表单填写、键盘操作和 JavaScript 求值。
3. 已有 Puppeteer 或 Playwright 自动化代码的团队，可让客户端通过 CDP 连接 Obscura，评估以较轻的自托管引擎替代 headless Chrome。
4. 需要归档网页视觉结果的服务，可直接生成整页 PNG、CDP 页面录屏流或 PDF，而无需另行启动 Chromium。
5. 处理容易触发反自动化或跟踪脚本的网站测试人员，可在构建了 stealth 功能的版本中启用指纹随机化和跟踪器阻止。
6. 需要下载图片、JSON、JavaScript、CSS 或其他非 HTML 内容的采集程序，可使用 --dump original 绕过 JavaScript/DOM 层并流式输出原始响应体。

这个 Agent 有哪些优点和局限？

如何安装或部署这个 Agent？

最直接的方式是下载对应平台的发布包。例如 Linux x86_64：

curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-x86_64-linux.tar.gz
tar xzf obscura-x86_64-linux.tar.gz
./obscura fetch https://example.com --eval "document.title"

Linux ARM64、macOS Apple Silicon、macOS Intel 和 Windows 也有对应归档；Arch Linux 可运行 yay -S obscura-browser，NixOS 可运行 nix-env -iA nixpkgs.obscura。发布归档同时包含 obscura 与 obscura-worker，使用并行 scrape 时应将两者放在同一目录。也可通过 Docker 启动：docker run -d --name obscura -p 127.0.0.1:9222:9222 h4ckf0r0day/obscura。源码构建要求 Rust 1.75+；带渲染的命令为 cargo build --release -p obscura-cli --bins --features render，渲染加 stealth 使用 --features render,stealth。stealth 构建还需要 CMake、Clang 以及 libclang/LLVM 开发库。上述本地调用不要求凭据，但目标网站或代理可能有各自的认证要求。

如何使用这个 Agent？

单页验证可运行：obscura fetch https://example.com --dump text。需要截图时运行：obscura fetch https://example.com --screenshot page.png。并行抓取示例：obscura scrape url1 url2 url3 --concurrency 25 --eval "document.querySelector('h1').textContent" --format json。要接入 Puppeteer 或 Playwright，先执行 obscura serve --port 9222，然后分别使用 puppeteer.connect({ browserWSEndpoint: 'ws://127.0.0.1:9222/devtools/browser' }) 或 chromium.connectOverCDP({ endpointURL: 'ws://127.0.0.1:9222' })。Claude Desktop 可配置 MCP 子进程：{"mcpServers":{"obscura":{"command":"obscura","args":["mcp"]}}}；其他支持 HTTP MCP 的客户端可连接运行 obscura mcp --http --port 8080 后的 http://127.0.0.1:8080/mcp。访问网页需要网络；截图、PDF、下载和输出文件需要写入文件系统。

这个 Agent 与同类方案有什么区别？

常见问题