clearfront

• 30のモジュール型ツール。メールアドレス、ユーザー名（sherlock + WhatsMyName）、3,400以上のサイトを対象とした広範なユーザー名調査（maigret）、検索ベースのフットプリント調査、IP アドレス、IP の自己露出レポート、ドメイン、WHOIS、情報漏えい、Gravatar プロフィール、EmailRep 評判、電話番号、ペースト、EXIF/GPS メタデータ、Shodan、VirusTotal、Censys、IP2Location、AbuseIPDB、GitHub（プロフィール + 公開コード／シークレットの露出）、DNS、証明書の透明性を利用したサブドメイン調査（crt.sh）、Wayback Machine（Internet Archive）を利用した過去の URL の復元、マススキャンの可視性（GreyNoise Community）、インフォスティーラーによる露出状況の確認（Hudson Rock、無料プラン、平文の認証情報は取得しません）、ドークの生成、ドークのライブ検索、URL スクレイピング、BTC／ETH アドレスの検索、パッシブドメイン調査（theHarvester）
• MCP サーバーを内蔵。30のツールすべてを Claude Code、Claude Desktop、および MCP 対応クライアントでネイティブに利用できます
• 3種類のAIバックエンド。Anthropic Claude（デフォルト）、ローカル Ollama、または OpenAI 互換エンドポイントに対応。ツールの結果は実際のサブプロセス呼び出しから取得され、決して幻覚で生成されません
• 完全な非同期処理。ハードなサブプロセスタイムアウトを設定し、asyncio.gather() でツールを並列実行します
• MIT ライセンス。LLM は内蔵されていません。ご自身の API キーを使用するか、完全にオフラインで実行できます

---

法的免責事項：Clearfront は、合法かつ許可された用途に限り使用することを想定しています。 適用されるすべての法令に準拠して使用する責任は、ユーザーが単独で負います。 著者は、不正使用について一切の責任を負いません。DISCLAIMER.md をご覧ください。

Clearfront とは？

Clearfront は、オープンソースインテリジェンスのための AI エージェントです。5つのインターフェースを備えています。インタラクティブなターミナル REPL、直接実行できる CLI、ブラウザベースの Web コンソール、Claude Code、Claude Desktop、または MCP 対応クライアントに公開できる MCP サーバー、そして Agent Skills 標準に準拠するあらゆるクライアント向けのエージェントスキルです。AI レイヤーには Anthropic のネイティブなツール使用 API（またはローカル Ollama モデル、あるいは OpenAI 互換エンドポイント）を使用します。モデルがツールを必要とすると処理を一時停止し、お使いのコードが実際のバイナリを実行して、その実際の出力をモデルに返します。この構造により、ツールの結果に幻覚が混入することはありません。

インストール

pip install clearfront

変更を加える場合は、ソースからインストールすることもできます。

git clone https://github.com/scottmartinanderson/clearfront
cd clearfront
pip install -e .

外部バイナリ（PATH に含まれている必要があります）：

バイナリ	用途	インストール
holehe	メールアカウントの列挙	pip install holehe
sherlock	ユーザー名の列挙（300 以上のプラットフォーム）	pip install sherlock-project
sublist3r	サブドメインの列挙	pip install sublist3r
phoneinfoga	電話番号のインテリジェンス	バイナリをダウンロード
theHarvester	パッシブなドメイン調査（メールアドレス／サブドメイン）	pip install git+https://github.com/laramies/theHarvester.git

バイナリが見つからない場合、対応するツールは内容がわかるエラー文字列を返します。それ以外のすべてのツールは引き続き動作します。

クイックスタート

# Interactive AI REPL (default)
clearfront

# Web interface
clearfront web

# Direct tool (no AI)
clearfront email [email protected]

設定

プロジェクトのルートにある .env ファイルにすべてのキーを保存してください（.env.example をコピーしてください）。python-dotenv が起動時に自動で読み込みます。

