HunxByts/GhostTrack

⭐ 5,227 🍴 603 Python📄 No license GitHubで見る →

主な特徴

  • **IP Tracker**: IPアドレスから地理的位置、ISP、組織情報を取得
  • **Phone Tracker**: 電話番号から国、地域、キャリア、タイムゾーン情報を分析
  • **Username Tracker**: ソーシャルメディアでのユーザー名の存在確認
  • **Simple Interface**: コマンドラインベースのシンプルな操作
  • **API Integration**: 外部APIサービスとの連携によるデータ取得
  • **Multi-platform Support**: Linux、Termux（Android）での動作対応

リポジトリ解析: HunxByts/GhostTrack

基本情報

  • リポジトリ名: HunxByts/GhostTrack
  • 主要言語: Python
  • スター数: 5,227
  • フォーク数: 603
  • 最終更新: 2025年
  • ライセンス: No license
  • トピックス: OSINT、Information Gathering、IP Tracking、Phone Number Analysis

概要

一言で言うと

IP アドレス、電話番号、ユーザー名から公開情報を収集するOSINT（Open Source Intelligence）ツール。

詳細説明

GhostTrackは、サイバーセキュリティ分野におけるOSINT（オープンソースインテリジェンス）ツールの一つで、公開されている情報源からデータを収集・分析する機能を提供します。主にIPアドレスの地理的情報、電話番号の詳細情報、ソーシャルメディアでのユーザー名検索を行うことができます。

このツールは情報収集や調査目的で設計されており、デジタル・フォレンジクス、セキュリティ監査、サイバー脅威分析などの分野で使用される可能性があります。ただし、プライバシーや法的な観点から適切な使用が求められるツールです。

主な特徴

  • IP Tracker: IPアドレスから地理的位置、ISP、組織情報を取得
  • Phone Tracker: 電話番号から国、地域、キャリア、タイムゾーン情報を分析
  • Username Tracker: ソーシャルメディアでのユーザー名の存在確認
  • Simple Interface: コマンドラインベースのシンプルな操作
  • API Integration: 外部APIサービスとの連携によるデータ取得
  • Multi-platform Support: Linux、Termux（Android）での動作対応

使用方法

インストール

前提条件

  • Python 3.x
  • インターネット接続（API呼び出し用）
  • Linux系OS または Termux（Android）

インストール手順

# 方法1: Debian/Ubuntu系
sudo apt-get install git
sudo apt-get install python3

# 方法2: Termux（Android）
pkg install git
pkg install python3

# リポジトリクローン・セットアップ
git clone https://github.com/HunxByts/GhostTrack.git
cd GhostTrack
pip3 install -r requirements.txt

基本的な使い方

Hello World相当の例

# ツールの起動
python3 GhostTR.py

# メニューが表示され、以下のオプションから選択
# 1. IP Tracker
# 2. Phone Tracker  
# 3. Username Tracker

実践的な使用例

# IP情報の取得例（コード内で使用されるAPI）
# ipwho.is API を使用してIP情報を取得
# 例: http://ipwho.is/8.8.8.8

# 電話番号情報の取得例
# phonenumbers ライブラリを使用
# 例: +6281234567890 の形式で入力

高度な使い方

# 他のOSINTツールとの組み合わせ
# Seekerツールとの連携（README内で言及）
# 複数の情報源からの情報収集

ドキュメント・リソース

公式ドキュメント

  • README.md: 基本的な使用方法と機能説明
  • asset/: スクリーンショット画像とサンプル結果

サンプル・デモ

  • asset/ip.png: IP追跡機能のデモ画面
  • asset/phone.png: 電話番号追跡機能のデモ画面
  • asset/User.png: ユーザー名追跡機能のデモ画面

チュートリアル・ガイド

  • GitHub リポジトリのREADME内での基本的な使用手順
  • 関連ツール（Seeker）への参照リンク

技術的詳細

アーキテクチャ

全体構造

シンプルなPythonスクリプト構造で、メニュー駆動のCLIアプリケーションとして設計されています。外部APIサービスと連携してデータを取得し、ローカルで整形・表示を行います。

ディレクトリ構成

