Blackbird

An

Setup

Clone the repository

git clone https://github.com/p1ngul1n0/blackbird
cd blackbird

Install requirements

pip install -r requirements.txt

Usage

Search by username

python blackbird.py -u username

Run WebServer

python blackbird.py --web

Access http://127.0.0.1:5000 on the browser

Read results file

python blackbird.py -f username.json

List supportted sites

python blackbird.py --list-sites

Supported Social Networks

Supersonic speed

Blackbird sends async HTTP requests, allowing a lot more speed when discovering user accounts.

JSON Template

Blackbird uses JSON as a template to store and read data.

The data.json file store all sites that blackbird verify.

Params

• app – Site name
• url
• valid – Python expression that returns True when user exists
• id – Unique numeric ID
• method – HTTP method
• json – JSON body POST (needs to be escaped, use this
  https://codebeautify.org/json-escape-unescape)
• {username} – Username place (URL or Body)
• response.status – HTTP response status
• responseContent – Raw response body
• soup – Beautifulsoup parsed response body
• jsonData – JSON response body

Examples

GET

    {
      "app": "ExampleAPP1",
      "url": "https://www.example.com/{username}",
      "valid": "response.status == 200",
      "id": 1,
      "method": "GET"
    }

POST JSON

    {
      "app": "ExampleAPP2",
      "url": "https://www.example.com/user",
      "valid": "jsonData['message']['found'] == True",
      "json": "{{"type": "username","input": "{username}"}}",
      "id": 2,
      "method": "POST"
    }

If you have any suggestion of a site to be included in the search, make a pull request following the template.

Contact

Feel free to contact me on Twitter