変数	ツール	必須	用途
ANTHROPIC_API_KEY	AI エージェント	はい（または Ollama／OpenAI を使用）	Anthropic API キー
OPENAI_BASE_URL	AI エージェント	任意	OpenAI 互換エンドポイントのベース URL（例：http://localhost:4000/v1）。設定されていて ANTHROPIC_API_KEY がない場合、AI バックエンドとして使用されます（Ollama より優先）。モデルはツール／関数呼び出しに対応している必要があります。
OPENAI_API_KEY	AI エージェント	任意	OpenAI 互換エンドポイントの API キー（ローカルサーバーでは無視される場合があります）
OPENAI_MODEL	AI エージェント	任意	エンドポイントにリクエストするモデル名（デフォルト：gpt-4o-mini）
HIBP_API_KEY	search_breach	任意	HaveIBeenPwned v3、こちらから取得
IPINFO_TOKEN	search_ip	任意	ipinfo.io の高いレート制限
SHODAN_API_KEY	search_shodan	任意	Shodan API、こちらから取得
VIRUSTOTAL_API_KEY	search_virustotal	任意	VirusTotal API v3、こちらから取得
IP2LOCATION_API_KEY	search_ip2location	任意	IP2Location.io の強化された IP インテリジェンス、こちらから取得
CENSYS_PAT + CENSYS_ORG_ID	search_censys	任意	Censys Platform API：個人アクセストークン + 組織 ID、こちらから取得
ABUSEIPDB_API_KEY	search_abuseipdb	任意	AbuseIPDB v2、こちらから取得
GITHUB_TOKEN	search_github	任意	GitHub API。レート制限が 60 から 5000 リクエスト／時に引き上げられます。こちらから取得
SERPER_API_KEY	search_dorks_live、search_footprint	任意	Serper.dev Google SERP API。推奨される SERP バックエンドです（約 1,000 件あたり $1、2,500 件無料）。こちらから取得。
BRIGHTDATA_API_KEY	search_dorks_live、scrape_url	任意	Bright Data API キー、こちらから取得（無料枠：月 5,000 リクエスト）。
BRIGHTDATA_SERP_ZONE	search_dorks_live	任意	Bright Data SERP API のゾーン名（例：serp_api1）。
BRIGHTDATA_UNLOCKER_ZONE	scrape_url	任意	Bright Data Web Unlocker のゾーン名（例：web_unlocker1）。

上記の Bright Data リンクは紹介リンクです。このリンクから登録すると、追加費用なしで Clearfront を支援できます。

任意の Python パッケージ：

パッケージ	用途	インストール
ollama	ローカル LLM バックエンド（API キー不要）	pip install ollama (あわせて Ollama ランタイムもインストールしてください)
openai	REPL／CLI 用の OpenAI 互換バックエンド（--provider openai）	pip install "clearfront[openai]"
shodan	Shodan API クライアント	pip install shodan
reportlab	PDF レポートのエクスポート	pip install reportlab
censys	Censys API クライアント	pip install censys

ツール

