Osint Mcp

osint-mcp — AI エージェント向けの無料 OSINT ツールを MCP ツールとして提供

コマンド 1 つ。無料の OSINT ツール 26 個。あらゆる AI エージェントに対応。

uvx osint-mcp   # installs everything and starts the MCP server

---

osint-mcp とは？

osint-mcp は、26 個の無料 OSINT（オープンソースインテリジェンス）ツールを MCP（Model Context Protocol）ツールとしてラップする Python パッケージです。Claude、GPT-4、その他の MCP 対応エージェントなどの AI エージェントが、会話から直接、本格的な OSINT 調査を実行できるようになります。

解決する課題： 従来、OSINT ツールを実行するには、個別のバイナリをいくつもインストールし、連携用のスクリプトを作成し、出力を手動で解析する必要がありました。osint-mcp はセットアップ全体を自動化します。OS を検出し、Homebrew／apt／Go／pip 経由ですべてのツールをインストールして、単一の MCP サーバーを通じて AI エージェントに公開します。

対象ユーザー：

• AI を活用した偵察を行いたいセキュリティ研究者や侵入テスト担当者
• セキュリティ調査機能を備えた AI エージェントを構築する開発者
• 初期のフットプリンティングを自動化するバグバウンティハンター
• IOC（侵害の痕跡）を補強する脅威インテリジェンスアナリスト
• AI のガイダンスを受けながら OSINT を学ぶ学生

---

主な機能

• 無料の OSINT ツール 26 個 — ネットワーク、ドメイン、ソーシャルメディア、メール、ウェブ、電話、シークレットスキャンを網羅
• コマンド 1 つでセットアップ — uvx osint-mcp を実行すると、初回起動時に基盤となるすべてのツールを自動インストール
• MCP ネイティブ — Claude Desktop、あらゆる MCP クライアント、Anthropic SDK ですぐに利用可能
• ほとんどのツールは設定不要 — 15 個のツールは API キーなしで動作
• 段階的な機能低下 — オプションの無料 API キー（Shodan、VirusTotal）を使用するツールは、キーがなくても制限付きモードで動作し、フルアクセスを有効にする方法を明示
• macOS と Linux に対応 — Homebrew、apt、yum、Go、pip を自動検出
• デフォルトで安全 — ポートスキャンまたはシークレットスキャンのツールを明示的に呼び出さない限り、パッシブな偵察のみを実行

---

コマンド 1 つでセットアップ（推奨）

uvx は Python 版の npx です。パッケージを隔離された環境にインストールし、すぐに実行します。pip install や仮想環境の設定は不要です。

uvx osint-mcp

初回実行時には、次の処理が自動的に行われます。

1. osint-mcp を隔離された Python 環境にインストール
2. OS（macOS または Linux）を検出
3. Homebrew／apt／Go／uv pip 経由ですべての OSINT ツールのバイナリをインストール
4. stdio で MCP サーバーを起動（Claude Desktop または任意の MCP クライアントから利用可能）

2 回目以降の実行時は、ツールがすでにインストールされているため、1 秒未満で起動します。

---

Claude Desktop に接続

Claude Desktop の設定に 1 つ項目を追加すれば完了です。

macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
Linux — ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "osint": {
      "command": "uvx",
      "args": ["osint-mcp"]
    }
  }
}

Claude Desktop を再起動してください。ツール一覧に新しい OSINT ツールが 26 個表示されます。

---

代替方法：従来の pip インストール

自分で環境を管理する場合は、次の手順を実行してください。

pip install osint-mcp

# Install all OSINT tool binaries
osint-mcp install

# Check what is available
osint-mcp status

# Start the MCP server
osint-mcp serve

---

仕組み

Claude Desktop / AI Agent
        │
        │  MCP (stdio)
        ▼
  osint-mcp server
        │
        ├── osint_whois        →  python-whois library
        ├── osint_port_scan    →  nmap binary (subprocess)
        ├── osint_subdomain_enum → subfinder binary
        ├── osint_cert_transparency → crt.sh public API (HTTP)
        ├── osint_shodan_host  →  Shodan REST API (optional key)
        ├── osint_virustotal   →  VirusTotal REST API (optional key)
        └── ... 20 more tools

