← Back to Skills Marketplace
运营商三要素核验 - 聚合数据
by
juhe-skills
· GitHub ↗
· v1.0.0
· MIT-0
136
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install juhe-telecom-verify
Description
三网手机实名认证。验证手机号、姓名、身份证三要素是否一致，支持移动、联通、电信三网。使用场景：用户说"实名认证"、"手机号实名验证"、"验证三要素"、"手机号和姓名是否匹配"、"身份证和手机号一致性"等。通过聚合数据（juhe.cn）API 实时核验，免费注册每天免费调用。
README (SKILL.md)
三网手机实名认证
数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP 查询等 200+ 免费/低价 API。
验证手机号、姓名、身份证三要素一致性：中国移动、中国联通、中国电信全网支持。
前置配置：获取 API Key
- 前往 聚合数据官网 免费注册账号
- 进入 三网手机实名认证 API 页面，点击「申请使用」
- 审核通过后在「我的 API」中获取 AppKey
- 配置 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 13800138000
免费额度：每天免费调用，具体次数以官网为准。
使用方法
三要素核验（手机号 + 姓名 + 身份证）
python scripts/telecom_verify.py --name 张三 --idcard 110101199001011234 --mobile 13800138000
输出示例：
📱 三网手机实名认证结果
验证结果：✅ 一致
手机号：138****8000
姓名：张*
身份证：110101********1234
运营商：中国移动
省份：北京
直接调用 API（无需脚本）
GET https://v.juhe.cn/telecom/query?key=YOUR_KEY&realname=张三&idcard=110101199001011234&mobile=13800138000
AI 使用指南
当用户需要进行手机实名认证时，按以下步骤操作：
- 收集信息 — 从用户消息中获取手机号、姓名、身份证号
- 验证格式 — 检查手机号是否为 11 位、身份证是否符合格式
- 调用脚本或 API — 执行验证，获取结果
- 展示结果 — 清晰展示验证结果，敏感信息脱敏处理
返回字段说明
| 字段 | 含义 | 示例 |
|---|---|---|
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+ 快递公司实时追踪
- 金融数据：汇率、股票、黄金价格
注册即可免费使用，适合个人开发者和企业接入。
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: juhe-telecom-verify
Version: 1.0.0
The skill is a legitimate wrapper for the Juhe (聚合数据) API to perform mobile phone real-name verification. The Python script (telecom_verify.py) correctly handles API key configuration via environment variables or CLI arguments and includes functions for data masking to protect PII in the output. No evidence of malicious intent, data exfiltration to unauthorized endpoints, or prompt injection was found.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install juhe-telecom-verify - After installation, invoke the skill by name or use
/juhe-telecom-verify - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of juhe-telecom-verify.
- Supports real-name authentication for mobile numbers against name and ID card across China Mobile, China Unicom, and China Telecom.
- Provides detailed usage instructions for both script and direct API calls.
- Includes guidance on obtaining and configuring an API key from juhe.cn.
- Offers result formatting, sensitive data masking, and clear error handling workflows.
- Suitable for identity verification scenarios such as "手机号实名验证".
Metadata
Frequently Asked Questions
What is 运营商三要素核验 - 聚合数据?
三网手机实名认证。验证手机号、姓名、身份证三要素是否一致，支持移动、联通、电信三网。使用场景：用户说"实名认证"、"手机号实名验证"、"验证三要素"、"手机号和姓名是否匹配"、"身份证和手机号一致性"等。通过聚合数据（juhe.cn）API 实时核验，免费注册每天免费调用。 It is an AI Agent Skill for Claude Code / OpenClaw, with 136 downloads so far.
How do I install 运营商三要素核验 - 聚合数据?
Run "/install juhe-telecom-verify" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 运营商三要素核验 - 聚合数据 free?
Yes, 运营商三要素核验 - 聚合数据 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 运营商三要素核验 - 聚合数据 support?
运营商三要素核验 - 聚合数据 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 运营商三要素核验 - 聚合数据?
It is built and maintained by juhe-skills (@juhemcp); the current version is v1.0.0.
More Skills