手机号码归属地查询 - 即刻数据
数据由 即刻数据 提供。即刻数据专注稳定易用的数据 API、MCP 与 AI Skill 能力,帮助开发者和 AI 客户端快速接入可靠数据服务。
输入中国大陆手机号,查询:归属地省份/城市、运营商、运营商类型、区号、邮编、行政区划编码。
前置配置:获取 AppKey
- 登录即刻数据官网。
- 申请「手机号码归属地查询」接口。
- 在「个人中心 -> 我的 API 应用」中获取接口
AppKey。 - 配置 Key(推荐使用环境变量):
# 方式一:环境变量(推荐)
export JIKE_MOBILE_KEY=你的AppKey
# 方式二:脚本目录 .env 文件(本地测试使用)
echo "JIKE_MOBILE_KEY=你的AppKey" > scripts/.env
# 方式三:命令行临时传入
python3 scripts/mobile_lookup.py --key 你的AppKey 17611491111
Windows 用户可在系统环境变量中新增:
变量名:JIKE_MOBILE_KEY
变量值:你的AppKey
不要把真实 AppKey 写进公开仓库或上传到 Skill 包中。
使用方法
基本查询
示例号码参考即刻数据接口文档,最后 4 位可用 1111 代替:
python3 scripts/mobile_lookup.py 17611491111
输出示例:
📱 手机号码归属地查询结果
号码: 176****1111
省份: 北京
城市: 北京
运营商: 中国联通
类型: 联通
邮编: 100000
区号: 010
行政区划: 110100
批量查询多个号码
python3 scripts/mobile_lookup.py 17611491111 17611492222
输出示例:
📱 手机号码归属地批量查询 共 2 条
+-------------+------+------+------+--------+----------+------+
| 号码 | 省份 | 城市 | 区号 | 邮编 | 运营商 | 类型 |
+-------------+------+------+------+--------+----------+------+
| 176****1111 | 北京 | 北京 | 010 | 100000 | 中国联通 | 联通 |
| 176****2222 | 北京 | 北京 | 010 | 100000 | 中国联通 | 联通 |
+-------------+------+------+------+--------+----------+------+
显示完整号码(不脱敏)
python3 scripts/mobile_lookup.py 17611491111 --no-mask
输出 JSON
python3 scripts/mobile_lookup.py 17611491111 --json
直接传入 AppKey
python3 scripts/mobile_lookup.py --key 你的AppKey 17611491111
直接调用 API
GET https://api.jikeapi.cn/v1/mobile/query?mobile=17611491111&appkey=YOUR_APPKEY
AI 使用步骤
当用户询问手机号归属地、运营商、区号、邮编等信息时,按以下步骤处理:
- 提取号码:从用户消息中识别
1开头的 11 位中国大陆手机号。 - 校验格式:号码必须为 11 位数字;如果用户给出 12 位或非数字内容,应先提示修正。
- 调用脚本:执行
python3 scripts/mobile_lookup.py <手机号>,多个号码可一次传入。 - 展示结果:优先返回省份、城市、运营商、区号、邮编;涉及隐私时默认使用脱敏号码。
参数说明
| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
| 手机号 | 是 | 1 开头的 11 位中国大陆手机号,支持多个 | 17611491111 |
--no-mask | 否 | 展示完整号码;默认对中间 4 位脱敏 | --no-mask |
--json | 否 | 输出 JSON,便于其他程序读取 | --json |
--key | 否 | 临时传入 AppKey;日常建议使用环境变量 | --key 你的AppKey |
返回字段
| 字段 | 含义 | 示例 |
|---|---|---|
province | 省份 | 北京 |
city | 城市 | 北京 |
isp | 运营商名称 | 中国联通 |
isp_type | 运营商类型 | 联通 |
post_code | 邮编 | 100000 |
city_code | 区号 | 010 |
area_code | 行政区划编码 | 110100 |
错误处理
| 情况 | 处理方式 |
|---|---|
未配置 JIKE_MOBILE_KEY | 提醒用户先在即刻数据申请接口,并配置环境变量 |
| 手机号格式错误 | 提示用户提供 1 开头的 11 位手机号 |
| AppKey 无效或无权限 | 提醒用户检查个人中心中的 AppKey 和接口授权状态 |
| 接口次数不足 | 提醒用户查看套餐、余额或调用次数 |
| 查询无结果 | 告知该号码暂未查询到归属地信息 |
| 网络超时 | 建议稍后重试,或检查本地网络和代理设置 |
脚本位置
scripts/mobile_lookup.py:封装了参数解析、AppKey 读取、接口请求、号码脱敏、文本/JSON 输出和错误处理。
关于即刻数据
即刻数据(jikeapi.cn) 是面向开发者和 AI 应用的数据服务平台,提供稳定易用的 API、MCP 与 AI Skill 能力。
典型能力包括:
- 生活服务:天气、号码归属地、万年历、行政区划等。
- 企业数据:工商信息、企业风险、统一社会信用代码等。
- 网络工具:IP 查询、域名解析、二维码、短链接等。
- AI 接入:MCP Server、AI Skill、本地客户端能力包。
适合个人开发者、企业系统、自动化工具和 AI 客户端快速接入。