GhostTrack/
├── GhostTR.py           # メインプログラム
├── requirements.txt     # Python依存関係
├── README.md           # プロジェクト説明書
└── asset/              # デモ画像とリソース
    ├── User.png
    ├── bn.png
    ├── ip.png
    ├── phone.png
    └── text

主要コンポーネント

  • IP_Track()関数: IPアドレス情報収集機能

    • 場所: GhostTR.py内
    • 依存: ipwho.is API、requests ライブラリ
    • インターフェース: HTTP APIコール、JSON解析

  • phoneGW()関数: 電話番号情報分析機能

    • 場所: GhostTR.py内
    • 依存: phonenumbers ライブラリ
    • インターフェース: phonenumbers API、地域コード分析

技術スタック

コア技術

  • 言語: Python 3.x
  • 主要ライブラリ:
    • requests: HTTP API通信
    • phonenumbers: 電話番号解析・検証
    • json: APIレスポンス処理

開発・運用ツール

  • パッケージ管理: pip3、requirements.txt
  • プラットフォーム: Linux、Termux
  • 外部サービス: ipwho.is API、Google Maps連携

設計パターン・手法

  • Menu-driven CLI: ユーザーフレンドリーなメニューシステム
  • API Integration Pattern: 外部サービスAPIとの統合
  • Decorator Pattern: @is_optionデコレータによる共通処理

データフロー・処理フロー

  1. メニュー表示: ユーザーが機能を選択
  2. データ入力: 対象IP、電話番号、ユーザー名の入力
  3. API呼び出し: 外部サービスへのHTTP リクエスト
  4. データ解析: 取得したJSONデータの解析・整形
  5. 結果表示: コンソール上での情報表示

API・インターフェース

公開API

外部API依存関係

  • 目的: 公開情報の取得
  • 使用例:
# ipwho.is API の利用例
req_api = requests.get(f"http://ipwho.is/{ip}")
ip_data = json.loads(req_api.text)

設定・カスタマイズ

設定ファイル

# requirements.txt
requests
phonenumbers

拡張・プラグイン開発

シンプルな構造により、新しい情報源やAPI統合の追加は比較的容易。ただし、モジュラー設計は限定的。

パフォーマンス・スケーラビリティ

パフォーマンス特性

  • 処理速度: 外部APIのレスポンス時間に依存
  • リソース使用量: 軽量（主にHTTP通信とJSON解析）

スケーラビリティ

単一ユーザー向けツールとして設計されており、大規模な並列処理やエンタープライズレベルでの利用は想定されていません。

制限事項

  • 外部APIサービスの利用制限・レート制限に依存
  • インターネット接続必須
  • 取得できる情報は公開されているものに限定

評価・所感

技術的評価

強み

  • シンプルで理解しやすいコード構造
  • 複数の情報源からの統合的なデータ収集
  • 軽量で高速な動作
  • 多言語対応（インドネシア語コメント含む）

改善の余地

  • エラーハンドリングの強化が必要
  • APIキー管理やレート制限への対応
  • セキュリティとプライバシー考慮の強化
  • モジュール分割による保守性向上

向いている用途

  • サイバーセキュリティ教育・学習目的
  • デジタル・フォレンジクス調査
  • ネットワーク管理者によるインフラ調査
  • セキュリティ研究者による脅威分析

向いていない用途

  • 悪意のあるストーキングや嫌がらせ
  • プライバシー侵害を目的とした調査
  • 法的許可のない第三者情報収集
  • 商用サービスでの大規模運用

総評

GhostTrackは、OSINT分野における基本的なツールとして、教育や研究目的では一定の価値を持っています。技術的にはシンプルながら効果的な実装がなされており、サイバーセキュリティの学習教材としては有用です。

ただし、このようなツールの使用には高い倫理観と法的責任が伴います。プライバシー保護、適用法規の遵守、そして悪意のない目的での使用が絶対的に必要です。セキュリティ専門家や研究者が責任を持って使用する場合に限り、防御的セキュリティの向上に貢献できるツールと評価できます。

重要な注意事項: このツールの使用は、適用される法律と倫理ガイドラインに完全に準拠して行われる必要があります。不適切な使用は法的問題を引き起こす可能性があります。