各ツールは BaseTool のサブクラスです。起動時にレジストリがすべてのサブクラスを自動検出し、FastMCP に登録します。ツールのバイナリがインストールされていない場合は、クラッシュする代わりに、明確な "not installed — run osint-mcp install" というメッセージを返します。

---

ツールの完全なリファレンス（26 個）

ネットワークインテリジェンス

MCP ツール	基盤技術	キーが必要？	機能
osint_whois	python-whois	いいえ	WHOIS 検索 — レジストラ、作成日、有効期限、ネームサーバー
osint_dns_lookup	dig	いいえ	DNS レコード：A、AAAA、MX、NS、TXT、CNAME、SOA、PTR、SRV、CAA
osint_port_scan	nmap	いいえ	バージョン検出を含むポートとサービスのスキャン
osint_ip_info	ipinfo.io API	任意	IP の位置情報、ISP、組織、タイムゾーン、不正利用に関する連絡先
osint_asn_lookup	ipinfo.io API	任意	ASN 番号、BGP プレフィックス、ネットワーク所有者

ドメインと DNS のインテリジェンス

MCP ツール	基盤技術	キーが必要？	機能
osint_subdomain_enum	subfinder	いいえ	40 以上のソースからのパッシブなサブドメイン列挙
osint_amass	amass	いいえ	DNS、証明書、API にわたる詳細な攻撃対象領域のマッピング
osint_cert_transparency	crt.sh API	いいえ	証明書透明性ログの検索 — SSL 証明書からサブドメインを特定
osint_harvester	theHarvester	いいえ	公開ソースからメールアドレス、ホスト名、従業員名を取得
osint_dnsrecon	dnsrecon	いいえ	ゾーン転送の試行、SRV 列挙、逆引き検索

ソーシャルメディアとユーザー名の OSINT

MCP ツール	基盤技術	キーが必要？	機能
osint_username_search	Sherlock	いいえ	300 以上のソーシャルプラットフォームでユーザー名を検索
osint_maigret	Maigret	いいえ	3,000 以上のサイトでユーザー名の詳細なプロファイリングとプロフィール抽出

メールインテリジェンス

MCP ツール	基盤技術	キーが必要？	機能
osint_email_accounts	Holehe	いいえ	メールアドレスにどのサービス（Instagram、Twitter など）が紐付いているかを特定
osint_email_breach	HaveIBeenPwned	任意	メールアドレスが既知のデータ侵害に含まれているかを確認

Web と脅威のインテリジェンス

MCP ツール	基盤技術	キーが必要？	機能
osint_wayback	Internet Archive API	いいえ	Wayback Machine から任意の URL の過去のスナップショットを取得
osint_urlscan	urlscan.io API	任意	URL をスキャン — 接続先 IP、技術スタック、スクリーンショット、脅威スコアを返す
osint_shodan_host	Shodan API	必須（無料）	任意の IP の開放ポート、サービス、バナー、CVE
osint_shodan_search	Shodan API	必須（無料）	Shodan のクエリ構文を使ってインターネットに接続されたデバイスを検索
osint_virustotal	VirusTotal API	必須（無料）	URL、IP、ドメイン、ファイルハッシュを 70 以上のウイルス対策エンジンで確認

電話番号の OSINT

MCP ツール	基盤技術	キーが必要？	機能
osint_phone_info	PhoneInfoga	いいえ	電話番号の通信事業者、国、回線種別、および公開ソース検索

シークレットとコードのスキャン

MCP ツール	基盤技術	キーが必要？	機能
osint_scan_secrets	TruffleHog	いいえ	Git リポジトリの URL またはローカルパスをスキャンし、漏えいしたシークレットや API キーを検出
osint_gitleaks	Gitleaks	いいえ	Git の履歴からハードコードされたパスワードやトークンを検出

