fofamap

FofaMap MCP

FofaMap 已出现在本会话工具列表中就等于已经连通。工具名以本会话前缀为准 （常见 fofamap__fofa_search）。这是 FofaMap MCP v2.0.1（mcp_server.py 的 15 个工具），不是 ClawHub 市场里那个跑 scripts/fofa_recon.py 的 Skill 包装。 禁止 execute python3 scripts/fofa_recon.py，禁止 curl FOFA API，禁止把 API Key 写进报告。

工作流

1. fofa_account + fofa_fields。看 vip_level：注册用户无 Host API；个人/教育账户无 stats API。
2. 用户点名产品、OA、VPN、中间件、摄像头、CMS 时，先 fofa_rules，原样使用返回的 query。空 keyword 列出内置目录，不耗额度。禁止编造 app=。
3. 耗额度查询前 fofa_validate_query。语法不对先修，再 fofa_search。
4. 第一页用最小字段集和 size。翻页把返回的 next_cursor 原样传给 fofa_search_next 的 cursor（DeepSentry 也会把 next_cursor 映射成 cursor）。
5. fofa_host_profile / fofa_stats 必须先确认账户有对应 API。
6. 大批量结果用 fofa_export，再 fofa_job_status 或 mcp_resource action=read uri=fofamap://jobs/{id} 取本地绝对路径。不要把大表贴进对话。
7. 宽泛中英文发现用 fofa_agent_run。组织官网结果保留 website_candidates 的 corroborated / observed / candidate，不要拍板成已确认归属。
8. 只有用户明确要求对已授权范围做主动扫描时才 nuclei_plan。核对目标、模板、severity 后，把一次性 plan_id + approval_token 原样交给 nuclei_execute。不得跳过 plan，不得复用令牌。

参数兼容

fofa_export 和 nuclei_plan 的 MCP schema 需要嵌套 request 对象。可以：

{"action":"tool","tool_name":"fofa_export","tool_args":{"query":"domain=\"example.com\"","format":"jsonl"}}
{"action":"tool","tool_name":"nuclei_plan","tool_args":{"targets":"https://example.com"}}

DeepSentry 会把扁平参数包进 request。fields / targets 可传 JSON 数组或逗号分隔。

安全

• 搜索、画像、统计是被动情报，仍要遵守用户授权范围。
• 认证失败、额度耗尽、超时不是空结果。
• FOFA 命中 ≠ 漏洞，也 ≠ 法律上的资产归属。
• 不要把 FOFA_API_KEY、approval token 写入报告或记忆。