📦 Fofa

v1.0.0

Search v1.0 用于调用 FOFA OpenAPI 进行批量检索并导出 CSV/JSON。当用户提到 FOFA、资产测绘、批量查询、自动翻页、导出 CSV、key+查询语句等需求时，优先加载本 skill。

0· 4·0 当前·0 累计

by @biglizi775 (bigass)

API开发网络工具浏览器自动化文件处理

下载技能包

最后更新

2026/4/20

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

high confidence

该技能的代码与说明与其声明用途相符（批量 FOFA 查询并导出为 CSV/JSON）；运行时仅需 FOFA API 密钥，内部逻辑一致，未发现明显数据外泄或无关权限。

评估建议

该技能的功能如其所述：运行 FOFA 查询并导出结果。安装前请注意，你需要一个 FOFA API 密钥（元数据未明确声明）。建议通过运行时传入密钥（例如通过环境变量展开），而非将其提交到源代码管理。使用默认 base URL，除非你信任其他地址——提供自定义 --base-url 会把你的密钥和查询发送到该端点。请在虚拟环境中运行工具，并先用小样本查询测试。若计划让代理自主调用此技能，确保代理无法覆盖 base URL 或将 API 密钥泄露至不受信任的目标。...

详细分析 ▾

ℹ 用途与能力

名称/描述说明 FOFA 批量搜索与导出；内置 CLI 仅用 requests 库实现该功能。小差异：skill 元数据未声明必需环境变量，而 SKILL.md 与示例建议提供 FOFA API 密钥（FOFA_KEY）运行工具。功能上一致（CLI 接受 --key），但元数据遗漏值得注意。

✓ 指令范围

SKILL.md 说明如何运行捆绑的 CLI、创建 venv、安装 requests，并传入 key 与 query。运行时指令与代码均在范围内：仅调用 FOFA API（可配置 base_url）、处理结果并写入 CSV/JSON 文件。脚本在交互模式下提示输入，不读取无关系统文件或机密。

✓ 安装机制

未提供自动化安装规范（仅提供说明）。推荐安装方式是通过 pip 从 scripts/requirements.txt 安装唯一依赖（requests），该依赖规模适中且风险较低。

ℹ 凭证需求

该工具正常运行确实需要 FOFA API key，但 skill 元数据中既未声明任何必需的环境变量，也未指定主凭据。SKILL.md 建议通过环境变量注入 FOFA_KEY，或在 CLI 中传递。另一点需注意：CLI 提供了 --base-url 标志，若用户（或自动化流程）传入恶意 base URL，FOFA key 将被发往该端点——这对可配置客户端而言是预期行为，但若 base URL 不可信，则存在被滥用的风险。

✓ 持久化与权限

该技能并非始终启用，可由用户调用，不请求提升持久化权限，也不修改其他技能或系统级设置。仅将输出文件写入用户指定的路径。

安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/4/20

