kennbroorg/ikyOSINTプロジェクト。メールから情報を収集。収集。プロファイリング。タイムライン。
説明 | インストール | ウェブサイト | モジュール | 問題 | 支援
iKy は OSINT ツールであり、メールアドレスまたは他のセレクタから情報を収集し、結果を視覚的インターフェースに表示します。
git clone https://gitlab.com/kennbroorg/iKy.git
cd iKy
just build
just up
ブラウザで http://localhost:4300 を開いてください。
すべてのサービスを停止するには:
just down
just upはbackend、iky-frontend、redisを起動します。デフォルトでは他のサービスは起動されません。
Docker を実行できない場合、iKy はネイティブで実行可能です: Caddy がプリビルドのフロントエンドを提供し、Redis + Celery + Uvicorn がローカルプロセスとして動作します。ホストに redis-server、Python 3.12、curl、tar が必要です（Caddy は自動的にダウンロードされます）。
just setup # venv を作成
just up-native # 依存関係をインストール、Caddy + フロントエンドをダウンロード、すべてを起動
ブラウザで http://localhost:4300 を開いてください。Ctrl-C または just down-native で停止します。
フロントエンドは最新の GitHub リリースから取得されます — Node ビルドは不要です。 ネイティブモードでは
torは起動されません。darkwebモジュールのみ必要です。
| サービス | スタック | ポート |
|---|---|---|
| backend | FastAPI 0.115 + Celery 5.6 | 5000 |
| iky-frontend | Angular 21 + nginx | 4300 |
| redis | Redis 7 | 56379（ホスト） |
| tor | SOCKS5 プロキシ（darkweb モジュール） | 内部 |
iKy は backend/module_registry.py を介して 26 のモジュールをルーティングします:
| カテゴリ | モジュール |
|---|---|
| ソーシャルネットワーク | twitter, linkedin, instagram, tiktok, mastodon, twitch, reddit |
| アイデンティティ / ユーザー名 | github, gitlab, keybase, sherlock, socialscan, holehe, usersearch, skype |
| デート / 支払い | tinder, venmo |
| 音楽 | spotify |
| 評判 / データブローカー | peopledatalabs, emailrep, fullcontact |
| リーク / 侵害 | leaks, leaklookup, darkweb, hudsonrock |
| 検索 | search |
アプリケーションがブラウザに読み込まれたら、設定パネルに API キーを入力してください。以下は backend/factories/apikeys_default.json の全フィールドの表です:
| モジュール | ステータス | apikey のフィールド | 取得方法 |
|---|---|---|---|
| 🆗 🍪 | linkedin_cookies（またはレガシー linkedin_li_at / linkedin_JSESSIONID） | just cookies-grab linkedin linkedin.com または just cookies-import linkedin <ファイル> | |
| 🆗 🍪 | twitter_cookies | just cookies-grab twitter x.com | |
| TikTok | 🆗 🍪 | tiktok_cookies | just cookies-grab tiktok tiktok.com |
| PeopleDataLabs | 🆗 | peopledatalabs_key | 🆓 無料 API — wiki |
| Emailrep | 🆗 | emailrep_key | 🆓 無料 API — wiki |
| Leaklookup | 🆗 | leaklookup_key | 🆓 無料 API — wiki |
| Spotify | 🆗 | spotify_client_id / spotify_client_secret | 🆓 無料 API — wiki |
| Twitch | 🆗 | twitch_client_id / twitch_client_secret | 🆓 無料 API — wiki |
| CSE（Google） | 🆗 | cse_api_key / cse_cx | 🆓 無料 API — wiki |
| Brave | 🆗 | brave_key | 🆓 無料 API |
| ⚠️ | instagram_user / instagram_pass | 改訂中 | |
| Fullcontact | 🛑 | fullcontact_api | 終了 |
| HaveIBeenPwned | 🛑 | haveibeenpwned_key | 終了 |
🍪 マークの API はブラウザセッションクッキーを使用します。それ以外はサービストークンを使用します。
一部のモジュール（LinkedIn、Twitter、TikTok）はブラウザのセッションクッキーを必要とします。クッキーは backend/cookies/ に保存され（コンテナ内では /app/cookies としてマウント）、再起動後も保持されます。ロード方法は 2 つあり、いずれも just を介して行います。
クッキーは個人のセッショントークンです。共有したり、リポジトリにコミットしたりしないでください（
backend/cookies/は git で無視されています）。
Cookie-Editor などの拡張機能を使用してサイトのクッキーを JSON ファイルにエクスポートし、インポートします:
just cookies-import linkedin ~/Downloads/linkedin_cookies.json
ローカルブラウザから直接クッキーを抽出します。実行前にブラウザを閉じてください（開いているブラウザはクッキーデータベースをロックします）:
# インストールされているすべてのブラウザを試す (firefox, chrome, brave, edge)
just cookies-grab linkedin linkedin.com
# または特定のブラウザを指定
just cookies-grab linkedin linkedin.com brave
このコマンドはブラウザごとに読み取り可能なものと不可能なものを報告し、モジュールが必要とするクッキーが見つかった場合のみファイルを書き込みます。たとえば、LinkedIn は li_at と JSESSIONID を必要とします。
| モジュール | ドメイン | 必要なクッキー |
|---|---|---|
| linkedin.com | li_at, JSESSIONID | |
| x.com | auth_token, ct0 | |
| TikTok | tiktok.com | msToken |
クッキーは定期的に期限切れになります（LinkedIn クッキーは 1～3 か月で期限切れ）。モジュールの認証が停止したら、コマンドを再度実行してください。
開発ワークフローでは、リンター/pre-commit フック用の virtualenv と、ビルドおよび実行用の Docker（またはネイティブの just up-native フロー） を使用します。
just をインストールしてから:
just setup
source .venv/bin/activate
これにより、pre-commit と ruff を含む Python virtualenv が作成され、git フックがインストールされます。
| コマンド | 説明 |
|---|---|
just build | Docker イメージをビルド |
just up | すべてのサービスを起動 |
just down | すべてのサービスを停止 |
just logs | バックエンドのログをフォロー（フロントエンドの場合は just logs frontend） |
just ps | 実行中のコンテナを表示 |
just shell-backend | バックエンドコンテナのシェルを開く |
just lint | ruff リンターとフォーマットチェックを実行 |
just fmt | Python コードを自動フォーマット |
just restart backend | 特定のサービスを再起動 |
just rebuild | すべてのサービスを停止、再ビルド、起動 |
just clean | コンテナ、ボリューム、ローカルイメージを削除 |
just up-native | iKy をネイティブで起動（Docker なし） |
just down-native | ネイティブサービスを停止 |
just up-native-clean | ネイティブキャッシュを消去（Caddy、フロントエンド、ログ） |