TorSeeker is a command line tool and a Python module that can be used to query information about Tor relays.
From the command line, queries can be performed relatively easy by using a two letter country code or via one or multiple Tor IP addresses.
As a Python module, TorSeeker offers a reasonable and easy approach for querying information about Tor relays from within your own Python script or module.
Internet connection is required in order to perform Tor network queries.
For full documentation, please visit torseeker.readthedocs.io
This section provides several methods for installing TorSeeker.
TorSeeker can be build and deployed directly from the source. It can be obtained as follows:
$ git clone https://github.com/rwprimitives/tor-seeker.git
It is highly recommended that TorSeeker be installed using pip to ensure that the latest version is being used.
To install simply run:
$ pip install torseeker
This section walks you through the different ways TorSeeker can be used as a command line tool.
TorSeeker provides two simple methods for querying information about Tor relays. A query can be performed by specifying a two letter country code or by using one or multiple Tor IP addresses. The end result will be the same.
To view the different options supported, execute torseeker with -h or --help option:
usage: torseeker [-h] [-d] [-v] (-c | --ip [...])
A tool used to query information about Tor relays by using a two
letter country code or via Tor IP addresses.
optional arguments:
-h, --help show this help message and exit
-d, --details show additional information
-v show program's version number and exit
-c , --country two letter country code of interest
--ip [ ...] one or more tor IP addresses spaced separated
The following example shows how to use -c option with the two letter country code for Costa Rica:
$ torseeker -c cr
TorSeeker v1.0.2 by eldiablo
Country: Costa Rica
Total relays: 12
Guard relays: 2
Middle relays: 5
Exit relays: 5
Using the same command and specify the -d option to get additional information about the relays:
$ torseeker -c cr -d
TorSeeker v1.0.2 by eldiablo
Country: Costa Rica
Total relays: 12
Guard relays: 2
Middle relays: 5
Exit relays: 5
GUARD RELAYS [2]
----------------
138.59.18.106 | Port: 443, Nickname: Albis, Country: Costa Rica, First seen: 2019-02-20 21:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-02-24 02:11:04
138.59.18.105 | Port: 88, Nickname: TheMind, Country: Costa Rica, First seen: 2019-02-20 14:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-02-17 06:16:04
MIDDLE RELAYS [5]
-----------------
200.122.181.101 | Port: 443, Nickname: Karai, Country: Costa Rica, First seen: 2018-01-11 14:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-03-16 19:21:09
201.192.156.175 | Port: 8118, Nickname: khazad8337, Country: Costa Rica, First seen: 2022-03-19 16:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-03-19 15:20:08
190.10.8.50 | Port: 443, Nickname: cragg, Country: Costa Rica, First seen: 2019-10-31 15:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-02-19 23:07:03
190.10.8.68 | Port: 443, Nickname: cressington, Country: Costa Rica, First seen: 2016-04-08 16:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-01-08 22:56:28
200.122.181.78 | Port: 443, Nickname: Splinter, Country: Costa Rica, First seen: 2018-01-17 20:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2021-06-30 21:23:25
EXIT RELAYS [5]
---------------
138.59.17.40 | Port: 443, Nickname: barwin, Country: Costa Rica, First seen: 2020-02-06 18:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2021-11-24 10:22:18, IPv6: 2803:6900:533:1:216:3eff:fe70:a38, IPv6 Port: 443
179.48.251.188 | Port: 443, Nickname: toritico01, Country: Costa Rica, First seen: 2019-02-13 15:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-02-21 10:10:31
200.122.181.2 | Port: 443, Nickname: Michelangelo, Country: Costa Rica, First seen: 2020-10-02 16:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-03-16 19:11:08
138.59.18.110 | Port: 443, Nickname: demonteal, Country: Costa Rica, First seen: 2019-05-14 18:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-03-23 12:51:11
190.10.8.166 | Port: 443, Nickname: Donatello, Country: Costa Rica, First seen: 2021-03-12 20:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-01-04 22:48:54
The following example shows how to use --ip option with the two Tor relay IP addresses:
$ torseeker --ip 138.59.18.106 190.10.8.166
TorSeeker v1.0.2 by eldiablo
Total relays: 2
Guard relays: 1
Middle relays: 0
Exit relays: 1
Using the same command and specify the -d option to get additional information about the relays:
$ torseeker --ip 138.59.18.106 190.10.8.166 -d
TorSeeker v1.0.2 by eldiablo
Total relays: 2
Guard relays: 1
Middle relays: 0
Exit relays: 1
GUARD RELAYS [1]
----------------
138.59.18.106 | Port: 443, Nickname: Albis, Country: Costa Rica, First seen: 2019-02-20 21:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-02-24 02:11:04
MIDDLE RELAYS [0]
-----------------
None
EXIT RELAYS [1]
---------------
190.10.8.166 | Port: 443, Nickname: Donatello, Country: Costa Rica, First seen: 2021-03-12 20:00:00, Last seen: 2022-03-24 02:00:00, Last restarted: 2022-01-04 22:48:54