> For the complete documentation index, see [llms.txt](https://docs.obscura.sh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.obscura.sh/reference/cli-reference.md). # CLI reference ### `obscura` Top-level flags apply to every subcommand. ``` -v, --verbose Enable info logging -p, --port CDP port (default 9222) --proxy HTTP or SOCKS5 proxy --stealth Consistent browser fingerprint + tracker blocking --obey-robots Respect robots.txt --user-agent Override the User-Agent --storage-dir Persistent cookies and localStorage --allow-private-network Permit loopback / RFC1918 / link-local --v8-flags Raw V8 flags, applied at startup -h, --help Help -V, --version Version ``` ### `obscura fetch ` Load a URL and print its content or an evaluated expression. ``` --dump html | text | links | markdown | original | assets | cookies (default html) --selector Narrow output to a CSS selector --wait Extra wait after settle (default 5) --timeout Navigation timeout (default 30) --wait-until domcontentloaded | load | networkidle2 | networkidle0 (default load) --user-agent Override the User-Agent --proxy HTTP or SOCKS5 proxy --stealth Consistent browser fingerprint + tracker blocking (global) -e, --eval Evaluate JS, print the result as JSON -o, --output Write to a file instead of stdout -q, --quiet Suppress info logging -v, --verbose Enable verbose logging ``` `--dump` values: | Value | Output | | ---------- | ------------------------------------------------------------------------------------------------- | | `html` | Rendered HTML (default) | | `text` | Plain text | | `markdown` | Markdown conversion | | `links` | Every ``, one URL per line | | `assets` | Every external resource, one JSON object per line (DOM assets plus `fetch()`/XHR requests) | | `original` | Raw HTTP response body (binary-safe, bypasses the engine) | | `cookies` | All cookies in the jar as a JSON array, including HttpOnly cookies invisible to `document.cookie` | ### `obscura serve` Run the CDP server. Puppeteer and Playwright connect over WebSocket. ``` -p, --port CDP port (default 9222) --host Bind host (default 127.0.0.1) --proxy HTTP or SOCKS5 proxy --user-agent Override the User-Agent --stealth Consistent browser fingerprint + tracker blocking (global) --workers Worker processes (default 1) --allow-file-access Permit CDP clients to navigate to file:// URLs --storage-dir Persistent cookies and localStorage --allow-private-network Permit loopback / RFC1918 / link-local -q, --quiet Suppress info logging -v, --verbose Enable info logging ``` Default endpoint is `ws://127.0.0.1:9222`. ### `obscura scrape [URLS]...` Run a JS expression across many URLs in parallel. ``` -e, --eval JS to run on each page --concurrency Parallel pages (default 10) --format Output format (default json) --timeout Per-URL timeout (default 60) --proxy HTTP or SOCKS5 proxy --stealth Consistent browser fingerprint + tracker blocking (global) --allow-private-network Permit loopback / RFC1918 / link-local -q, --quiet Suppress info logging -v, --verbose Enable verbose logging ``` `--stealth`, `--proxy`, and `--allow-private-network` are global flags: they work before or after any subcommand, so each worker in a `scrape` run inherits stealth too. Read URLs from stdin with `-`: ```bash cat urls.txt | obscura scrape - --eval "document.title" --concurrency 20 ``` Requires `obscura-worker` next to `obscura` in `PATH`. ### `obscura mcp` Run obscura as an MCP server. ``` --http HTTP transport instead of stdio --host HTTP bind host (default 127.0.0.1) --port HTTP port (default 3000) --proxy HTTP or SOCKS5 proxy --user-agent Override the User-Agent --stealth Consistent browser fingerprint + tracker blocking (global) --allow-private-network Permit loopback / RFC1918 / link-local -v, --verbose Enable info logging ``` `--host` only applies with `--http`. The default `127.0.0.1` keeps the server loopback-only; set `0.0.0.0` to bind all interfaces (for example a Docker Compose sidecar) and pair it with `OBSCURA_MCP_ALLOWED_ORIGINS`. Default transport is stdio. See [Use the MCP server](/guides/use-the-mcp-server.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.obscura.sh/reference/cli-reference.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.