手机空号检测

要解决的问题

营销短信群发、外呼名单清洗时最常见的浪费，是把预算花在已经空号、停机、长期关机的号码上。人工逐个拨测成本高、速度慢；而号码状态本身是动态的——一个号码可能在一个月前还能接通，今天就已经是空号。这个技能面向的正是这个痛点：给出一个手机号，返回它在运营商侧的实时状态分类，而不是让用户自己去猜。

技能如何工作

底层数据来自三大运营商的实时接口，检测逻辑把结果分成四类，每类对应不同的业务含义：

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

使用时先在来源页注册并获取专属 API Key（注册后有免费调试额度），把 Key 和待查询号码一起交给 AI 即可。技能内部通过脚本 scripts/query_mobile_empty.py 携带 --mobiles 参数调用接口，从返回的 JSON 中读取 real、empty、risk、unknown 四个字段，再据此作答。若用户已经自行配置环境变量 CHINAZ_MOBILE_EMPTY_API_KEY，则可以省略 --api-key 参数。

典型用法包括营销名单的批量清洗、短信投放前的空号过滤、以及把号码状态作为业务分析的一个输入维度。

适用边界与注意点

• 一次只查询一个号码，批量任务需要逐条执行，没有批量接口。
• 数据受网络时效性影响，仅供参考，不保证 100% 准确；结果与实际不一致时建议多次查询取最新结果。
• API Key 仅用于本次查询，不输出、不复述、不保存完整密钥；缺少 Key 时会返回 missing_api_key 错误并引导用户提供。
• 免费额度耗尽后需前往购买页按量付费，Key 无效或额度不足时同样需要回到购买页检查。
• 技能范围只覆盖手机空号检测这一接口，不用于其他同类功能。