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 的客户端
• 三种 AI 后端：Anthropic Claude（默认）、本地 Ollama 或任何兼容 OpenAI 的端点；工具结果来自真实的子进程调用，不会出现幻觉
• 完全异步，通过 asyncio.gather() 并行执行工具，并设置严格的子进程超时
• 采用 MIT 许可证，不内置大模型；使用你自己的 API 密钥，或完全离线运行

---

法律免责声明：Clearfront 仅供合法且经授权的用途。 用户须自行负责确保其使用方式符合所有适用法律法规。 作者对滥用不承担任何责任。请参阅 DISCLAIMER.md。

什么是 Clearfront？

Clearfront 是一款用于开源情报的 AI Agent，提供五种使用界面：交互式终端 REPL、直接 CLI、基于浏览器的 Web 控制台、可供 Claude Code、Claude Desktop 或任何兼容 MCP 的客户端使用的 MCP 服务，以及适用于任何遵循 Agent Skills 标准的客户端的 Agent 技能。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 Agent	是（或使用 Ollama / OpenAI）	Anthropic API 密钥
OPENAI_BASE_URL	AI Agent	可选	OpenAI 兼容端点的基础 URL（例如 http://localhost:4000/v1）。设置该变量且未设置 ANTHROPIC_API_KEY 时，会将其用作 AI 后端（优先于 Ollama）。模型必须支持工具/函数调用。
OPENAI_API_KEY	AI Agent	可选	OpenAI 兼容端点的 API 密钥（本地服务可能会忽略该密钥）
OPENAI_MODEL	AI Agent	可选	向端点请求的模型名称（默认：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/1000 次请求，免费额度为 2500 次），获取密钥。
BRIGHTDATA_API_KEY	search_dorks_live、scrape_url	可选	Bright Data API 密钥，获取密钥（免费套餐：每月 5000 次请求）。
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	本地大模型后端（无需 API 密钥）	pip install ollama （还需安装 Ollama runtime）
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	生成 12 个有针对性的 Google dork URL（不发起网络请求）
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 (内置)	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	获取任意 URL，绕过 Cloudflare/CAPTCHA，并返回整洁的 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 (免费)	检查电子邮件或用户名是否暴露于信息窃取软件（不含明文凭据）
search_exif	exiftool	本地文件中的 EXIF / IPTC / XMP 元数据和嵌入式 GPS 信息
search_crypto	public chain APIs	Bitcoin / Ethereum 地址摘要：余额、交易次数
search_harvester	theHarvester	被动域名侦察：电子邮件、子域名、主机
search_exposure	内置（组合工具）	使用基础设施工具生成 IP 的自我暴露报告

界面

交互式 REPL

不带参数运行 clearfront 即可启动 AI 驱动的 REPL。输入目标（电子邮件、用户名、域名、IP、姓名）或问题；Agent 会决定运行哪些工具，根据发现串联调用工具，并汇总生成报告。

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"]
    }
  }
}

Agent 技能

skills/clearfront-osint 会教 Agent 如何使用 Clearfront：针对不同请求选择合适的方法、使用直接子命令、解读置信度评级，以及遵守授权使用规则。 它遵循 Agent Skills 开放标准，因此可用于 Claude Code、Cursor、Codex、Copilot、VS Code、Gemini、Windsurf、Zed 及其他兼容技能的客户端。

npx skills add scottmartinanderson/clearfront

同时安装 Clearfront 本身（pip install clearfront）；技能提供的是使用说明，而不是工具。想让 Agent 决定如何执行扫描时，请使用此技能；想让它直接调用 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]	启动浏览器界面
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	将结果写入 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

参与贡献

欢迎提交问题和拉取请求。开发工作流和编码规范请参阅 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。