Command Line Interface

Basic Usage

leakpy [OPTIONS] COMMAND [ARGS...]

Global Options

--silent: Suppress all output (useful for scripting)

--raw: Output raw JSON instead of formatted tables (useful for scripting/piping)

Commands

Search

leakpy search [OPTIONS]

Options:

-q, --query QUERY: Search query string

-p, --pages PAGES: Number of pages to fetch (default: 2)

-s, --scope {service,leak}: Search scope (default: leak)

-P, --plugins PLUGINS: Plugin(s) to use (comma-separated)

-f, --fields FIELDS: Fields to extract (comma-separated). Default: protocol,ip,port (for URL formatting). Use full for complete JSON.

-b, --bulk: Activate bulk mode (requires Pro API, only works with scope=”leak”)

-o, --output OUTPUT: Output file path

Examples:

$ leakpy search -q '+country:"France"' -p 5
$ leakpy search -q '+country:"France"' -f protocol,ip,port,host
$ leakpy search -q '+country:"France"' -f full -o results.json
$ leakpy search -q 'plugin:TraccarPlugin' -b -o results.txt
$ leakpy --raw search -q '+country:"France"' -p 5

Lookup

leakpy lookup {host,domain,subdomains} [OPTIONS]

Options:

-i, --input INPUT: Input file for batch processing

-o, --output OUTPUT: Output file path

-f, --fields FIELDS: Fields to extract (comma-separated)

Examples:

$ leakpy lookup host 157.90.211.37
$ leakpy lookup domain leakix.net
$ leakpy lookup subdomains leakix.net
$ leakpy --raw lookup host 157.90.211.37

List

leakpy list {plugins,fields} [OPTIONS]

Examples:

$ leakpy list plugins
$ leakpy list fields
$ leakpy --raw list plugins

Config & Cache

$ leakpy config set
$ leakpy cache clear
$ leakpy cache set-ttl 10

Stats

$ leakpy stats cache
$ leakpy stats query -q '+country:"France"' -p 5
$ leakpy stats query -q 'plugin:TraccarPlugin' -b
$ leakpy stats query -f results.json --fields "geoip.country_name,protocol"
$ leakpy stats query -f results.json --all-fields
$ leakpy stats query -f results.json --top 15

For complete help, use leakpy COMMAND --help.