
maigret v0.6.5
🕵️♂️ ユーザー名で3000以上のサイトから人物の調査資料を収集
Maigret
Maigret は、ユーザー名のみで対象者の人物調査ファイルを収集し、膨大な数のサイトでアカウントをチェックして、ウェブページから入手可能なあらゆる情報を集めます。API キーは不要です。AI プロファイリング (デモ)。
Sponsors
IPcook は、オンライン調査、ユーザー名の発見、公開データ収集ワークフローのための信頼できる住宅用プロキシを提供します。高い成功率 • 99.99% の稼働率 • 0.5 秒未満の応答時間 • 月額、および従量課金 • 有効期限なしのトラフィック • チームコラボレーション用の無料サブアカウント最大 10 個 • 住宅用プロキシは $0.3~$3.2/GB。
特別オファー: 無料 100MB トライアルをご利用いただけます。コード WELCOME20 で 20% オフ。
RapidProxy は、Twitter スクレイピング、Selenium 自動化、ウェブデータ抽出のための高性能な住宅用プロキシを提供します。90M+ の IP • スマートローテーション • ブロック防止 • 有効期限なしのトラフィック。
特別オファー: 無料トライアル — プランは $0.65/GB から。コード RAPID10 で 10% オフ。
目次
1分でわかる
Python 3.10 以降がインストールされていることを確認してください。
pip install maigret
maigret YOUR_USERNAME
インストール不要? コミュニティ Telegram ボット または Cloud Shell をお試しください。
Web UI が必要ですか? 起動方法 をご覧ください。
関連情報: クイックスタート。
主な特徴
- 3,000 以上のサイトに対応 (全リスト)。デフォルトの実行では、トラフィック上位 500 サイトをチェックします。
-aですべてをスキャン、--tagsでカテゴリ/国別に絞り込み。 - Python プロジェクトに組み込み可能 —
maigretをインポートしてプログラムから検索を実行できます (ライブラリ利用参照)。 - プロフィールページやサイト API からアカウント所有者に関する利用可能なすべての情報を抽出します (他のアカウントへのリンクを含む)。
- 見つかったユーザー名やその他の ID を使用して再帰的検索を実行します。
- タグ (サイトカテゴリ、国) によるフィルタリングが可能です。
- ブロック、検閲、CAPTCHA を検出し、部分的に回避します。
- GitHub から自動更新されるサイトデータベースを実行のたびに取得し (24時間に1回)、オフライン時は組み込みデータベースにフォールバックします。
- Tor および I2P サイトに対応。ドメインのチェックも可能です。
- 結果をグラフで閲覧し、すべての形式のレポートを1つのページからダウンロードできるウェブインターフェースが同梱されています。
- オプションの AI 分析モード (
--ai) により、生の調査結果を OpenAI 互換 API を使って短い調査サマリーに変換します。
完全な機能リストは、機能ドキュメント をご覧ください。
利用事例
Maigret をベースにしたプロフェッショナル向け OSINT / ソーシャルメディア分析ツール:
デモ
ビデオ
レポート


