Overview

Investigo is a command-line tool written in Go to investigate usernames on social media.

Installation

Download Windows Binary

You can download the binary for Windows.

• Download latest release

$ investigo.exe -h

Build from source

To compile investigo, Go 1.12 or higher is required.

$ git clone https://github.com/tdh8316/Investigo.git
$ cd investigo
$ go build

Build with docker

If you don't have Docker/Docker-Compose check Setup Docker section

Setup Docker

Docker

macOS: https://docs.docker.com/docker-for-mac/install/

linux: https://docs.docker.com/install/linux/docker-ce/ubuntu/

Docker Compose

linux: https://docs.docker.com/compose/install/

Investigo (standalone mode, no screenshots)

Example with docker

$ docker run x0rzkov/investigo:latest investigo USERNAME

Example with docker-compose

$ docker-compose run investigo investigo USERNAME

Investigo (headless chromium mode, with screenshots)

Example run with docker

$ docker run -v $(pwd)/data:/screenshots x0rzkov/investigo-chromium:latest -s USERNAME

Example run with docker-compose

$ docker-compose run investigo-chromium -s USERNAME

Usage

$ investigo -h
Investigo - Investigate User Across Social Networks.

usage: investigo [-h] [--no-color] [-v|--verbose] [-t|--tor] [--update] [--db FILENAME] [--site SITENAME] USERNAME [USERNAMES...]
perform test: investigo [--test]

positional arguments:
        USERNAMES             one or more usernames to investigate

optional arguments:
        -h, --help            show this help message and exit
        -v, --verbose         output sites which is username was not found
        -s, --screenshot      take a screenshot of each matched urls
        -t, --tor             use tor proxy (default: socks5://127.0.0.1:9050)
        --no-color            disable colored stdout output
        --update              update datebase from Sherlock repository
        --db                  use custom database
        --site                specific site to search

Why Investigo?

Investigo is trying to build our own database while keeping compatibility with Sherlock. This is because even though Sherlock project contains a vast database, adult sites are forbidden.

Addding/Fixing site

Investigo uses Sherlock's database.

To add sites...

To add sites to Investigo, make a Pull Request to Sherlock project. Whenever the Sherlock repository updates, the Investigo database will update automatically!

If you want to add prohibited sites for Sherlock, make an issue or a Pull Request to this repository!

To fix incompatible sites...

Make an issue here to let Sherlock developers know.

Contributors

Thanks to all contributors!

• x0rzkov
• lucmski

Contributions are more than welcome!

License

Licensed under the MIT License

Copyright 2020 Donghyeok Tak