Darkan is a Go application that sniffs into libreddit (for now) for a given keyword and returns the HTML content if the keyword is present.
Before using Darkan, you need to install Tor on your machine and add it to your $PATH. You can install Tor using Homebrew by running the following command:
$ brew install tor
$ export PATH="/opt/homebrew/bin/tor:$PATH"Update: Now you don't need to open it or establish a connection manually, however, you still need a Tor instance, it can be local (recommended) or remote.
The first step you need to do is to create a development database and run the migrations by running:
$ go run ./cmd/db create
$ go run ./cmd/db migrate
To run the app in development you can run the following command:
$ go run ./cmd/dev
Root path for the endpoints will be available at http://localhost:3000.
POST /api/search (registers a new keyword to search with a callback URL to be notified)
name type data type description value required string (JSON) Value to search in the Dark Web callback_url required string (JSON) Endpoint URL to be notified once a keyword in found
http code content-type response 201application/jsonKeyword registered successfully500application/json{"code":"400","message":"Internal server error saving keyword."[TODO: Validations]N/A N/A
curl -X POST -H "Content-Type: application/json" --data @keyword.json http://localhost:3000/api/search
GO_ENV - The environment the app is running in. Defaults "development"
PORT - The port the app will run on. Defaults "3000"
TOR_PROXY - The Tor proxy you want to use. Defaults "socks5://127.0.0.1:9050"In case you want to use a remote TOR instance, you can set a Tor Relay listed here.