Skip to content
Notes
OSINT
Tools
Blackbird

Blackbird

Blackbird Banner

Blackbird adalah alat Open Source Intelligence (OSINT) yang dirancang khusus untuk melakukan pencarian cepat dan mendalam terhadap akun pengguna berdasarkan username atau email di berbagai platform daring (online).

Tools ini sangat berguna dalam proses:

  • Investigasi digital
  • Profiling pengguna
  • Pengumpulan data dari sumber terbuka

Getting Started

Note

Catatan: Dibutuhkan Python 3.8 atau versi di atasnya.

Persiapan Instalasi

1. Kloning Repositori

Unduh kode sumber Blackbird dari repositori resmi GitHub:

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

2. Konfigurasi Virtual Environment (Disarankan)

Gunakan lingkungan virtual agar dependencies tidak mengganggu pustaka sistem utama Anda:

Windows :

python -m venv venv
source venv/Scripts/activate

Linux / MacOS :

python3 -m venv venv
source venv/bin/activate

3. Instalasi Modul yang Diperlukan

Pasang semua pustaka Python yang dibutuhkan oleh alat ini:

pip install -r requirements.txt

✅ Selesai!

Sekarang Anda siap menjalankan Blackbird. Gunakan perintah berikut untuk melihat opsi bantuan:

$ python blackbird.py --help

usage: blackbird [-h] [-u [USERNAME ...]] [-uf USERNAME_FILE] [--permute]
                 [--permuteall] [-e [EMAIL ...]] [-ef EMAIL_FILE] [--csv]
                 [--pdf] [--json] [-v] [-ai] [--setup-ai] [--filter FILTER]
                 [--no-nsfw] [--dump] [--proxy PROXY] [--timeout TIMEOUT]
                 [--max-concurrent-requests MAX_CONCURRENT_REQUESTS]
                 [--no-update] [--about]

An OSINT tool to search for accounts by username in social networks.

options:
  -h, --help            show this help message and exit
  -u [USERNAME ...], --username [USERNAME ...]
                        One or more usernames to search.
  -uf USERNAME_FILE, --username-file USERNAME_FILE
                        The list of usernames to be searched.
  --permute             Permute usernames, ignoring single elements.
  --permuteall          Permute usernames, all elements.
  -e [EMAIL ...], --email [EMAIL ...]
                        One or more email to search.
  -ef EMAIL_FILE, --email-file EMAIL_FILE
                        The list of emails to be searched.
  --csv                 Generate a CSV with the results.
  --pdf                 Generate a PDF with the results.
  --json                Generate a JSON with the results.
  -v, --verbose         Show verbose output.
  -ai, --ai             Use AI features.
  --setup-ai            Configure the API key required for AI features.
  --filter FILTER       Filter sites to be searched by list property value.E.g
                        --filter "cat=social"
  --no-nsfw             Removes NSFW sites from the search.
  --dump                Dump HTML content for found accounts.
  --proxy PROXY         Proxy to send HTTP requests though.
  --timeout TIMEOUT     Timeout in seconds for each HTTP request (Default is
                        30).
  --max-concurrent-requests MAX_CONCURRENT_REQUESTS
                        Specify the maximum number of concurrent requests
                        allowed. Default is 30.
  --no-update           Don't update sites lists.
  --about               Show about information and exit.

Penggunaan Dasar

Caution

Blackbird dapat melakukan kesalahan dalam identifikasi. Selalu lakukan verifikasi ulang terhadap informasi yang ditemukan.

Reverse Search

Mencari satu username:

python blackbird.py --username username1

Mencari beberapa username sekaligus:

python blackbird.py --username username1 username2 username3

Menggunakan file list username:

python blackbird.py --username-file usernames.txt

Output Contoh

Email Output

Username Output

Export Data

Blackbird mendukung beberapa format export untuk kebutuhan analisis lanjutan.

python blackbird.py --username target_user --pdf

Export PDF

DUMP (HTTP Response)

Digunakan untuk menyimpan seluruh response HTTP dari akun yang ditemukan.

python blackbird.py --username username1 --dump

Advanced Usage

Verbose

Mode verbose memberikan informasi yang lebih detail selama proses eksekusi.

python blackbird.py --username username1 --verbose

Permute

Jika Anda mengalami kebuntuan dalam investigasi, gunakan --permute untuk menghasilkan variasi username.

python blackbird.py --username john 86 --permute

Perintah ini akan menghasilkan beberapa kombinasi username:

--permute Combinations
john86
_john86
john86_
john_86
john-86
john.86
86john
_86john
86john_
86_john
86-john
86.john

Permute All

Untuk variasi yang lebih luas, gunakan --permuteall.

--permuteall Combinations
john
_john
john_
86
_86
86_
john86
_john86
john86_
john_86
john-86
john.86
86john
_86john
86john_
86_john
86-john
86.john

No NSFW

Gunakan opsi ini untuk mengecualikan situs NSFW dari hasil pencarian.

python blackbird.py --username username1 --no-nsfw

AI Analysis

Blackbird mendukung fitur analisis berbasis AI untuk menghasilkan insight perilaku berdasarkan platform tempat username atau email ditemukan.

Setup

Untuk mengaktifkan fitur AI, lakukan langkah berikut:

1. Generate API Key 

python blackbird.py --setup-ai

API key akan disimpan secara lokal dalam file:

.ai_key.json

2. Jalankan dengan AI

Gunakan flag --ai saat melakukan pencarian:

python blackbird.py --username johndoe --ai

Export

Hasil analisis AI juga akan otomatis disertakan dalam laporan PDF.

Last updated on