手机三要素验证

解决什么问题

在实名注册、风控审核、账号找回等场景里，单看手机号是否真实并不足够——还需要确认这个号码确实属于提交的姓名与身份证号。本技能封装运营商三要素验证接口，一次调用即可判断 姓名 + 身份证号 + 手机号 三者是否一致，避免在业务代码里手写 HTTP 请求、签名与结果解析。

核心能力

• 一致性校验：返回明确的结果码，result: 0 表示一致，1 表示不一致，2 表示无记录。
• 三网覆盖：支持移动（cmcc）、联通（cucc）、电信（ctcc）号码。
• 附加信息：除校验结论外，还返回运营商、性别、生日、籍贯等字段，可用于补充画像或二次审计。
• 脚本化调用：在技能根目录执行 scripts/query_mobile_three.py，传入 --name、--idcard、--mobile 三个必填参数即可，脚本内部负责携带 ChinazVer 与 APIKey 请求接口并输出 JSON。

工作流程

1. 从用户请求中提取三项参数，缺一不可，格式错误会返回 invalid_input。
2. 优先读取环境变量 CHINAZ_MOBILE_THREE_API_KEY，未配置时需通过 --api-key 传入。
3. 脚本输出 JSON，按 code 判断是否成功（200 为成功），再结合 result、msg、desc 给出结论。

使用边界与注意点

• 一次只查一条：批量场景需自行编写循环逐条执行，不要指望接口接受列表参数。
• 数据仅供参考：结果来自第三方数据源，可能存在更新延迟，最终以运营商官方渠道为准。
• 密钥不落地：不要把 API Key 写进日志、代码仓库或回复正文；遇到 missing_api_key 时引导用户补发，而不是伪造一次成功响应。
• 失败不要编造：额度不足或 Key 失效时，如实转述返回的 code 与错误说明。