ZoomEye 网络空间搜索

通过 zoomeye CLI（v3.0.0）搜索全球网络资产。

何时使用

触发条件

当用户请求涉及以下任一情况时，必须加载本 skill：

• 搜索网络资产/设备/服务（"帮我搜一下...""查一下暴露的...")
• 构建 ZoomEye/Fofa/Shodan 类搜索引擎的 dork 查询语句
• 仅做语法转换：用户描述了想搜什么但只想要 dork 语句，不执行搜索（"这个怎么搜""语法是什么""帮我把这句话转成 ZoomEye 语法"）
• 资产测绘、暴露面发现、漏洞影响面评估（需用 ZoomEye 执行搜索）
• 需要查询 ICP 备案、SSL 证书、HTTP 响应头等关联信息
• 用户明确提到 "zoomeye"、"ZoomEye"、"钟馗之眼"、"网络空间搜索"

不适用场景

• 用户只是在聊天中提到 ZoomEye 但不涉及实际操作
• 用户问的是其他搜索引擎（Shodan、Censys、Fofa），且没有说"用 ZoomEye 来搜"
• 纯理论讨论搜索语法，不需要执行

仅语法转换模式

如果用户只是想把自然语言转成 ZoomEye dork 语句（"这个怎么搜"、"帮我写个语法"、"转成 zoomeye 语句"），不需要检查环境和执行搜索，直接跳到 工作流程 → 第1步：自然语言 → Dork 转换，输出转换后的 dork 语句即可。

前置条件

第一步：检查环境

收到任何搜索请求后，必须先执行以下检查，不要假设环境已就绪：

# 检查是否已安装
which zoomeye && zoomeye -v

# 检查 token 是否已配置（init 后 token 持久化在 ~/.config/zoomeye/setting/，只需配置一次，后续会话无需重配）
zoomeye info

第二步：根据检查结果引导用户

如果 zoomeye 未安装：

提示用户安装：

pip3 install zoomeye

安装完成后继续下一步。

如果 zoomeye info 返回 login required, missing Authorization header（未配置 token）：

按以下步骤引导用户：

1. 告知用户需要 ZoomEye 的 API-KEY：

   使用 ZoomEye 搜索需要 API-KEY，请按以下步骤操作：

   1. 打开 https://www.zoomeye.org/profile 登录你的 ZoomEye 账号
   2. 在个人中心找到你的 API-KEY（不设过期时间，可随时重置）
   3. 把 API-KEY 发给我，我帮你执行初始化

2. 用户提供 KEY 后，执行：

   zoomeye init -apikey "\x3C用户提供的APIKEY>"
   

3. 验证配置是否生效：

   zoomeye info
   

   确认返回的用户信息正确后，再开始搜索。

如果 zoomeye info 正常返回用户信息：

环境就绪，直接进入工作流程。

CLI 命令一览

zoomeye -h                              # 帮助
zoomeye -v                              # 版本号
zoomeye info                            # 账户信息、订阅、积分余额
zoomeye search "\x3Cdork>" [参数]           # 核心搜索命令
zoomeye clear -cache                    # 清除本地缓存（~/.config/zoomeye/cache）
zoomeye clear -setting                  # 清除存储的 API Key 和 token

search 命令参数

错误处理

搜索语法

基本规则

• 搜索不区分大小写（仅 == 精准匹配时区分大小写）
• 搜索字符串会被分词后匹配（官网提供"分词"测试）
• 字符串值用引号包裹："Cisco System" 或 'Cisco System'
• 字符串内引号用 \ 转义："a\"b"
• 括号用 \ 转义：portinfo\(\)

逻辑运算符

搜索字段速查

设备与服务指纹

IP、域名与组织

地理位置

SSL/TLS 证书

HTTP 头与正文

协议报文、哈希与时间

工作流程（AI 决策树）

环境检查通过后，按以下步骤构建并执行搜索：

1. 自然语言 → Dork 转换

用户的自然语言描述中包含以下关键词时，映射到对应搜索字段：

地理位置关键词

端口/服务关键词

设备/系统关键词

资产/组织关键词

Web 应用关键词

指纹/证书关键词

时间/版本关键词

自然语言 → Dork 转换示例

2. 构建 Dork

按以下原则拼接：

• 限制范围 → &&：country="CN" && service="redis" && os="Linux"
• 扩展匹配 → ||：port=80 || port=443 || port=8080
• 排除干扰 → !=：country="CN" && subdivisions!="beijing"
• 复杂条件 → ()：(country="CN" && port!=80) || (country="US" && title!="404 Not Found")

3. 选择 sub_type

4. 执行策略（配额优化）

遵循"试探→验证→导出"三步法：

# 第1步：小量试探，确认 dork 语法正确且有数据
zoomeye search "\x3Cdork>" -pagesize 10

# 第2步：用 facets 看数据分布（pagesize=1 最省配额）
zoomeye search "\x3Cdork>" -facets country,service,os,device -pagesize 1

# 第3步：确定方向后大批量导出
zoomeye search "\x3Cdork>" -pagesize 1000 -save

5. Shell 引号规则

关键原则：外层优先用单引号。 单引号内所有字符都是字面量，包括 \、"、$，不会发生 shell 扩展。仅当 dork 本身包含单引号字符（少见）时才换用双引号外层。

搜索结果解读

$ zoomeye search 'telnet' -pagesize 5
ip                port      domain        update_time
134.xx.xx.129     1901      [unknown]     2025-02-06T15:45:20
134.xx.xx.138     1901      [unknown]     2025-02-06T15:45:19

total: 5/9976411                  ← 当前页条数 / 全数据集匹配总数

使用 -facets 时底部追加聚合 Top 10：

 ----------------------------------------
 ZoomEye total data:9976411
 -------------product Top 10-------------
 product                            count
 MikroTik router config httpd       3326013
 Apache httpd                       2411293

常用搜索场景

资产发现与暴露面

# 某国暴露的数据库服务
zoomeye search 'country="CN" && (service="redis" || service="mysql" || service="mongodb" || service="elasticsearch")' -pagesize 10

# 某国暴露的远程管理服务
zoomeye search 'country="CN" && (service="rdp" || service="ssh" || service="telnet") && is_honeypot!="True"' -pagesize 10

# 某组织的 IP 资产
zoomeye search 'org="北京大学"' -pagesize 100
zoomeye search 'isp="China Mobile" && country="CN"' -pagesize 100

Web 应用识别

# 通过 Server 头找 Web 服务
zoomeye search 'http.header.server="nginx" && country="CN" && http.header.status_code="200"' -sub_type web -pagesize 10

# 通过标题找管理后台
zoomeye search '(title="admin" || title="login" || title="管理") && country="CN"' -sub_type web -pagesize 10

# 通过 body 内容找特定应用
zoomeye search 'http.body="phpMyAdmin" && country="CN"' -sub_type web -pagesize 10

SSL 证书关联

# 某公司证书关联的资产
zoomeye search 'ssl="google"' -pagesize 10
# 某域名的证书持有者
zoomeye search 'ssl.cert.subject.cn="example.com"' -pagesize 10
# Let's Encrypt 签发的证书（值内含单引号，外层必须用双引号，内层双引号需 \" 转义）
zoomeye search "ssl.cert.issuer.cn=\"Let's Encrypt\" && country=\"CN\"" -pagesize 10

漏洞影响面评估

# 某产品在全球/某国的分布（第一步：了解规模）
zoomeye search 'app="GitLab"' -facets country -pagesize 1

# 某产品特定版本
zoomeye search 'app="GitLab" && http.header.version="12.0"' -pagesize 100

# 时间范围内新出现的资产
zoomeye search 'app="Confluence" && after="2025-01-01"' -pagesize 100

指纹与图标搜索

# 通过 favicon 找同源网站
zoomeye search 'iconhash="f3418a443e7d841097c714d69ec4bcb8"' -sub_type web -pagesize 10

# 通过 JARM 指纹找同类服务
zoomeye search 'ssl.jarm="29d29d15d29d29d00029d29d29d29dea0f89a2e5fb09e4d8e099befed92cfa"' -pagesize 10

网段与 IP

# C 段资产
zoomeye search 'cidr="52.2.254.36/24"' -pagesize 100
# B 段 + 特定服务
zoomeye search 'cidr="52.2.254.36/16" && service="http"' -pagesize 100
# IP 精确搜索
zoomeye search 'ip="8.8.8.8"' -pagesize 10

SDK 用法

from zoomeye.sdk import ZoomEye

zm = ZoomEye(api_key="你的APIKEY")

# 查询账户信息
zm.userinfo()

# 搜索（完整参数）
result = zm.search(
    dork='country=cn',           # 搜索查询语句（必填）
    qbase64='',                  # base64 编码的查询（与 dork 二选一）
    page=1,                      # 页码，默认1
    pagesize=20,                 # 每页条数，默认20
    sub_type='all',              # v4 / v6 / web / all
    fields='ip,port,domain,os,app,title',
    facets='country,service'
)

# 返回格式:
# {'code': 60000, 'message': 'success', 'query': 'country=cn',
#  'total': 823268005, 'data': [{...}], 'facets': {}}

注意事项