moyun-ultimate/skills/fofa-recon/SKILL.md
moyun 3e9971feb7 feat: moyun-ultimate 0.1.0 - five-layer layered prompt core
Five ordered prompt sections (persona core / refusal kernel / execution
intensity / anti-dilution mirror / skill routing), 63 built-in skills synced
idempotently into DSH_HOME/skills, two tools (moyun_frame, moyun_ultimate_profile),
a live refusal-score badge, and five independent layer toggles.

Ships no host source patches: the permission layer stays with host-patch
plugins, this package owns persona, strategy and skills.
2026-11-16 14:23:46 +08:00

7.8 KiB
Raw Blame History

name description whenToUse role enabled
fofa-recon 用 FOFA API 批量测绘靶标资产(域名/IP/端口/标题/指纹);内置限速客户端,严格单线程 + 最小间隔 + 退避重试,避免触发 45012 信息收集阶段需要快速铺开某单位/域名的互联网资产面时 recon true

FOFA 资产测绘(限速安全版)

凭据

  • API Key:从环境变量 FOFA_KEY 读取(任何 key 都不要写进仓库;本技能所有脚本只读环境变量)
  • 接口:GET https://fofa.info/api/v1/search/all
  • 参数:key、qbase64(查询语句的 base64)、size、page、fields

官方限额(fofa.info/vip,2026-09 核对)

会员 查询请求 获取数据量 查询接口并发
注册用户(免费) 无 API(页面 300 次/月) 页面 3,000 条/月 —
个人版 10,000 次/月 100,000 条/月 1 秒 1 次
专业版 80,000 次/月 800,000 条/月 1 秒 1 次
商业版 900,000 次/月 9,000,000 条/月 1 秒 2 次
企业版 V2 5,000,000 次/月 50,000,000 条/月 1 秒 5 次

实测行为(实测验证)

  • 连续快速请求 → HTTP 429,响应体 {"error":true,"errmsg":"[45012] 请求速度过快"}
  • key 错误 → HTTP 200 + {"error":true,"errmsg":"[-700] 账号无效"}
  • 单页 size 到 1000 正常;请求间隔 ≥1 秒时连续请求均返回 200
  • 结论:按 1 请求/秒 保守执行,绝不并发;遇到 45012 必须退避,不要立即重试

使用纪律(重要)

  1. 精确查询优先:domain= / cert= / org= 先缩小范围,再考虑 body= / title= 等宽泛语句。宽语句返回几十万条没意义,还烧配额。
  2. 不要全量翻页:默认只取前 1–3 页(每页 100 条)拿到测绘入口即可。
  3. 单进程单线程:同一时刻只跑一个采集任务;多个查询串行排队。
  4. 结果落盘缓存:同一查询不要重复拉,先看 runs/fofa-*.jsonl 是否已有。
  5. 长任务放后台:用 run_in_background 跑,别阻塞对话。
  6. 配额耗尽或被限速时改用其他数据源(证书透明、DNS、搜索引擎),不要死磕。

限速客户端(用这个,不要手写 curl 循环)

cat > runs/fofa_client.py <<'PY'
#!/usr/bin/env python3
"""FOFA 采集(限速安全):单线程 + 最小间隔 + 指数退避 + 结果缓存。

用法:
  python3 runs/fofa_client.py 'domain="example.com"' --pages 2 --size 100 --interval 2.0
输出:
  runs/fofa-<slug>.jsonl   每行一个资产 {host,ip,port,title,domain,server,protocol}
"""
import argparse, base64, hashlib, json, os, sys, time, urllib.error, urllib.parse, urllib.request

KEY = os.environ["FOFA_KEY"]
API = "https://fofa.info/api/v1/search/all"
FIELDS = "host,ip,port,title,domain,server,protocol"
RETRY_BACKOFF = [5, 15, 45]          # 遇 45012 的退避秒数
HARD_BUDGET = 30                      # 单次运行最多请求次数


def fetch(query, page, size, timeout=30):
    qs = urllib.parse.urlencode({
        "key": KEY, "qbase64": base64.b64encode(query.encode()).decode(),
        "size": size, "page": page, "fields": FIELDS,
    })
    req = urllib.request.Request(API + "?" + qs, headers={"User-Agent": "redteam-recon/1.0"})
    try:
        with urllib.request.urlopen(req, timeout=timeout) as r:
            return r.status, json.load(r)
    except urllib.error.HTTPError as e:
        body = e.read().decode("utf-8", "ignore")
        try:
            return e.code, json.loads(body)
        except Exception:
            return e.code, {"error": True, "errmsg": body[:200]}


