Command Palette

Search for a command to run...

UnylyUnyly
Browse all

FofaMap

FreeNot checked

A MCP-enabled asset mapping and vulnerability scanning agent with AI self-reflection, allowing natural language queries and automated scanning decisions.

GitHubEmbed

About

A MCP-enabled asset mapping and vulnerability scanning agent with AI self-reflection, allowing natural language queries and automated scanning decisions.

README

FofaMap_V1.0.1

uugai com_1640828840556

FofaMap是一款基于Python3开发的跨平台FOFA数据采集器。用户可以通过修改配置文件,定制化的采集FOFA数据,并导出生成对应的Excel表格。

一.安装说明

1.工具使用Python3开发,请确保您的电脑上已经安装了Python3环境。

2.首次使用请使用 python3 -m pip install -r requirements.txt 命令,来安装必要的外部依赖包。

3.fofa.ini为Fofamap的配置文件,可以通过修改配置文件内容来定制化采集FOFA数据。

4.在使用该工具前,请先填写用户信息**[userinfo]中的emailkey**,fofa.ini配置文件说明如下:

[userinfo]#用户信息
#注册和登录时填写的email
email = [email protected]
#会员到个人资料可得到key,为32位的hash值
key = 001xxxxxxxxxxxxxxxxxxxxx8b2dc5

[fields]#查询内容选项
#默认查询内容为:ip、端口、网站标题、国家和城市
fields = ip,port,title,country,city

#fields可选项有:['host', 'title', 'ip', 'domain', 'port', 'country', 'province', 'city', 'country_name', 'header', 'server', 'protocol', 'banner', 'cert', 'isp', 'as_number', 'as_organization', 'latitude', 'longitude', 'structinfo','icp', 'fid', 'cname']


[page]#查询页数
#查询启始页数
start_page = 1
#查询结束页数
end_page = 2

5.不同用户使用Fofamap调用FOFA全网资产收集与检索系统API查询次数如下:

企业会员 免费前100,000条/次

高级会员 免费前10000条/次

普通会员 免费前100条/次

注册用户 1F币(最多10,000条)/次

用户可以根据自己的账号类型设置对应的查询页数。

6.项目文件结构:

├── README.md ##使用说明
├── fofa.ini ##fofa配置文件
├── fofa.py  ##fofa api调用类
├── fofamap.py  ##fofamap主程序
└── requirements.txt  ##依赖包要求

二.使用方法

1.-q 使用FOFA查询语句查询数据

关于命令说明:

如果用户想要使用fofa联合查询语句,例如:app="grafana" && country="US"。

Linux和macOS用户直接使用python3 fofamap.py -q 'app="grafana" && country="US"'即可成功查询。

Windows用户因为系统原因,需要使用python3 fofamap.py -q "app=\"grafana\" && country=\"US\""系统才可成功识别,即Windows用户需要对查询命令内部的"使用\进行转义,否则系统识别错误。

$ python3 fofamap.py -q 'title="Apache APISIX Dashboard"'
image

2.-o 自定义输出文件名[默认为fofa.xlsx]

$ python3 fofamap.py -q 'title="Apache APISIX Dashboard"' -o 结果.xlsx
image

输出的结果.xlsx内容如下:

image

3.-s 输出扫描格式

使用输出扫描格式功能时,系统只会获取目标ip地址和端口号两个字段,并自动做去重处理,输出结果同时会自动保存为txt文件,方便大家导出到扫描器进行扫描。

$ python3 fofamap.py -q 'title="Apache APISIX Dashboard"' -s  
image

4.通过修改配置文件,控制输出内容

我们可以通过修改fofa.ini配置文件中的fields值来控制工具输出的顺序与字段。 例如:我们将fields = ip,port,title,country,city改为fields = protocol,ip,port,title,icpimage

接着执行以下命令

$ python3 fofamap.py -q 'app="discuz"'   

输出内容就会变为协议、IP地址、端口、网站标题、ICP备案号。 image


本工具仅提供给安全测试人员进行安全自查使用 用户滥用造成的一切后果与作者无关 使用者请务必遵守当地法律 本程序不得用于商业用途,仅限学习交流


FofaMap由Hx0战队开发维护

image

更新日志 1.0.1

[+] 优化代码逻辑,修复已经BUG。

[+] 优化输出样式,命令行输出结果将以表格形式展示。

[+] 扫描模式输出结果将自动进行去重处理,并会自动将结果保存为txt文档。

from github.com/asaotomo/FofaMap

Installing FofaMap

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/asaotomo/FofaMap

FAQ

Is FofaMap MCP free?

Yes, FofaMap MCP is free — one-click install via Unyly at no cost.

Does FofaMap need an API key?

No, FofaMap runs without API keys or environment variables.

Is FofaMap hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install FofaMap in Claude Desktop, Claude Code or Cursor?

Open FofaMap on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare FofaMap with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs