BIRDY-EDWARDS 2.0

潜入して暴露する

ターゲットのプロファイリング、ネットワーク分析、脅威レポートのための自動AI搭載Facebookインテリジェンスツール。Ollamaを介して完全にデバイス上で動作します。AI搭載Facebook SOCMINTプラットフォーム — 100%ローカル、クラウド依存ゼロ。ライト版はこのリポジトリを確認してください こちらをクリック

インストール · トラブルシューティング · 免責事項 · 貢献

ドキュメント

両方の調査モードの完全な使用ガイドは、プロジェクトのウェブサイトで入手できます:

• こちらをクリック

仕組み

v2.0の新機能

• 🗽 柔軟性 — 任意のフェーズで調査を停止し、PDFレポートを生成できるようになりました
• 🎬 リールインテリジェンス — AIがすべてのリールキャプションからコンテキスト要約、トピック、固有表現、ハッシュタグを抽出します
• 🔗 共同コメンター調整マトリックス — 誰が誰と一緒にコメントしているかのヒートマップ。任意のセルをクリックすると共有投稿が表示されます
• 👤 HOG + CNNハイブリッド顔検出 — 画像サイズによる自動モデル選択とCNN→HOGフォールバック。顔検出はテキスト投稿のスクリーンショットでも実行されます
• 📬 Telegram通知 — 完了時にPDFレポートが設定済みのTelegramチャットへ自動送信されます
• 📄 完全なPDFスイート — 画像インテリジェンス、リールインテリジェンス、顔ギャラリー、投稿タイムライン、共同コメンターペアセクションを追加。ベンガル語、ヒンディー語、アラビア語、ウルドゥー語が正しくレンダリングされます
• ⚙️ 調査キュー — 最大5件の調査がキューに入れられ、順次自動実行されます
• 🔄 リアルタイム進捗ページ — パイプライン中にデータが到着するとライブ統計カウンターが解放されます
• 📅 日付と時刻の修正 — スクレイピング中に正確なタイムスタンプではなく日付のみを収集する可能性があるため、調査担当者としてこれを正確なタイムスタンプに修正することが可能になりました。

機能

• 🔍 プロフィール収集 — 投稿、写真、リール、プロフィール情報、コメント、コメンターのプロフィールリンクと名前の自動データ収集（9戦略の日付抽出付き）
• 🗂️ バッチ調査 — 最大10件の混合投稿URLを送信し、すべてに対して完全なAIパイプラインを実行
• 🧠 インタラクションインテリジェンス — ベンガル語、ヒンディー語、アラビア語、ウルドゥー語、クキ語を含む140以上の言語での各インタラクションに対するAI感情、スタンス、感情、言語分析
• 📊 アクタースコアリング — 5段階分類による加重複合スコア。中深度および深深度スキャンで上位14の二次プロフィールをスクレイピング
• 🌍 国検出 — LLMがプロフィールシグナルから出身国を信頼度%バッジ付きで識別し、コメンターごとのオンデマンド検出も可能
• 🔬 画像インテリジェンス — シーン、群衆、シンボル、武器、OCR、位置推定のための写真ごとのビジョンLLM
• 🎬 リール + テキスト投稿インテリジェンス — AIがキャプションと投稿から固有表現、トピック、ナラティブタイプ、脅威インジケーターを抽出
• 👤 顔インテリジェンス — HOG + CNNハイブリッド検出、128Dエンコーディング、アイデンティティクラスタリング、D3顔ツリー可視化
• 🕸️ ネットワークグラフ — インタラクティブなD3フォースグラフ、クリック時に共有投稿を表示する共同コメンターヒートマップマトリックス、姓クラスターエッジ
• 📄 PDFレポート — 画像インテリジェンス、リールインテリジェンス、顔ギャラリー、投稿タイムライン、共同コメンター分析、多言語スクリプトレンダリングを含む完全なインテリジェンスレポート
• 📬 Telegram配信 — 調査完了時にPDFレポートが設定済みチャットへ自動送信
• 🤖 ローカルAI — Ollama搭載、gemma4:e2b / e4b / 12bおよびその他のモデル、GPUまたはCPUで動作
• 🐳 Docker対応 — LinuxおよびWindowsでワンコマンドデプロイ

⚠️ 免責事項

BIRDY-EDWARDSは、認可されたインテリジェンス、法執行、および学術研究目的のみのために厳格に開発されています。

データアクセスの範囲:

