ARTICLE · 1000289

把 SRC神器FOFA 资产收集装进 AI 助手,一句话搞定全网测绘

发布时间：2026-09-16 00:17:06 最近访问：2026-09-16 00:17:05

摘要: FofaMap 是一款证据驱动的 FOFA 资产测绘智能体，支持自然语言资产收集、AI 反思、CLI/MCP/Skill/REST 四种入口，以及经人工审批的 Nuclei 扫描。最吸引人的是它能把 FOFA 查询能力直接接入 Cursor、Claude Code、Codex 等 AI 宿主，让 Agent 用一句话完成资产发现。

工具简介

FofaMap 是围绕FOFA 网络资产搜索引擎的智能测绘工具。它把 FOFA 查询从"手动写语法"升级为"自然语言驱动"，核心能力：

经典查询：直接执行 FOFA 语句，不需要 AI 模型
自然语言 Agent：把一句话需求拆成多组查询，AI 反思修正，输出证据分级简报
多入口：交互向导 / 经典 CLI / 本地 -ai Agent / MCP / Skill / REST API
Nuclei 审批制扫描：扫描必须先经人工审批，目标、模板、严重级别明确展示

工作流：

自然语言/FOFA语句 → 语法校验与查询规划 → FOFA检索→ 结果质量足够? → 反思收窄补充（最多两轮）→ 证据分级去重 → 资产表+AI简报 → (可选)审批后 Nuclei扫描

设计原则：Agent 只负责规划和总结；查询、分页、导出、审批与扫描由确定性代码执行，鉴权失败、额度耗尽不会被伪装成"0 结果"。

MCP 集成（重点）

这是 FofaMap 最亮眼的能力——把 FOFA 查询能力直接交给 AI 宿主调用。

15 个 MCP 工具分层

类别	工具
准备	`fofa_account` 、`fofa_fields`、`fofa_syntax`、`fofa_rules`、`fofa_validate_query`
检索	`fofa_search` 、`fofa_search_next`、`fofa_host_profile`、`fofa_stats`、`fofa_icon_search`
编排与导出	`fofa_agent_run` 、`fofa_export`、`fofa_job_status`
受控扫描	`nuclei_plan` 、`nuclei_execute`

推荐调用顺序：规则库 → 语法校验 → 单页查询 → 按 next_cursor 连续翻页 → 大结果导出。开放式中文需求可直接调用 fofa_agent_run。

一键接入 AI 宿主

fofamap integrate --list# 查看支持矩阵fofamap integrate --agent cursor# 接入 Cursorfofamap integrate --agent codex# 接入 Codexfofamap integrate --agent claude# 接入 Claude Codefofamap integrate --agent all --dry-run# 预览全部变更

支持 9 个宿主：Cursor、Codex、Claude Code、OpenCode、DeepSeek Harness、LM Studio、OpenClaw、Hermes、Grok Build。

使用如下命令：将安装器自动写入当前 Python 与 mcp_server.py 的绝对路径，合并已有配置、创建备份，不读取密钥。卸载只移除 FofaMap 管理的条目：

fofamap integrate --agent cursor --uninstall

手动启动 MCP 服务

# stdio 模式fofamap-mcp# 本机 Streamable HTTPfofamap-mcp --transport streamable-http --host 127.0.0.1 --port 8001

注：MCP 本身提供对话模型，通常无需再给 FofaMap 配第二套模型密钥。

独立安装部署

安装到不同的工具就不说了

https://github.com/asaotomo/FofaMap.git

环境要求：Python 3.10+、FOFA API Key（可选 AI 模型 Key）

git clone https://github.com/asaotomo/FofaMap.gitcd FofaMappython3 -m venv .venv. .venv/bin/activate# Windows: .\.venv\Scripts\activatepython -m pip install -e .# 初始化（配置 API Key，优先存入系统钥匙串）fofamap init

也可用环境变量：

export FOFA_API_KEY='你的 FOFA API Key'export OPENAI_API_KEY='仅本地 -ai 模式需要'

可选：Nuclei（仅主动扫描需要；FOFA 查询、Agent、MCP、REST 只读能力可独立运行）

nuclei -version# 确认已安装fofamap -up# 更新 Nuclei 与模板

快速上手

# 无参数进入交互向导fofamap# 经典 FOFA 查询（不需要模型）fofamap -q 'domain=”example.com”' -p 2 --size 100# 自然语言 Agent（需要配置模型）fofamap -ai '收集 Example 公司的公开网站，区分高置信资产与待复核候选'# 暴露面分析（限制地域与结果预算）fofamap -ai '分析授权范围内中国地区的 Example 产品暴露面，按协议、端口和产品版本总结，最多返回 500 条'# 规则库查询（产品名优先查内置规则，不猜 app= 名称）fofamap rules --rule ThinkPHPfofamap --rule ThinkPHP -p 2

常用查询字段速查：

目标	示例
根域名及子域	`domain="example.com"`
IP / C 段	`ip="192.0.2.10"` 、`ip="192.0.2.0/24"`
端口	`port="443"`
服务与产品	`protocol="https"` 、`app="ThinkPHP"`
国家 / 地区	`country="CN"` 、`region="Zhejiang"`
组织 / ASN	`org="Example Org"` 、`asn="13649"`
证书	`cert.subject.org="Example Org"`
图标	`icon_hash="123456789"` （建议用 `-ico` 自动算）

功能特点

证据分级：corroborated（多证据印证）/ observed（直接观察）/ candidate（待复核），避免把泛名称命中写成已确认归属
规则库优先：产品名从内置规则库取，避免凭空编写指纹
AI 反思：基于命中数、新增量、样本质量最多反思两轮
Nuclei 审批制：目标、模板、严重级别精确展示，一次性令牌绑定方案，-batch 也不能绕过
多格式导出：XLSX / CSV / JSONL，连续分页、流式大结果
多模型支持：OpenAI / DeepSeek / Anthropic / Ollama / LM Studio 及兼容接口

项目信息

项目	内容
GitHub	`asaotomo/FofaMap`
License	Apache 2.0
语言	Python 3.10+
Star	713
版本	v2.0.1

优缺点

优点：

MCP 集成完善，15 个工具分层清晰，一键接入主流 AI 宿主
自然语言资产收集，降低 FOFA 语法门槛
证据分级严谨，避免误报归属
审批制扫描，安全边界明确

局限：

FOFA API Key 依赖（免费额度有限）
完整能力依赖账号等级（Host/Stats API 需会员）
主动扫描需另装 Nuclei

合规提醒: FofaMap 用于 FOFA 资产测绘与授权渗透测试。Nuclei 主动扫描仅限已获得明确授权的目标。请遵守 FOFA 服务条款与所在地区法律。