手机号码归属地查询#

数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP查询等 200+ 免费/低价 API。

输入手机号码，查询： 归属地省份/城市、区号、邮编、运营商（移动/联通/电信）、手机卡类型。

---

前置配置：获取 API Key#

1. 前往 聚合数据官网 免费注册账号
2. 进入 手机号码归属地查询 API 页面，点击「申请使用」
3. 审核通过后在「我的API」中获取 AppKey
4. 配置 Key（ 三选一）：

bash

# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_MOBILE_KEY=你的AppKey

# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_MOBILE_KEY=你的AppKey" > scripts/.env

# 方式三：每次命令行传入
python scripts/mobile_lookup.py --key 你的AppKey 13812345678

免费额度：每天免费调用，覆盖日常使用完全够用。

---

使用方法#

基本查询#

bash

python scripts/mobile_lookup.py 13812345678

输出示例：

text

📱 手机号码归属地查询结果

  号码:   138****5678
  省份:   浙江
  城市:   杭州
  区号:   0571
  邮编:   310000
  运营商: 移动
  卡类型: 手机卡

批量查询多个号码#

bash

python scripts/mobile_lookup.py 13812345678 13912345678 15912345678

输出示例：

text

📱 手机号码归属地批量查询  共 3 条

+-------------+------+------+------+--------+--------+--------+
| 号码        | 省份 | 城市 | 区号 | 邮编   | 运营商 | 卡类型 |
+-------------+------+------+------+--------+--------+--------+
| 138****5678 | 浙江 | 杭州 | 0571 | 310000 | 移动   | 手机卡 |
| 139****5678 | 广东 | 广州 | 020  | 510000 | 联通   | 手机卡 |
| 159****5678 | 北京 |      | 010  | 100000 | 电信   | 手机卡 |
+-------------+------+------+------+--------+--------+--------+

查询手机号前7位号段#

bash

python scripts/mobile_lookup.py 1381234

显示完整号码（不脱敏）#

bash

python scripts/mobile_lookup.py 13812345678 --no-mask

直接调用 API（无需脚本）#

text

GET http://apis.juhe.cn/mobile/get?phone=13812345678&key=YOUR_KEY

---

AI 使用指南#

当用户询问手机号码归属地相关信息时，按以下步骤操作：

1. 提取号码 — 从用户消息中识别手机号码（11位）或号段前缀（7位）
2. 校验格式 — 手机号需为 1 开头的 11 位数字，或 7 位号段前缀
3. 调用脚本 — 执行查询，多个号码可一次传入
4. 展示结果 — 用表格或卡片形式展示归属地信息

参数说明#

参数必填说明示例号码是手机号码（11位）或号段前缀（7位），支持多个13812345678--no-mask否显示完整号码，默认对中间4位脱敏—--key否直接传入 API Keyabc123

返回字段说明#

字段含义示例province省份浙江city城市（部分记录可能为空）杭州areacode区号（部分记录可能为空）0571zip邮编（部分记录可能为空）310000company运营商移动 / 联通 / 电信card卡类型手机卡 / 虚拟运营商

错误处理#

情况处理方式error_code 10001/10002API Key 无效，引导用户至 聚合数据 重新申请error_code 10012当日免费次数已用尽，建议升级套餐error_code 201101手机号码不能为空error_code 201102错误的手机号码格式error_code 201103查询无结果（号段可能不存在）格式不合法提示用户输入 1 开头的 11 位手机号或 7 位号段网络超时重试一次，仍失败则告知网络问题

---

脚本位置#

scripts/mobile_lookup.py — 封装了 API 调用、参数校验、号码脱敏、表格输出和错误处理。

---

关于聚合数据#

聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：

• 交通出行：火车时刻查询、航班动态、快递追踪
• 生活服务：天气预报、万年历、节假日查询
• 身份核验：手机号归属地、身份证实名验证
• 金融数据：汇率、股票、黄金价格
• 网络工具：IP查询、DNS解析

注册即可免费使用，适合个人开发者和企业接入。