Collection of crawlers used by the ahmia search engine
Python Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Build Status Code Health Requirements Status

Ahmia is the search engine for .onion domains on the Tor anonymity network. It is led by Juha Nurmi and is based in Finland. This repository contains crawlers used by Ahmia search engine


Ahmia-index should be installed and running

Installation guide

Install dependencies:

Ubuntu 16.04

$ apt-get install build-essential python-pip python-virtualenv
$ apt-get install libxml2-dev libxslt1-dev python-dev libffi-dev libssl-dev
$ apt-get install tor polipo

Fedora 23

$ dnf install @development-tools redhat-rpm-config python-pip python-virtualenv
$ dnf install libxml-devel libxslt-devel python-devel libffi-devel openssl-devel
$ dnf install tor polipo

Install requirements in a virtual environment

$ virtualenv /path/to/venv
$ source /path/to/venv/bin/activate
(venv)$ pip3 install -r requirements.txt

Proxy configuration

Please use polipo config sample here.

Start tor and polipo

$ systemctl start tor
$ systemctl start polipo

Or use with own python HTTP proxy.

$ pip3 install socksipy-branch
$ python
$ curl -x http://localhost:14444 http://msydqstlz2kzerdg.onion/


In order to execute the crawler to run permanently:

$ source /path/to/venv/bin/activate
$ ./ &> crawler.log

For specific run examples, please refer to the crawler guide.

How to use multiple Tor clients ?

You can setup TorBalancer to do this. Don't forget to update the bot