メタ／ユーティリティ

MCP ツール	機能
osint_install_status	利用可能状況を含む全ツールの JSON リスト — エージェントが実行前に確認するのに便利
osint_config_get	保存された API キーを読み取る（マスク済み）
osint_config_set	エージェントとの会話中に API キーを保存
osint_config_list	設定済みの API キーを一覧表示

---

任意の無料 API キー

これらのツールはキーがなくても動作しますが、キーを登録すると取得できるデータが大幅に増えます。どれも無料で登録できます。

ツール	設定キー	無料枠	登録先
Shodan	shodan_key	1 クエリ/秒、100 件の結果	https://account.shodan.io
VirusTotal	virustotal_key	4 リクエスト/分	https://www.virustotal.com/gui/join-us
ipinfo.io	ipinfo_key	50,000 リクエスト/月	https://ipinfo.io/signup
HaveIBeenPwned	hibp_key	メールアドレスのチェックは無料	https://haveibeenpwned.com/API/Key
urlscan.io	urlscan_key	100 スキャン/日	https://urlscan.io/user/signup

# Set a key via CLI
osint-mcp config set shodan_key=YOUR_KEY

# Or let your AI agent set it during a conversation (via osint_config_set tool)

---

AI エージェントとの会話例

Claude Desktop に接続すると、次のような質問をできます。

「ドメイン example.com を調査してください。サブドメインを見つけ、連絡先メールアドレスのデータ漏えいを確認し、Shodan で検索してください。」

「GitHub リポジトリ github.com/org/repo をスキャンして、公開されているシークレットや API キーを探してください。」

「ユーザー名 johndoe123 に関連付けられているすべてのソーシャルメディアアカウントを見つけてください。」

「IP 1.2.3.4 が Shodan に登録されているか、また開いているポートを確認してください。」

「電話番号 +14155552671 を調べ、登録されている通信事業者と国を見つけてください。」

エージェントは複数のツールを自動的に連携させ、結果を解釈して、まとまりのある調査概要を提示します。手動でツールを連携させる必要はありません。

---

CLI リファレンス

osint-mcp                          Start the MCP server (default, same as serve)
osint-mcp serve                    Start the MCP server explicitly
osint-mcp serve --no-auto-install  Skip first-run tool installation
osint-mcp install                  Install all missing OSINT tools
osint-mcp install --category X     Install only tools in category (network/domain/social…)
osint-mcp install --dry-run        Preview what would be installed
osint-mcp status                   Show a table of all tools and their availability
osint-mcp config set KEY=VALUE     Store an API key
osint-mcp config get KEY           Read a stored key (masked)
osint-mcp config list              List all stored keys
osint-mcp config delete KEY        Remove a key
osint-mcp --version                Print version
osint-mcp --help                   Show help

---

対応プラットフォーム

プラットフォーム	ツールのインストール方法
macOS	Homebrew（brew install）・go install・uv pip install
Linux（Debian / Ubuntu）	apt-get install・go install・uv pip install
Linux（RHEL / Fedora / CentOS）	yum / dnf・go install・uv pip install

前提条件は自動的に処理されます：

• Homebrew — macOS に事前インストールされている必要があります（https://brew.sh）
• Go 1.21+ — subfinder、amass、phoneinfoga、gitleaks に必要です（インストーラーは Go がなくても問題なくスキップします）
• Python 3.10+ — 必須です（uvx の使用時は同梱されます）

---

よくある質問

Q: MCP（Model Context Protocol）とは何ですか？
A: MCP は、AI モデルが外部ツールを構造化された安全な方法で呼び出せるようにする、Anthropic によるオープン標準です。AI エージェントにとっての MCP は、ウェブブラウザーにとっての HTTP のようなもので、ツールを利用するための汎用プロトコルです。詳しくは modelcontextprotocol.io をご覧ください。

Q: osint-mcp は Claude 以外の AI エージェントでも動作しますか？
A: はい。OpenAI のエージェントフレームワーク（MCP アダプター経由）、LangChain、LlamaIndex、Anthropic SDK で構築したカスタムエージェントなど、MCP 互換のクライアントであれば利用できます。サーバーは標準の MCP JSON-RPC プロトコルを使用し、stdio 経由で通信します。

Q: 費用はかかりますか？
A: パッケージ自体は無料のオープンソースです。26 種類すべてのツールを無料で利用できます。一部のツール（Shodan、VirusTotal）は、すべての機能を利用するには無料の API キー登録が必要ですが、利用可能な無料枠が用意されています。

Q: 安全ですか？許可なくスキャンが実行されることはありますか？
A: パッシブツール（WHOIS、証明書の透明性、情報漏えいデータベース、ユーザー名検索）は自動的に実行されます。アクティブツール（nmap によるポートスキャン、TruffleHog によるシークレットスキャン）は、ユーザーまたはエージェントが明示的に呼び出した場合にのみ実行されます。また、サーバーの指示により、アクティブスキャンの前にユーザーへ確認するようエージェントに促します。

Q: OSINT ツールを手動で実行する場合と、どのような違いがありますか？
A: 主に 3 つあります。（1）インストール — 数時間かかるセットアップの代わりに、1 つのコマンドですべてをインストールできます。（2）統合 — AI エージェントが複数のツールを自動で連携させ、統合した結果を解釈できます。（3）会話 — CLI のフラグを暗記する代わりに、英語でやりたいことを説明できます。

Q: osint-mcp のインストールで、uvx と pip はどう違いますか？
A: uvx osint-mcp（推奨）は、パッケージを隔離された環境で実行します。グローバルな pip インストールも、仮想環境のセットアップも不要です。pip install osint-mcp は、現在の環境にインストールします。どちらも動作しますが、uvx のほうが簡単で、依存関係の競合を避けられます。

Q: 独自の OSINT ツールを追加できますか？
A: はい。src/osint_mcp/tools/<category>/ 以下の任意のファイルに BaseTool のサブクラスを作成すると、次回の起動時にレジストリが自動検出します。登録作業は不要です。インターフェースについては tools/base.py をご覧ください。

---

倫理的かつ合法的な利用

osint-mcp は、許可を得たセキュリティ調査、書面による許可を得た侵入テスト、脅威インテリジェンス、バグ報奨金プログラムでの調査、および教育目的での利用を想定して設計されています。

以下の目的でこれらのツールを使用しないでください。

• 本人の同意または法的権限なしに個人を調査すること
• 所有していない、またはテストの許可を得ていないシステムにアクセスしたり、調査したりすること
• サードパーティの API やデータソースの利用規約に違反すること

適用される法律には、Computer Fraud and Abuse Act（CFAA、米国）、Computer Misuse Act（英国）、GDPR（EU）、および利用者の法域における同等の法律が含まれます。著者は、不正利用について一切の責任を負いません。

---

貢献

新しいツール、より優れたインストール手順、バグ修正、ドキュメントの改善など、貢献を歓迎します。

git clone https://github.com/rjn32s/osint-mcp
cd osint-mcp
uv venv && uv pip install -e ".[dev]"
osint-mcp status   # verify your setup

新しい OSINT ツールを追加するには、src/osint_mcp/tools/<category>/yourfile.py に BaseTool のサブクラスを作成してください。クラスには name、description、input_schema、および async run(args) メソッドが必要です。レジストリが自動的に検出します。

---

関連プロジェクト

• Sherlock — ソーシャルネットワーク全体を対象としたユーザー名 OSINT
• subfinder — 高速なパッシブサブドメイン列挙
• amass — OWASP による攻撃対象領域のマッピング
• theHarvester — メールアドレスとホストの収集
• TruffleHog — git 内のシークレット検出
• MCP Python SDK — このサーバーが実装するプロトコル

---

ライセンス

MIT © 2026 Rajan Shukla

---

mcp-name: io.github.rjn32s/osint-mcp