CLI Reference

Nginjen ships as a single binary with subcommands for all operations.

Global Flags

Flag	Description
--config <PATH>	Path to config TOML file
--verbose	Enable verbose (debug) logging
--quiet	Suppress all output except errors
-h, --help	Show help
-V, --version	Show version

Commands

serve

Start the HTTP API server.

nginjen serve [--host 0.0.0.0] [--port 9090]

Flag	Default	Description
--host	127.0.0.1	Bind address
--port	9090	Listen port

scrape

Extract page content from a URL.

nginjen scrape <URL> [--format html|text|markdown] [--wait 2000]

Flag	Default	Description
<URL>	(required)	Target URL
--format	text	Output format: html, text, markdown
--wait	2000	Wait time in ms after load
--profile	windows	Fingerprint profile

screenshot

Capture a screenshot of a URL.

nginjen screenshot <URL> [-o output.png] [--width 1920] [--height 1080] [--full-page]

Flag	Default	Description
<URL>	(required)	Target URL
-o	screenshot.png	Output file path
--width	1920	Viewport width
--height	1080	Viewport height
--full-page	false	Capture full page (not just viewport)

search

Search the web using built-in backends.

nginjen search <QUERY> [--backend meta] [--limit 10]

Flag	Default	Description
<QUERY>	(required)	Search query
--backend	lite	Backend: lite, bing, brave, meta, searxng
--limit	10	Max results

engine

Manage the browser engine.

nginjen engine status    # Show engine status
nginjen engine download  # Force download Chromium
nginjen engine path      # Print engine binary path

doctor

Run diagnostic health checks.

nginjen doctor

Checks 13 areas:

1. Engine binary exists and is executable
2. Engine version compatibility
3. Network connectivity
4. Disk space for temp files
5. System dependencies (fonts, libs)
6. Headless mode availability
7. CDP connection
8. Stealth injection
9. Screenshot capability
10. Cookie storage
11. Proxy connectivity (if configured)
12. Search backend connectivity
13. API server bind

profiles

Manage fingerprint profiles.

nginjen profiles list                    # List all profiles
nginjen profiles show <name>             # Show profile details
nginjen profiles create <name> --os windows --browser chrome
nginjen profiles delete <name>           # Delete custom profile

Examples

# Scrape and convert to markdown
nginjen scrape https://example.com --format markdown > page.md

# Screenshot at specific size
nginjen screenshot https://example.com -o wide.png --width 2560 --height 1440

# Full-page screenshot
nginjen screenshot https://example.com -o full.png --full-page

# Meta-search (fan-out to DDG + Bing + Brave)
nginjen search "rust web scraping" --backend meta --limit 20

# Run doctor to verify setup
nginjen doctor

# Start server on custom port with config
nginjen serve --port 8080 --config /etc/nginjen/config.toml