Mobile Phone Number Undeliverable or Empty Detection - 手机空号检测

批量检测手机号是否空号、实号、沉默号或风险号。当用户说：帮我测一下这几个号码是不是空号？批量验一下实号，或类似号码状态检测时，使用本技能。

极速数据手机空号检测（Jisu MobileEmpty）

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。

适合在对话中回答「这批手机号哪些是空号」「帮我筛出活跃用户号码」「哪些号码存在风险」等问题。

前置配置：获取 API Key

1. 前往 极速数据官网 注册账号
2. 进入 手机空号检测 API 页面，点击「申请数据」
3. 在会员中心获取 AppKey
4. 配置 Key：

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/mobileempty/mobileempty.py

使用方式

批量检测手机号（最多 100 个）

python3 skills/mobileempty/mobileempty.py '{"mobiles":"18156080000,18156080001,18156080002"}'

请求 JSON 示例：

{
  "mobiles": "18156080000,18156080001,18156080002"
}

请求参数

字段名	类型	必填	说明
mobiles	string	是	待检测的号码，逗号分隔，最多 100 个

返回结果示例

脚本直接输出接口的 result 字段，结构与官网一致，例如：

{
  "risk": [],
  "real": [],
  "empty": [],
  "unknown": [
    "18156080000",
    "18156080002",
    "18156080001"
  ]
}

字段含义：

• risk：风险包集合（长时间关机、未开通语音服务、易投诉用户等）
• real：实号包集合（正常活跃用户）
• empty：空号包集合（近 1 个月内出现过的空号、停机号）
• unknown：沉默包集合（在网但不可用）

错误返回示例

{
  "error": "api_error",
  "code": 201,
  "message": "手机号为空"
}

常见错误码

来源于 极速数据手机空号检测文档：

代号	说明
201	手机号为空
202	手机号有误
203	检测失败
204	手机号个数不得大于 100

系统错误码：101 APPKEY 为空或不存在、102 已过期、103 无请求权限、104 请求超过次数限制、105 IP 被禁止、106 IP 请求超过限制、107 接口维护中、108 接口已停用。

推荐用法

1. 用户：「这 50 个号码有哪些是空号？」→ 将用户提供的号码整理成逗号分隔字符串，调用脚本，读取 empty 列表返回。 \n
2. 用户：「帮我筛出活跃用户号码」→ 调用接口后使用 real 结果，结合业务上下文整理为可直接用于下游发送的号码列表。 \n
3. 用户：「这批号码中哪些存在风险？」→ 关注返回中的 risk，并向用户解释风险含义（长时间关机、未开通语音、易投诉等）。 \n
4. 用户：「区分可用与沉默号码」→ 将 real 视为可用号码，将 empty/unknown 视为不可用或需谨慎使用的号码，并以表格或分组列表形式呈现。 \n

关于极速数据

极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：

• 生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
• 工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测
• 交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
• 图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别
• 娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
• 位置服务：基站查询，经纬度地址转换，坐标系转换

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索 jisuapi 找到更多基于极速数据的 OpenClaw 技能。