onionsearch

Request results from all the search engines

$ onionsearch "[string]"

$ onionsearch "[string]" --engines [tor66 deeplink phobos ...]

$ onionsearch "[string]" --exclude [candle ahmia ...]

$ onionsearch "[stuxnet]" --engines [tor66 deeplink phobos ...] --limit [3]

$ onionsearch --help | grep [[-A|--after-context]] 1 [[-i|--ignore-case]] "supported engines"

onionsearch query [options]

query
    The keyword(s) or phrase to search for across the Tor network.

-s, --search-engines engine1,engine2,...
    Specify a comma-separated list of search engines to use (e.g., ahmia, notevil, darksearch). If omitted, typically uses a default set.

-n, --num-results number
    Set the maximum number of results to fetch per search engine.

-o, --output filename
    Save the search results to the specified file instead of printing to standard output.

-v, --verbose
    Enable verbose output, displaying more details about the search process and requests.

-x, --proxy protocol://host:port
    Specify an alternative SOCKS5 proxy to use for Tor connections (e.g., socks5://127.0.0.1:9050).

-t, --timeout seconds
    Set the connection timeout in seconds for network requests.

-h, --help
    Show the help message and exit.

onionsearch is a command-line utility designed to query various search engines operating on the Tor network (dark web). It automates the process of searching for .onion hidden services, providing a convenient way to discover content not indexed by conventional search engines.

It typically uses the Tor proxy to anonymize requests, ensuring user privacy. The tool aggregates results from multiple dark web search engines, presenting them in a consolidated and often parsable format, making it valuable for researchers, journalists, and anyone exploring the hidden parts of the internet.

onionsearch is not a standard Linux command and must be installed separately (e.g., via pip for Python versions).

It relies on the Tor service being active and accessible, typically through a SOCKS5 proxy on 127.0.0.1:9050. Users should be aware that searching the dark web can expose them to potentially illegal or disturbing content, and they should understand the legal and ethical implications in their jurisdiction.

onionsearch is typically installed via Python's package manager:
pip install onionsearch
Ensure Python 3 and pip are installed on your system.

Requires Python, along with specific Python libraries such as requests, socks, and stem, which are usually handled automatically during pip installation.

onionsearch emerged as a tool primarily developed by s0md3v, aiming to simplify the process of searching Tor hidden services. Its development reflects the growing need for accessible open-source intelligence (OSINT) tools capable of navigating the hidden layers of the internet. It leverages existing dark web search engines, abstracting away the complexities of direct interaction and offering a unified interface for discovery.

tor(1), curl(1), proxychains(1), anonsurf(8)