ツール	提供元	調査内容
search_email	holehe	メールアドレスに紐づくソーシャルアカウント
search_username	sherlock	300 以上のプラットフォームにおけるユーザー名の有無
search_breach	HaveIBeenPwned v3 API	データ侵害への情報流出状況
search_whois	python-whois	ドメイン登録者と DNS 情報
search_ip	ipinfo.io	ジオロケーション、ASN、ホスト名
search_domain	sublist3r	サブドメインの列挙
search_crt	crt.sh	証明書の透明性情報からサブドメインを取得（キー不要、パッシブ）
search_wayback	Internet Archive	ドメイン配下でアーカイブされた過去または削除済みの URL（キー不要、パッシブ）
search_greynoise	GreyNoise Community	IP に対する大規模スキャナーのノイズと標的型攻撃者を判別（無料、週 50 回）
generate_dorks	built-in	対象を絞った Google dork の URL を 12 件生成（ネットワーク呼び出しなし）
search_paste	psbdmp.ws	Pastebin のダンプ内での言及
search_phone	phoneinfoga	通信事業者、国、回線種別
search_shodan	Shodan API	開放ポート、バナー、CVE
search_virustotal	VirusTotal API v3	70 以上のウイルス対策エンジンによる判定
search_ip2location	IP2Location.io API	IP の詳細情報：VPN／プロキシ／Tor／データセンターのフラグ
search_censys	Censys Search API	インターネットに公開されたインフラストラクチャ、証明書
search_abuseipdb	AbuseIPDB v2 API	IP の不正利用に関する評価：信頼度スコア、報告数、国、ISP
search_github	GitHub REST API	プロフィール、リポジトリ、コミットから発見したメールアドレス、ユーザー名／キーワード検索
search_dns	dnspython (built-in)	A／AAAA／MX／NS／TXT／CNAME／SOA レコード、SPF、DMARC、DKIM の分析
search_dorks_live	Bright Data SERP API	dork クエリの Google 検索結果（タイトル、URL、スニペット）
scrape_url	Bright Data Web Unlocker	Cloudflare／CAPTCHA を回避して任意の URL を取得し、整形済み Markdown を返します
search_maigret	maigret	3,400 以上のサイトにおけるユーザー名の有無
search_footprint	SERP (Serper / Bright Data / DuckDuckGo)	名前またはハンドルの検索ベースのフットプリント調査
search_gravatar	Gravatar API	メールアドレスに紐づく公開 Gravatar プロフィール：アバター、表示名、リンク済みアカウント
search_emailrep	EmailRep.io	メールアドレスの評価とフットプリントの概要
search_hudsonrock	Hudson Rock Cavalier (free)	メールアドレスまたはユーザー名のインフォスティーラーによる情報流出を確認（平文の認証情報は含まれません）
search_exif	exiftool	ローカルファイルの EXIF／IPTC／XMP メタデータと埋め込み GPS 情報
search_crypto	public chain APIs	Bitcoin／Ethereum アドレスの概要：残高、トランザクション数
search_harvester	theHarvester	パッシブなドメイン調査：メールアドレス、サブドメイン、ホスト
search_exposure	built-in (composite)	インフラストラクチャ関連ツールを使った IP の自己情報流出レポート

インターフェース

対話型 REPL

引数なしで clearfront を実行すると、AI 搭載の REPL が起動します。対象（メールアドレス、ユーザー名、ドメイン、IP、名前）または質問を入力すると、エージェントが実行するツールを判断し、調査結果に応じてツールを連携させ、レポートを作成します。

REPL コマンド： <target>、clear、save、tools、config、history、help、exit／Ctrl-D。

すべてのセッションは ~/.clearfront/history/ に自動保存されます。clearfront history で閲覧できます。

Web UI

pip install "clearfront[web]"
clearfront web
# Opens http://localhost:8080 automatically

ストリーミング形式のツール出力、インラインの結果カード、ライト／ダークテーマの切り替えに対応した、ブラウザー上で動作する AI チャットです。Ollama または OpenAI 互換エンドポイントを使った完全ローカルの推論に対応しています（ローカルバックエンドを使う場合、Anthropic API キーは不要です）。

コンソールは完全にローカルで動作し、デフォルトでは 127.0.0.1 にバインドされます。Settings でバックエンドを選び、ご自身のキーを貼り付けてください。キーや調査対象が当社のサーバーに送信されることはありません。スクリーンショットは media/ にあります。

MCP サーバー

MCP 対応の AI クライアントから、すべての 30 個のツールを利用できるようにします。

Claude Code：

claude mcp add clearfront python /absolute/path/to/clearfront/mcp_server.py
claude mcp list

Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "clearfront": {
      "command": "python",
      "args": ["/absolute/path/to/clearfront/mcp_server.py"]
    }
  }
}

エージェントスキル

skills/clearfront-osint は、Clearfront の操作方法をエージェントに教えます。リクエストに適したアプローチ、直接実行できるサブコマンド、信頼度評価の読み方、認可された使用に関するルールを説明します。 Agent Skills オープン標準に準拠しているため、Claude Code、Cursor、Codex、Copilot、VS Code、Gemini、Windsurf、Zed や、ほかのスキル対応クライアントで使用できます。

