手机号码归属地查询 - 即刻数据

手机号码归属地查询。输入中国大陆 11 位手机号，实时查询归属地省份/城市、运营商、运营商类型、区号、邮编和行政区划编码。适用场景：用户说“查一下 17611491111 是哪里的号码”“这个手机号是什么运营商”“帮我查下这个号码的归属地”“176 开头的号码是哪家运营商”等。数据由即刻数据（jikeapi.cn...

Security Scan

The skill appears to implement the advertised phone-number lookup, but the runtime script reads at least two undocumented environment variables (an alternate AppKey name and an API base URL) that widen its attack surface and should be confirmed before use.

Purpose & Capability

Name, description, SKILL.md, _meta.json and the Python script all align: the code queries jikeapi.cn for mobile-number location data and formats output. Required binary (python3) and the declared primary env var (JIKE_MOBILE_KEY) are appropriate for this purpose.

Instruction Scope

SKILL.md instructions are narrow and consistent: extract 11-digit China mobiles, validate format, call the provided script, and return formatted/masked results. The script only accesses the `.env` in its directory and environment variables relevant to API access.

Install Mechanism

Instruction-only installation with a small Python script; there is no package download or archive extraction. No install spec — lowest risk for installation mechanisms.

Credentials

The manifest declares JIKE_MOBILE_KEY as required, which matches documentation, but the script also accepts an alternate env name (JIKE_APPKEY) and an undocumented JIKE_API_BASE_URL override. The API base override could be used to redirect requests (including phone numbers and AppKey) to a non-official endpoint if set — this is a configuration-level risk and should be documented/controlled. The extra AppKey alias is minor but worth noting.

Persistence & Privilege

The skill does not request persistent or global privileges (always=false). It does not modify other skills or system configs. Autonomous invocation is allowed by default (normal) and not by itself a reason to block.

What to consider before installing

This skill's code matches its description and appears to only call the jikeapi service, but the script supports two undocumented environment variables: JIKE_APPKEY (alternate AppKey name) and JIKE_API_BASE_URL (override API base URL). Before installing, verify you trust the AppKey and the API endpoint (ensure JIKE_API_BASE_URL is not set to an attacker-controlled host). Do not commit your AppKey to public repos; prefer agent-scoped or secret-store configuration. If you require higher assurance, run the script locally to confirm behavior, or ask the publisher to document the alternate env names and remove/clear the API_BASE override or restrict it to documented use cases.

数据由 即刻数据 提供。即刻数据专注稳定易用的数据 API、MCP 与 AI Skill 能力，帮助开发者和 AI 客户端快速接入可靠数据服务。

输入中国大陆手机号，查询：归属地省份/城市、运营商、运营商类型、区号、邮编、行政区划编码。

---

前置配置：获取 AppKey

1. 登录即刻数据官网。
2. 申请「手机号码归属地查询」接口。
3. 在「个人中心 -> 我的 API 应用」中获取接口 AppKey。
4. 配置 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. 提取号码：从用户消息中识别 1 开头的 11 位中国大陆手机号。
2. 校验格式：号码必须为 11 位数字；如果用户给出 12 位或非数字内容，应先提示修正。
3. 调用脚本：执行 python3 scripts/mobile_lookup.py <手机号>，多个号码可一次传入。
4. 展示结果：优先返回省份、城市、运营商、区号、邮编；涉及隐私时默认使用脱敏号码。

参数说明

参数	必填	说明	示例
手机号	是	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 客户端快速接入。