• このツールは、オペレーターによって認証された有効なFacebookセッションのみを使用して動作します
• 公開されているプロフィールデータ、投稿、写真、リール、コメントのみにアクセスします
• プライベートメッセージ、ロックされたプロフィール、制限されたコンテンツ、またはログインユーザーに表示されないデータにはアクセスしません
• ボット、偽アカウント、自動アカウント作成は使用しません — オペレーターが自身の認証済みセッションを提供します

法的責任:

• このツールは、データの収集と分析について明示的な法的認可があるプロフィールとコンテンツでのみ使用する必要があります
• 認可なしの使用は、Facebookの利用規約、適用されるプライバシー法（GDPR、IT法、DPDP法）、および現地の規制に違反する可能性があります
• 開発者は、誤用、無認可のデータ収集、または不適切な使用によって引き起こされるいかなる損害についても責任を負いません
• すべての調査はオペレーターの単独責任です

BIRDY-EDWARDSを使用することにより、あなたの使用が合法的で、認可されており、管轄区域のすべての適用される法律に準拠していることを確認したことになります。

システム要件

インストール

前提条件

ステップ1 — Dockerをインストール

• Linux: https://docs.docker.com/engine/install/ubuntu/
• Windows: https://docs.docker.com/desktop/install/windows-install/

ステップ2 — Ollamaをインストール

• Linux:

curl -fsSL https://ollama.com/install.sh | sh

• Windows: https://ollama.com/download からインストーラーをダウンロード

ステップ3 — すべてのインターフェースにバインドしてOllamaを起動

• Linux:

OLLAMA_HOST=0.0.0.0:11434 ollama serve

これを永続的にするには:

sudo systemctl edit ollama

以下を追加:

