Skip to content
Hunt and Analyze Tor Onion Sites
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea
docs
src
.gitignore
Hunt.py
LICENSE.md
README.adoc
onion.db
requirements.txt

README.adoc

Onion-Hunter

About

This package is designed to help anyone hunt for Onion addresses subject to a set of keywords set by the user. The primary design characteristic is to enable the user to define attributes/keywords that they would like to hunt on. All customizable attributes are located within the src/config.py python file. This is the only object that should be edited by the user.

For details about the Onion-Hunter Classes and API, please visit The Wiki


Requirements

  • Python Version: Python 3+

  • Packages: See Requirements.txt

  • Tor: Must be able to route traffic via a Tor Proxy


Usage

Before running Hunt.py for the first time, please follow these steps:

  • Install all requirements:

pip install -r requirements.txt

self.r_username = ""
self.r_password = ""
self.r_client_id = ""
self.r_client_secret = ""
self.r_user_agent = ""
  • Add Keywords to Hunt on to src/config.py

self.keywords = ["Example_keyword_1", "Example_keyword_2"]

Examples

python3 Hunt.py -h
usage: Hunt.py [-h] [-s | -f  | -p | -c]

optional arguments:
  -h, --help    show this help message and exit
  -s, --scan    Scan All The Things
  -f, --file   Import Onions from txt file
  -p, --purge   Purge the whole database
  -c, --clean   Cleanup the DB
Figure 1. Reddit Search

Figure 2. Purging the Database

Continuing Work

  1. Add a reporting class to help cleaning digest the SQL database into a CSV or Excel document.

    • Possibly use Pandas for report generation.


Contact

You can’t perform that action at this time.