higernes

PythonによるパッシブOSINTツールキット。APIキー不要、アカウント不要、どこにもログイン不要。ハンドル、メールアドレス、ドメイン、IP、電話番号、またはハッシュを指定すると、すでに公開されている情報を掘り下げます。

できること

6つのモジュール、すべて公開エンドポイントを読み取ります:

モジュール	取得できるもの
username	ハンドルを約700サイト（WhatsMyNameデータセット）にわたってスイープし、ヒットが到着するたびにライブ更新
email	構文、MX、使い捨てチェック、gravatar、そして@より前の部分をユーザー名として
domain	A/AAAA/MX/NS/TXT/CNAME、httpステータスとタイトル、証明書透明性ログからのサブドメイン、whois
ip	geo + ASN、逆引きDNS、一般的なポートのオプションスキャン
phone	有効性、キャリア、地域、回線種別、タイムゾーン
hash	長さ/文字セットの識別
scan	C++コアによる、バナー取得付きの高速TCPポートスキャン

ここにあるものはどれもプライベートなものには触れません。すべてDNS、WHOIS、公開プロファイルエンドポイント、証明書ログです。

サイトデータベース

ユーザー名スイープはdata/wmn-data.jsonで動作します - コミュニティの WhatsMyNameデータセットで、約700サイト それぞれにチェックルール（ステータスコードと、存在しなければならない文字列、存在してはならない文字列）があります。新しいコピーをファイルに上書きすればいつでも差し替えられます。ツールは起動時にこれを読み込みます。見つからない場合は小さな組み込みリストにフォールバックします。

--catでスイープを絞り込めます:

python higernes.py username vqkro --cat social
python higernes.py username vqkro --cat gaming

--catなしで実行すると、すべてにヒットします。

C++コア

ポートスキャナはPythonでは遅すぎるため、重い処理はcore/hcore.cppにあります

• スレッド化されたコネクトスキャンを行い、バナー取得とホスト名解決を行う小さなスタンドアロンバイナリです。higernes.pyは自身の隣（またはcore/、あるいはPATH上）でこれを探してシェルアウトします。存在しない場合、ip --portsスキャンは静かに遅い純粋なPython版にフォールバックします。

ビルドする（ソースから実行していて高速パスを使いたい場合のみ必要）:

# windows (mingw g++)
g++ -O2 -std=c++17 -static -o core/hcore.exe core/hcore.cpp -lws2_32

# linux / macOS
g++ -O2 -std=c++17 -o core/hcore core/hcore.cpp -pthread

直接実行したい場合:

hcore dns github.com
hcore ports example.com --banners
hcore ports example.com --all --threads 1024

Releasesページのビルド済み.exeにはすでにコアが組み込まれています。

インストール

Python 3.9以降が必要です。

すべてのOS

pip install -r requirements.txt

これによりrich、requests、dnspython、aiohttpがインストールされます。phonenumbersも含まれていますが、phoneモジュールだけが必要とします - ファイルから削除しても残りは動作します。aiohttpがない場合、ユーザー名スイープはスレッドにフォールバックし、はるかに遅くなります（数百に対して数十秒）。

Windows（PowerShell、pythonがまだPATHにない場合）

winget install --id Python.Python.3.13 -e
git clone https://gitlab.com/jankoboy88/higernes
cd higernes
pip install -r requirements.txt
python higernes.py

Linux / macOS

git clone https://gitlab.com/jankoboy88/higernes
cd higernes
python3 -m pip install -r requirements.txt
python3 higernes.py

FreeBSD

pkg install -y python3
git clone https://gitlab.com/jankoboy88/higernes
cd higernes
python3 -m pip install -r requirements.txt

pipがexternally-managed environmentについて文句を言う場合は、venvを使うか:

python3 -m venv .venv && . .venv/bin/activate && pip install -r requirements.txt

--break-system-packagesを渡してください。

使い方

そのまま実行するとメニューが表示されます。またはモジュールを直接指定できます:

python higernes.py username vqkro
python higernes.py username vqkro --cat coding
python higernes.py email [email protected]
python higernes.py domain example.com
python higernes.py ip 1.1.1.1 --ports
python higernes.py phone +14155552671
python higernes.py hash 5f4dcc3b5aa765d61d8327deb882cf99
python higernes.py scan example.com
python higernes.py scan example.com --all

画面はすべてライブスピナーと色付きテーブルです。ワードマークは起動時に描画されます。

注意事項

• dnspythonとrequestsを強く推奨します。dnspythonがない場合、Aレコードのみが解決され（stdlibを使用）、他のすべてのレコードタイプはスキップされます。
• サイトスイープはヒューリスティックです - 「見つかった」とはエンドポイントがそのポジティブシグナルを返したという意味にすぎないので、対応を計画しているものは必ず再確認してください。
• ip-apiの無料枠は1分あたり約45ルックアップに制限されています。
• crt.shは遅いかダウンしている可能性があります。その場合、そのセクションはその旨を表示して次に進みます。

スタンドアロンexeのビルド

ターゲットマシンにPythonがない？バンドルしましょう:

pip install pyinstaller
pyinstaller --onefile --name higernes --console higernes.py
# -> dist/higernes.exe

これがReleasesページのバイナリの作り方です。他に設定するものはありません。

ライセンス

MIT。LICENSEを参照。