--- 名称：fofa-search-use 描述：用于调用 FOFA OpenAPI 进行批量检索并导出 CSV/JSON。用户提到 FOFA、资产测绘、批量查询、自动翻页、导出 CSV、key+查询语句等需求时优先加载本 skill。 --- # FOFA Search Use ## 首要目标 - 让用户仅提供 `key` 和 `query` 即可完成检索并导出数据。 - 脚本自动选择翻页策略： 1) 优先 `search/next` 2) 不支持时回退 `search/all?page` - 默认导出 `CSV`，可选导出 `JSON`。 - 本 skill 不依赖固定机器路径，整个文件夹可直接复制到任意项目使用。 ## 入口脚本 - 主脚本：`scripts/fofa_search_cli.py` - 运行方式： - AI 无交互推荐： `python3 scripts/fofa_search_cli.py --no-interactive --key "$FOFA_KEY" --query 'title="test"' --output-file results.csv --json-output` - 兼容交互： `python3 scripts/fofa_search_cli.py` ## 环境与安装（可移植） - 推荐虚拟环境： `python3 -m venv .venv` `source .venv/bin/activate`（Windows PowerShell: `.venv\Scripts\Activate.ps1`） `pip install -r scripts/requirements.txt` - 最小依赖文件：`scripts/requirements.txt` ## 参数说明 - `--key`：FOFA API key - `--query`：FOFA 查询语句 - `--fields`：返回字段，默认 `host,ip,port,protocol,title` - `--max-records`：最大导出条数，默认 `1000` - `--page-size`：每页请求数量，默认 `10000`（最大 `10000`） - `--output-file`：CSV 文件名，默认 `fofa_results.csv` - `--json-output`：额外导出 JSON - `--base-url`：FOFA 地址，默认 `https://fofa.info` - `--no-interactive`：禁止交互输入，缺参直接报错 ## 推荐执行策略 - 先用小样本测试语句（如 `--max-records 10`）。 - 字段尽量精简，减少无效数据和消耗。 - 大批量导出时优先使用无交互参数模式，便于自动化和复现。 ## CSV 导出帮助 - 自定义导出字段：使用 `--fields`，字段顺序即 CSV 列顺序。 - 常用字段示例：`host,ip,port,protocol,title,country,city,server` - 无交互导出示例： `python3 scripts/fofa_search_cli.py --no-interactive --key "$FOFA_KEY" --query 'title="test"' --fields "ip,port,host,title,country,city" --max-records 500 --page-size 100 --output-file fofa_custom.csv` - 交互导出要点： - 运行脚本后在 `fields` 提示中输入逗号分隔字段。 - 如果某列为空，CSV 中对应单元格会保留空值，这是正常现象。 - Excel 打开乱码处理： - 脚本默认用 `utf-8-sig` 写出 CSV，通常可直接被 Excel 正确识别。 - 若仍异常，导入时手动选择 `UTF-8` 编码。 ## 安全注意事项 - 不要把真实 `key` 写入仓库文件或提交历史。 - 推荐通过环境变量注入：`FOFA_KEY`。 - 必须持久化时使用本地安全存储，不要明文保存在代码库。

● 无害

安装命令

点击复制

官方npx clawhub@latest install fofasearch

镜像加速npx clawhub@latest install fofasearch --registry https://cn.longxiaskill.com

技能文档

# FOFA Search Use ## 目标 - 用户仅需提供 key 与 query 即可完成检索与导出。 - 自动翻页策略： 1) 优先 search/next 2) 不支持则回退 search/all?page - 默认导出 CSV，可选 JSON。 - 全文件夹可移植，无需固定路径。 ## 入口脚本 - 主脚本：scripts/fofa_search_cli.py - 运行示例： - AI 无交互： python3 scripts/fofa_search_cli.py --no-interactive --key "$FOFA_KEY" --query 'title="test"' --output-file results.csv --json-output - 交互模式： python3 scripts/fofa_search_cli.py ## 环境与安装（可移植） - 虚拟环境： python3 -m venv .venv source .venv/bin/activate（Windows PowerShell: .venv\Scripts\Activate.ps1） pip install -r scripts/requirements.txt - 最小依赖：scripts/requirements.txt ## 参数说明 - --key：FOFA API key - --query：FOFA 查询语句 - --fields：返回字段，默认 host,ip,port,protocol,title - --max-records：最大导出条数，默认 1000 - --page-size：每页请求量，默认 10000（上限 10000） - --output-file：CSV 文件名，默认 fofa_results.csv - --json-output：额外导出 JSON - --base-url：FOFA 地址，默认 https://fofa.info - --no-interactive：禁止交互，缺参报错 ## 执行建议 - 先用小样本测试（如 --max-records 10）。 - 字段精简，减少数据与消耗。 - 大批量导出用无交互参数，便于自动化。 ## CSV 导出 - 自定义字段：--fields，顺序即 CSV 列顺序。 - 常用字段：host,ip,port,protocol,title,country,city,server - 无交互示例： python3 scripts/fofa_search_cli.py --no-interactive --key "$FOFA_KEY" --query 'title="test"' --fields "ip,port,host,title,country,city" --max-records 500 --page-size 100 --output-file fofa_custom.csv - 交互要点：在 fields 提示输入逗号分隔字段；空列留空正常。 - Excel 乱码：默认 utf-8-sig，异常时手动选 UTF-8。 ## 安全 - 勿将真实 key 写入仓库或提交历史。 - 推荐环境变量注入：FOFA_KEY。 - 必须持久化时用本地安全存储，勿明文存代码库。

数据来源：ClawHub ↗ · 中文优化：龙虾技能库