インストール
「1分でわかる」の手順をすでに実行しましたか? それなら準備完了です。以下は代替のインストール方法です。
何もインストールしたくない場合は、コミュニティ Telegram ボット を使用してください。
Windows
Releases から maigret_standalone.exe をダウンロードしてください。起動方法は2つあります:
- ダブルクリック — Maigret がユーザー名を尋ね、デフォルト検索を実行し、レポートのリンクが表示されたままになるよう最後に待機します。
- ターミナルから実行 — コマンドプロンプト (
Win+Rを押してcmdと入力し Enter) または PowerShell を開いて、追加オプションを渡します:
cd %USERPROFILE%\Downloads
maigret_standalone.exe USERNAME
maigret_standalone.exe USERNAME --html :: also save an HTML report
maigret_standalone.exe --help :: list all options
ビデオガイド: https://youtu.be/qIgwTZOmMmM。
クラウドシェル
クラウドシェルや Jupyter ノートブックを使って、ブラウザで Maigret を実行できます:
ローカルインストール (pip)
# install from pypi
pip3 install maigret
# usage
maigret username
ソースから
# or clone and install manually
git clone https://github.com/soxoj/maigret && cd maigret
# build and install
pip3 install .
# usage
maigret username
Docker
2つのイメージバリアントが公開されています:
soxoj/maigret:latest— CLI モード (デフォルト)soxoj/maigret:web— 自動的にウェブインターフェースを起動します
# official image (CLI)
docker pull soxoj/maigret
# CLI usage
docker run -v /mydir:/app/reports soxoj/maigret:latest username --html
# Web UI (open http://localhost:5000)
docker run -p 5000:5000 soxoj/maigret:web
# Web UI on a custom port
docker run -e PORT=8080 -p 8080:8080 soxoj/maigret:web
# manual build
docker build -t maigret . # CLI image (default target)
docker build --target web -t maigret-web . # Web UI image
トラブルシューティング
ビルドエラーが発生しましたか? トラブルシューティングガイド をご覧ください。
PDF レポート (--pdf) はオプションの追加機能です — pip install 'maigret[pdf]' でインストールできます。Linux/macOS ではシステムレベルのグラフィックスライブラリが必要です。OS ごとのインストール手順は PDF レポートのセクション をご覧ください。
使い方
例
# make HTML, PDF, and XMind reports
maigret user --html
maigret user --pdf
maigret user --xmind # legacy XML with a manifest for XMind 2022+ readers
# machine-readable exports
maigret user --json ndjson # newline-delimited JSON (also: --json simple)
maigret user --csv
maigret user --txt
maigret user --graph # interactive D3 graph (HTML)
maigret user --neo4j # Neo4j Cypher script (graph database)
# search on sites marked with tags photo & dating
maigret user --tags photo,dating
# search on sites marked with tag us
maigret user --tags us
# highlight sites whose page also mentions specific keywords
maigret user --keywords python rust
# keyword-matched sites are shown with "[++]" in bright green
# search for three usernames on all available sites
maigret user1 user2 user3 -a
# AI-assisted investigation summary (needs OPENAI_API_KEY)
maigret user --ai
--neo4j は結果グラフの *_neo4j.cypher スクリプトを書き出します。cypher-shell -u neo4j -p <password> < report_user_neo4j.cypher でインポートするか、Neo4j Browser に貼り付けてください。再インポートは冪等です。Neo4j エクスポートのドキュメント をご覧ください。
すべてのオプションは maigret --help で確認できます。ドキュメント: CLI オプション、その他の例。403 やタイムアウトが発生した場合は TROUBLESHOOTING.md をご覧ください。
ウェブインターフェース
Maigret には、結果グラフとダウンロード可能なレポートを備えた Web UI が組み込まれています。
自分で実行したくないですか? 公開されている soxoj/maigret:web Docker イメージを、ワンクリックでホスト型アプリとしてデプロイできます:
Render の無料ティアで動作します (15 分間アイドル状態だと停止し、次のリクエストで再起動します)。インスタンスにはログインが設定されていないため、URL を知っている人は誰でも使用できます。
Web Interface Screenshots


maigret --web 5000
http://127.0.0.1:5000 を開き、ユーザー名を入力して結果を表示します。
Python ライブラリ
Maigret は、独自の Python プロジェクトに組み込むことができます。 CLI は、直接呼び出せる非同期関数の薄いラッパーです。カスタムパイプラインを構築したり、結果を独自ツールに渡したり、より大規模な OSINT ワークフロー内で実行したりできます。
動作例、非同期パターン、タグによるサイトのフィルタリング方法については、完全なライブラリ利用ガイド をご覧ください。
便利な CLI フラグ
--parse URL— プロフィールページを解析し、ID/ユーザー名を抽出して、再帰的検索の開始に使用します。--permute— 2つ以上の入力から推定されるユーザー名バリアントを生成し (例:john doe→johndoe,j.doe, …)、そのすべてを検索します。--self-check [--auto-disable]— データベースを監査するメンテナー向けに、usernameClaimed/usernameUnclaimedのペアを実サイトに対して検証します。--ai/--ai-model— 検索結果に対して AI 分析 を実行し、短い調査サマリーを端末にストリーミング表示します。
AI 分析
--ai は検索結果を収集し、内部 Markdown レポートを構築して、OpenAI 互換のチャット補完エンドポイントに送信し、短く中立的な調査サマリーを生成します (推定される本名、場所、職業、興味、言語、信頼度、フォローアップの手がかりなど)。サイトごとの進行状況は抑制され、モデルの出力は標準出力にストリーミングされます。
export OPENAI_API_KEY=sk-...
maigret user --ai
# pick a different model
maigret user --ai --ai-model gpt-4o-mini
キーは settings.json の openai_api_key として設定することもできます。エンドポイントはデフォルトで https://api.openai.com/v1 ですが、settings.json の openai_api_base_url を任意の OpenAI 互換 API (Azure OpenAI、OpenRouter、ローカルサーバーなど) に設定できます。オプションの完全なリストは 設定ドキュメント をご覧ください。
Tor / I2P / プロキシ
Maigret は、プロキシ、Tor、I2P 経由でチェックをルーティングできます。.onion / .i2p サイトや、データセンター IP をブロックする WAF を迂回する場合に便利です。
# any HTTP/SOCKS proxy
maigret user --proxy socks5://127.0.0.1:1080
# Tor (default gateway socks5://127.0.0.1:9050)
maigret user --tor-proxy socks5://127.0.0.1:9050
# I2P (default gateway http://127.0.0.1:4444)
maigret user --i2p-proxy http://127.0.0.1:4444
コマンドを実行する前に Tor / I2P デーモンを起動してください — Maigret はこれらのゲートウェイを管理しません。
Cloudflare バイパス
実験的機能。 Cloudflare webgate は活発に開発中です。設定スキーマ、CLI の動作、ルーティング対象サイトのセットは、後方互換性の保証なしに変更される可能性があります。
データベース内の一部のサイトでは、JavaScript チャレンジを解決するために実際のブラウザが必要です。Maigret はこれらのチェックをローカルの FlareSolverr インスタンスにオフロードできます:
docker run -d -p 8191:8191 --name flaresolverr ghcr.io/flaresolverr/flaresolverr:latest
maigret --cloudflare-bypass <username>
このバイパスはオプトイン (--cloudflare-bypass または settings.json の cloudflare_bypass.enabled) で、protection フィールドが一致するサイトに対してのみ機能します。バックエンドのオプションと設定については、機能ドキュメント をご覧ください。
コントリビューション
新しいサイトの追加や修正は data.json に限定的に行い (json.load/json.dump は使わない)、その後 ./utils/update_site_data.py を実行して sites.md とデータベースのメタデータを再生成し、プルリクエストを開いてください。詳細は、CONTRIBUTING ガイド と開発ドキュメント をご覧ください。リリース履歴: CHANGELOG.md。
商用利用
オープンソースの Maigret は MIT ライセンスで、制限なく商用利用できます。ただし、サイトチェックは時間の経過とともに壊れるため、積極的なメンテナンスが必要です。
本格的な商用利用 — 毎日更新されるサイトデータベース または ユーザー名チェック API — をご検討の場合は、こちらまでご連絡ください: 📧 [email protected]
- プライベートサイトデータベース — 5,000 以上のサイトを毎日更新 (公開オープンソースデータベースとは別)
- ユーザーネームチェック API — Maigret を製品に統合
概要
免責事項
教育および合法目的のみに使用してください。 お住まいの地域で適用されるすべての法律 (GDPR、CCPA など) を遵守する責任は利用者にあります。作者は誤用について一切の責任を負いません。
フィードバック
イシューを開く · GitHub Discussions · Telegram
SOWEL 分類
使用される OSINT 手法:
- SOTL-2.2. 他のプラットフォームでアカウントを検索
- SOTL-6.1. ログイン名の使い回しをチェックして別のアカウントを見つける
- SOTL-6.2. ニックネームの使い回しをチェックして別のアカウントを見つける
ライセンス
MIT © Maigret