npx skills add scottmartinanderson/clearfront

Clearfront 自体もインストールしてください（pip install clearfront）。スキルは手順を説明するものであり、ツールではありません。エージェントにスイープの実行方法を判断させる場合はスキルを使用し、30 個のツールを直接呼び出させる場合は上記の MCP サーバーを使用してください。

Docker

docker compose up --build
docker compose run --rm clearfront email [email protected] --json

.env ファイルに ANTHROPIC_API_KEY（任意で HIBP_API_KEY、IPINFO_TOKEN も）を設定するか、実行前に環境変数としてエクスポートしてください。ボリュームマウントにより、レポートは ./reports/ に保持されます。

CLI リファレンス

フラグ／サブコマンド	説明
clearfront	対話型 AI REPL（デフォルト）
clearfront web [--port N] [--no-browser]	ブラウザー UI を起動
clearfront email ADDRESS [-t N]	メールアドレスを直接スキャン
clearfront username HANDLE [-t N]	ユーザー名を直接スキャン
clearfront shodan QUERY [-t N]	Shodan を検索
clearfront virustotal TARGET [-t N]	VirusTotal を検索
clearfront censys TARGET [-t N]	Censys を検索
clearfront ip2location IP [-t N]	IP2Location を検索
clearfront abuseipdb IP [-t N]	AbuseIPDB のレピュテーションを確認
clearfront github QUERY [-t N]	GitHub のプロフィール／リポジトリ／メールアドレスを検索
clearfront dns DOMAIN [-t N]	DNS レコードとメールセキュリティを分析
clearfront multi TARGETS	複数のターゲットを並列調査（最大 10 件）
clearfront graph TARGET [-o PATH] [--format graphml|json|mermaid|all]	エンティティ相関グラフを自動的にたどってエクスポート（GraphML／JSON／Mermaid）
clearfront history [--all] [open N] [clear]	REPL セッション履歴を表示／管理
-v, --verbose	stderr へのデバッグログ出力を有効化
-t, --timeout N	サブプロセスのタイムアウト（秒）を上書き
--api-key KEY	Anthropic API キー（環境変数より優先）
--parallel	相互補完するツールを並行実行
--json	結果を構造化 JSON として出力
-o, --output FILE	stdout の代わりに FILE に結果を書き込む（生データ。JSON ファイルにする場合は --json と組み合わせます）
--provider {anthropic,ollama,openai}	AI プロバイダー（デフォルト：anthropic）
--ollama-model MODEL	Ollama モデル名（デフォルト：llama3.2）
--ollama-host URL	Ollama サーバーの URL（デフォルト：http://localhost:11434）
--openai-base-url URL	OpenAI 互換エンドポイントのベース URL（環境変数：OPENAI_BASE_URL）
--openai-model MODEL	エンドポイントにリクエストするモデル（環境変数：OPENAI_MODEL）
--openai-api-key KEY	エンドポイントの API キー（環境変数：OPENAI_API_KEY）
--no-pdf	PDF の自動生成を無効化

コントリビューション

Issue とプルリクエストを歓迎します。開発ワークフローとコーディング規約については、CONTRIBUTING.md をご覧ください。コントリビューションの前に DISCLAIMER.md をお読みください。

ライセンス

Clearfront は MIT License に基づくオープンソースです。

同梱されているユーザー名データセット clearfront/tools/data/wmn-data-unique.json は、Micah Hoffman による WhatsMyName プロジェクトをフィルタリングして改変したもので、CC BY-SA 4.0 ライセンスに基づいて使用しています。このファイル（およびその改変物）は引き続き CC BY-SA 4.0 に基づきます。clearfront/tools/data/NOTICE をご覧ください。

---

認可されたセキュリティ調査に限り使用してください。DISCLAIMER.md をご覧ください。