def main():
    ap = argparse.ArgumentParser()
    ap.add_argument("query")
    ap.add_argument("--pages", type=int, default=2, help="最多翻页数(默认 2)")
    ap.add_argument("--size", type=int, default=100, help="每页条数(默认 100,不要调大)")
    ap.add_argument("--interval", type=float, default=2.0, help="请求最小间隔秒(默认 2.0)")
    ap.add_argument("--out", default=None)
    args = ap.parse_args()

    slug = hashlib.md5(args.query.encode()).hexdigest()[:8]
    out = args.out or f"runs/fofa-{slug}.jsonl"
    os.makedirs(os.path.dirname(out) or ".", exist_ok=True)

    if os.path.exists(out) and os.path.getsize(out) > 0:
        print(f"[cache] {out} 已存在({os.path.getsize(out)} bytes),如需重拉请先删除", file=sys.stderr)
        return 0

    seen, rows, requests_made, last_ts = set(), [], 0, 0.0
    for page in range(1, args.pages + 1):
        # ---- 限速:保证两次请求之间至少间隔 interval 秒 ----
        wait = args.interval - (time.time() - last_ts)
        if wait > 0:
            time.sleep(wait)

        status, data = None, None
        for attempt, backoff in enumerate([0] + RETRY_BACKOFF):
            if attempt:
                print(f"[backoff] 等待 {backoff}s 后重试 (page={page})", file=sys.stderr)
                time.sleep(backoff)
            last_ts = time.time()
            requests_made += 1
            if requests_made > HARD_BUDGET:
                print(f"[stop] 达到请求预算 {HARD_BUDGET}", file=sys.stderr)
                break
            status, data = fetch(args.query, page, args.size)
            if status == 200 and not data.get("error"):
                break
            errmsg = str(data.get("errmsg", ""))
            if "45012" in errmsg or status == 429:
                continue                      # 限速 → 退避重试
            print(f"[stop] 不可重试错误 http={status} {errmsg}", file=sys.stderr)
            data = None
            break
        if data is None:
            break

        results = data.get("results") or []
        print(f"[page {page}] {len(results)} 条 (size={data.get('size')}, 消耗F点={data.get('consumed_fpoint')})", file=sys.stderr)
        for item in results:
            if isinstance(item, str):
                item = [item]
            host = item[0] if len(item) > 0 else ""
            ip = item[1] if len(item) > 1 else ""
            port = item[2] if len(item) > 2 else ""
            key = (host, ip, port)
            if key in seen:
                continue
            seen.add(key)
            rows.append({
                "host": host, "ip": ip, "port": port,
                "title": item[3] if len(item) > 3 else "",
                "domain": item[4] if len(item) > 4 else "",
                "server": item[5] if len(item) > 5 else "",
                "protocol": item[6] if len(item) > 6 else "",
            })
        if len(results) < args.size:
            break                              # 已到末页

    with open(out, "w", encoding="utf-8") as f:
        for row in rows:
            f.write(json.dumps(row, ensure_ascii=False) + "\n")
    print(f"[done] {len(rows)} 条资产 → {out}(共 {requests_made} 次请求)", file=sys.stderr)
    return 0


if __name__ == "__main__":
    sys.exit(main())
PY

用法

mkdir -p runs
python3 runs/fofa_client.py 'domain="example.com"' --pages 2 --size 100 --interval 2.0
python3 runs/fofa_client.py 'cert="example.com"' --pages 3 --interval 2.0
python3 runs/fofa_client.py 'org="示例科技有限公司"' --pages 2 --interval 2.0

落库

读 runs/fofa-*.jsonl,逐条 redteam_asset_add:provenance="passive"、tool="fofa",端口带 url=host、title、product=server;域名写进 names。

常用查询语句

目的 语句
某域名全部资产 domain="example.com"
证书包含该域名 cert="example.com"
某 C 段 ip="203.0.113.0/24"
单位名称 org="示例科技有限公司"
按标题找后台 title="登录" && domain="example.com"
按 body 特征 body="/seeyon/"
指定端口 ip="203.0.113.0/24" && port="3306"

宽泛语句(单独用 body= / title=)结果量大、消耗配额快,务必叠加域名或 IP 限定。