运营商三要素核验 - 聚合数据

三网手机实名认证。验证手机号、姓名、身份证三要素是否一致，支持移动、联通、电信三网。使用场景：用户说"实名认证"、"手机号实名验证"、"验证三要素"、"手机号和姓名是否匹配"、"身份证和手机号一致性"等。通过聚合数据（juhe.cn）API 实时核验，免费注册每天免费调用。

Security Scan

The skill's requirements, instructions, and included script are consistent with its stated purpose (calling juhe.cn to verify name/ID/phone); it transmits user PII to a third-party API and requires an API key, which is expected for this functionality.

Purpose & Capability

Name/description describe telecom three-factor verification and the skill requires python3 and a JUHE_TELECOM_KEY — both are appropriate and necessary for calling the juhe.cn API. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md and the script explicitly instruct the agent to collect sensitive personal data (mobile, name, ID number) and to POST it to juhe.cn for verification. This is expected for the stated task, but it means PII will be transmitted to a third party — the README does recommend desensitizing outputs and performs masking in the script.

Install Mechanism

No install spec; the skill is instruction-only with a small included Python script. Nothing is downloaded or extracted from untrusted URLs. Requiring python3 is reasonable.

Credentials

Only JUHE_TELECOM_KEY is required (declared as primaryEnv). The script supports command-line, env var, or local .env — these are proportional to the API usage. The key is sensitive and should be protected.

Persistence & Privilege

always is false; the skill is user-invocable and allows normal autonomous invocation. It does not request persistent system-wide privileges or modify other skills/configs.

Assessment

This skill appears to do what it says: call juhe.cn to verify mobile+name+ID. Before installing, consider: (1) It will collect and send personally identifying information (name, ID number, phone) to a third-party service — ensure you have user consent and that this use complies with applicable laws/policies. (2) The JUHE_TELECOM_KEY is sensitive; store it securely (avoid committing to repos), and prefer scoped/rotated keys if possible. (3) The script reads a local scripts/.env file if present — treat that file as secret. (4) If you want to minimize risk, proxy API calls through a server you control so the agent or client doesn't hold the API key directly. (5) Review juhe.cn's terms, privacy, and rate limits (free tier limits are noted). The included Python script is straightforward, not obfuscated, and matches the documented behavior.

三网手机实名认证

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

验证手机号、姓名、身份证三要素一致性：中国移动、中国联通、中国电信全网支持。

---

前置配置：获取 API Key

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

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

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

# 方式三：每次命令行传入
python scripts/telecom_verify.py --key 你的 AppKey --name 张三 --idcard 110101199001011234 --mobile [phone]

免费额度：每天免费调用，具体次数以官网为准。

---

使用方法

三要素核验（手机号 + 姓名 + 身份证）

python scripts/telecom_verify.py --name 张三 --idcard 110101199001011234 --mobile [phone]

输出示例：

📱 三网手机实名认证结果

验证结果：✅ 一致
手机号：138****8000
姓名：张*
身份证：110101********1234
运营商：中国移动
省份：北京

直接调用 API（无需脚本）

GET https://v.juhe.cn/telecom/query?key=YOUR_KEY&realname=张三&idcard=110101199001011234&mobile=13800138000

---

AI 使用指南

当用户需要进行手机实名认证时，按以下步骤操作：

1. 收集信息 — 从用户消息中获取手机号、姓名、身份证号
2. 验证格式 — 检查手机号是否为 11 位、身份证是否符合格式
3. 调用脚本或 API — 执行验证，获取结果
4. 展示结果 — 清晰展示验证结果，敏感信息脱敏处理

返回字段说明

字段	含义	示例
res	验证结果	1=一致，0=不一致
resmsg	验证说明	"一致" / "不一致"
orderid	订单号	J2023120516063890969J
type	运营商类型	移动/联通/电信
province	省份	北京
city	城市	北京市
rescode	结果代码	11=一致，21=不一致等

错误处理

情况	处理方式
error_code 10001/10002	API Key 无效，引导用户至 聚合数据 重新申请
error_code 10012	当日免费次数已用尽，建议升级套餐
手机号格式错误	告知手机号格式错误，建议用户重新输入
身份证号格式错误	告知身份证号格式错误，建议用户重新输入
验证不一致	告知用户姓名、手机号、身份证不匹配
网络超时	重试一次，仍失败则告知网络问题

---

脚本位置

scripts/telecom_verify.py — 封装了 API 调用、参数验证、结果格式化和错误处理。

---

关于聚合数据

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

• 网络工具：IP 查询、DNS 解析、端口检测
• 生活服务：天气预报、万年历、节假日查询
• 身份核验：手机号实名认证、身份证实名验证、银行卡认证
• 物流快递：100+ 快递公司实时追踪
• 金融数据：汇率、股票、黄金价格

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