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