bitcrook: open-source intelligence apparatus

by do son · Published June 6, 2022 · Updated May 1, 2024

bitcrook

Bitcrook is an open-source intelligence apparatus that aims to centralize all of the tools necessary to carry out an investigation. Although investigations will still require human interaction to connect the dots, the interface can be tailored to an individual’s needs to expedite the process of due diligence. Some packages do require an authentication key and others do not. See the Package Types tables for more information. Bitcrook can be integrated within your application OR it can be used directly from the terminal/web browser.

Package-Types

Court Cases

Package	Description	Auth	Location	Status
Case Law	Court Case Search	`none`	US	Functioning

IP Address

Package	Description	Auth	Location	Status
IPV4 Address Lookup	IPV4 Address Lookup	`none`	Global	Functioning

Multi-Use

Package	Description	Auth	Location	Status
Have I Been Pwned	Email and Password Vulnerability – (Breaches)	`paid`	Global	Functioning
Melissa	Lookups – Email, Phone Number, IP Address	`free`	US	Functioning

Username

Package	Description	Auth	Location	Status
Username Lookup	Username Lookup – (Comparable to Sherlock)	`none`	Global	Functioning

Vehicle

Package	Description	Auth	Location	Status
VIN Lookup	Vehicle Identification Number Lookup	`none`	–	Functioning

Installation

Fetch the repository via git clone: git clone https://github.com/audioo/bitcrook.git

Usage

Testing

Bitcrook is currently passing all tests; however, I have provided instructions for properly running the tests if you would like to do so. Some tests may not function properly without their corresponding API keys.

In the root directory of Bitcrook, create a file named keyconfig.json

In keyconfig.json, paste the following text:

{

    "melissaKeyCred": "Paste Melissa Key with Credits Here",

    "hibpKey": "Paste Have I Been Pwned Key Here",

    "dataGovKey": "Paste Data.gov Key Here"

}

Paste in your API keys. The test will fail without a valid API key.
In your preferred terminal, enter and run go test ./…

CLI

Navigate to the root directory of Bitcrook via cd
In your preferred terminal, enter and run: go run main.go
After running the aforementioned command, all dependencies will be installed and usage help will be printed to the console.