/beagle

Beagle is a CLI written in Go to search for an specific username across the Internet.

Primary LanguageGoMIT LicenseMIT

Beagle

Go Report Card CircleCI GoDoc Docker Pulls PRs Welcome

            __
 \,--------/_/'--o    Use beagle with
 /_    ___    /~"     responsibility.
  /_/_/  /_/_/
^^^^^^^^^^^^^^^^^^

Beagle is a CLI written in Go to search for an specific username across the Internet.

Beagle is a project inspired by Sherlock.

Example

beagle -g 10 -t 1s -u me -v

Install

Go

go install github.com/danielkvist/beagle

Docker

docker image pull danielkvist/beagle

Note that the image danielkvist/beagle uses the urls.csv file from this repository. So it is not a valid option if you want to customize the URLs that beagle is gonna to use.

Cloning the repository

# First, clone the repository
git clone https://github.com/danielkvist/beagle

# Then navigate into the beagle directory
cd beagle

# Run
go run main.go

# Or install
go install

Building the Docker image

# Inside the beagle directory, after cloning the git repository:
docker image build -t beagle .

Options

$ beagle --help
Beagle is a CLI written in Go to search for an specific username across the Internet.

Usage:
  beagle [flags]

Examples:
beagle -g 10 -t 1s -u me -v

Flags:
  -a, --agent string       user agent (default "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:67.0) Gecko/20100101 Firefox/67.0")
      --debug              prints errors messages
  -f, --file string        .csv file with the URLs to check (default "./urls.csv")
  -g, --goroutines int     number of goroutines (default 1)
  -h, --help               help for beagle
  -p, --proxy string       proxy URL
  -t, --timeout duration   max time to wait for a response from a site (default 3s)
  -u, --user string        username you want to search for (default "me")
  -v, --verbose            prints all the results

URLs .csv file

The urls.csv file of this repository contains more than 500 sites. Yet it's still possible that some sites may still be missing. If you have any suggestions please let me know by opening an issue.

The format of the .csv file, if you do not want to use the one provided by this repository must have the following structure:

name, mainURL, userURL

The URLs must contain a $ where the username should go, for example:

instagram,https://instagram.com/$,https://instagrma.com/$
devianart,https://$.devianart.com,https://$.devianart.com

Use Beagle with responsability

Beagle is a tool whose use I am not responsible for. And that has been built for the sole purpose of learning more about Go.

Help is always welcome

If you have any problems or there is something you would like to improve please let me know.