[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"

sudo systemctl daemon-reload && sudo systemctl restart ollama

• Windows: Ollamaはデフォルトですべてのインターフェースでリッスンします — 追加設定は不要です。そうでない場合は、

$env:OLLAMA_HOST="0.0.0.0"
ollama serve

クイックスタート

ステップ1 — リポジトリをクローン

git clone https://github.com/jeet-ganguly/birdy-edwards.git
cd birdy-edwards

ステップ2 — 必要なファイルとディレクトリを作成

• Linux:

mkdir -p app/reports app/face_data app/post_screenshots app/status
touch app/fb_cookies.pkl app/socmint.db app/socmint_manual.db app/.ollama_model app/queue.db

• Windows (PowerShell):

New-Item -ItemType Directory app/reports, app/face_data, app/post_screenshots, app/status
New-Item -ItemType File app/fb_cookies.pkl, app/socmint.db, app/socmint_manual.db, app/.ollama_model

ステップ3 — Dockerイメージをビルド

⚠️ 初回ビルドには15〜25分かかります — dlibがソースからコンパイルされます。以降のビルドは高速です（レイヤーがキャッシュされます）。

docker compose build

ステップ4 — コンテナを起動

docker compose up -d

docker compose logs -f

ステップ5 — Web UIを開く

http://localhost:5000

ステップ6 — セッションクッキーをインポート

http://localhost:5000/tools/import-cookies

AIモデルをプル

ホストマシンでモデルをプル:

ollama pull gemma4:e2b

または、Web UIのAIモデルパネルを使用 — モデルを選択して適用してプルをクリック。

仮想マシンを使用している場合は、VMに割り当てられたRAMに応じてモデルを選択してください。

セッションクッキーのインポート

BIRDY-EDWARDSには有効なFacebookセッションが必要です。Cookie-Editorブラウザ拡張機能を使用してください — すべてのプラットフォームで動作し、Seleniumは不要です。

🔒 運用上のセキュリティ: 個人のFacebookアカウントではなく、調査専用のソックパペットアカウントを使用することを強くお勧めします。これにより、あなたの身元が保護され、プライマリアカウントがフラグ付けされたり制限されたりするのを防ぎます。

1. Cookie-Editorをインストール → Chrome · Firefox
2. Facebookで専用の調査アカウントにログイン
3. facebook.comでCookie-Editorをクリック
4. エクスポート → JSONとしてエクスポートをクリック
5. http://localhost:5000/tools/import-cookies に移動して貼り付け

Telegram通知の設定

毎回の調査後にPDFレポートを自動配信します。

1. @BotFather を介してTelegramボットを作成し、ボットトークンをコピー
2. チャットIDを取得 — ボットにメッセージを送信してから https://api.telegram.org/bot<TOKEN>/getUpdates にアクセス
3. Web UIのTelegramパネルに移動
4. ボットトークンとチャットIDを貼り付けて保存をクリック
5. テストをクリックして接続を確認

この時点から、完了したすべての調査でPDFレポートが添付された通知が自動的に送信されます。

支援方法

BIRDY-EDWARDSが役立つ、または興味深いと感じた場合、プロジェクトを支援する方法はいくつかあります:

• ⭐ リポジトリにスターを付ける — 他の人がツールを発見するのに役立ちます
• 🐛 バグを報告する — 何かが動作しない場合はIssueを開いてください
• 🔧 貢献する — 開始するには貢献セクションを確認してください
• 📢 共有する — OSINTコミュニティ、フォーラム、X、または役立つと思われる同僚に投稿してください
• 💬 フィードバックを送る — 新機能や改善の提案は常に歓迎します

大小を問わず、すべての貢献はOSINTおよび脅威インテリジェンスコミュニティのためのより良いツールの構築に役立ちます。

トラブルシューティング

DockerからOllamaに到達できない

docker exec -it birdy-edwards curl http://host.docker.internal:11434/api/tags

失敗した場合は、OLLAMA_HOST=0.0.0.0:11434 ollama serve でOllamaを再起動してください

DBエラー: no such table またはその他のDB関連エラー
新しい調査を開始してください — スキーマは初回使用時に自動的に作成されます。分析中にプロセスを停止した場合は、その調査を削除して新しい調査を開始してください。

クッキーの有効期限切れ
http://localhost:5000/tools/import-cookies に移動して、新しいクッキーを再インポートしてください。

ポート5000が既に使用中
docker-compose.yml で変更: "5001:5000" にしてから http://localhost:5001 でアクセス

ビルド中のメモリ不足
Docker Desktopのメモリを設定 → リソース → メモリで8 GB以上に増やしてください

マップが読み込まれない
Leaflet + ArcGISタイルはホストマシン上のインターネットアクセスが必要です。完全にエアギャップ環境で実行している場合、マップコンテナは空白で表示されます — 他のすべての機能は正常に動作します。

Telegramが送信されない
ボットに /start メッセージを送信して起動されていることを確認してください。getUpdates URLを使用してチャットIDが正しいことを確認してください。ネットワークでポート443がブロックされていないことを確認してください。

貢献

貢献は歓迎します。プロジェクトをクリーンで一貫性のある状態に保つために、以下のガイドラインに従ってください。

バグの報告

• バグ、再現手順、環境（OS、RAM、Dockerバージョン）を説明するIssueを開いてください
• docker compose logs から関連ログを添付してください

機能リクエスト

• 機能とそのユースケースの明確な説明を含むIssueを開いてください
• 大規模な変更のPull Requestを開く前に議論してください

Pull Requestの提出

• リポジトリをフォーク
• 機能ブランチを作成: git checkout -b feature/your-feature-name
• 変更をコミット: git commit -m "Add: short description"
• ブランチにプッシュ: git push origin feature/your-feature-name
• main に対してPull Requestを開く

コードガイドライン

• 既存のコードスタイルに従う — Python 3.12、Flask規約
• 提出前にDocker経由でローカルで変更をテスト
• fb_cookies.pkl、データベース、またはスクレイピングされたデータをコミットしない
• スクレイパーの変更は最小限に保つ — FacebookのDOMは頻繁に変更されます

歓迎するもの

• バグ修正と安定性の改善
• 新しいOllamaモデルのサポート
• UIの改善
• ドキュメントの改善
• OCRおよびコメント分析の追加言語サポート

受け入れないもの

• プラットフォームのセキュリティ制御を回避する機能
• クラウド依存関係を導入する変更
• 調査データを外部に保存または送信するコード

謝辞

• Sherlock に触発されました
• OSINTおよび脅威インテリジェンス研究コミュニティに触発されました
• SeleniumBase — 検出されないChrome自動化
• Ollama — ローカルLLM推論エンジン
• face_recognition — 顔検出およびエンコーディングライブラリ
• Leaflet — インタラクティブマップライブラリ
• ArcGIS — 正しい憲法上の境界を持つマップタイル
• pyvis — インタラクティブネットワークグラフ可視化
• reportlab — PDF生成
• pytesseract — OCRエンジンラッパー
• D3.js — データ可視化およびインタラクティブグラフ