← 返回 Skills 市场
412
总下载
9
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install idcard
功能描述
根据身份证号解析地区、出生日期、性别与校验位；可按城市查前六位规则。当用户说：这个身份证号是哪里发的？110101 开头是哪？或类似身份证归属问题时，使用本技能。
使用说明 (SKILL.md)
\r \r
极速数据身份证号码归属地查询（Jisu Idcard）\r
\r
数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r \r 支持：\r \r
- 身份证查询（
/idcard/query）\r - 城市查身份证前 6 位（
/idcard/city2code）\r \r 可用于对话中回答「这个身份证是哪里的」「校验位对不对」「鹿邑县对应的身份证前 6 位是多少」等问题。\r \r
前置配置：获取 API Key\r
\r
- 前往 极速数据官网 注册账号\r
- 进入 身份证号码归属地查询 API 页面，点击「申请数据」\r
- 在会员中心获取 AppKey\r
- 配置 Key：\r \r \r
# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/idcard/idcard.py`\r
\r
## 使用方式\r
\r
### 1. 身份证查询（query）\r
\r
```bash\r
python3 skills/idcard/idcard.py query '{"idcard":"41272519800102067x"}'\r
```\r
\r
### 2. 城市查身份证前 6 位（city2code）\r
\r
```bash\r
python3 skills/idcard/idcard.py city2code '{"city":"鹿邑"}'\r
```\r
\r
## 请求参数\r
\r
### /idcard/query\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|---------|--------|------|------------------|\r
| idcard | string | 是 | 身份证号或前 6 位 |\r
\r
### /idcard/city2code\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|--------|--------|------|------|\r
| city | string | 是 | 城市 |\r
\r
## 返回结果示例\r
\r
### /idcard/query\r
\r
```json\r
{\r
"province": "河南省",\r
"city": "周口市",\r
"town": "鹿邑县",\r
"lastflag": "0",\r
"sex": "男",\r
"birth": "1980年01月02日",\r
"area": "河南省周口市鹿邑县"\r
}\r
```\r
\r
字段说明：\r
\r
| 字段名 | 类型 | 说明 |\r
|----------|--------|--------------------------------------------------|\r
| province | string | 省 |\r
| city | string | 市 |\r
| town | string | 县 |\r
| lastflag | string | 最后一位校验码：`0` 正确，`1` 错误 |\r
| sex | string | 性别 |\r
| birth | string | 出生年月 |\r
| area | string | 区域信息（由于行政区划调整，具体以该字段为准） |\r
\r
### /idcard/city2code\r
\r
```json\r
{\r
"province": "河南省",\r
"city": "周口市",\r
"town": "鹿邑县",\r
"code": "412725"\r
}\r
```\r
\r
字段说明：\r
\r
| 字段名 | 类型 | 说明 |\r
|----------|--------|------------|\r
| code | string | 身份证前 6 位 |\r
| province | string | 省 |\r
| city | string | 市 |\r
| town | string | 县 |\r
\r
## 错误返回示例\r
\r
```json\r
{\r
"error": "api_error",\r
"code": 201,\r
"message": "身份证为空"\r
}\r
```\r
\r
## 常见错误码\r
\r
来源于 [极速数据身份证号码归属地文档](https://www.jisuapi.com/api/idcard/)：\r
\r
| 代号 | 说明 |\r
|------|------------|\r
| 201 | 身份证为空 |\r
| 202 | 身份证不正确 |\r
| 203 | 没有信息 |\r
\r
系统错误码：101 APPKEY 为空或不存在、102 已过期、103 无请求此数据权限、104 请求超过次数限制、105 IP 被禁止、106 IP 请求超过限制、107 接口维护中、108 接口已停用。\r
\r
## 推荐用法\r
\r
1. 用户：「帮我查一下 41272519800102067x 是哪里的」→ 调用 `query`，读取 `province`、`city`、`town` 和 `lastflag`，说明地区和校验是否通过。 \
\r
2. 用户：「鹿邑县的身份证前 6 位是多少？」→ 使用 `city2code '{"city":"鹿邑"}'`，返回 `code`。 \
\r
3. 用户：「校验一下这个身份证号是否正确」→ 使用 `query`，根据 `lastflag` 和是否返回 `result` 告知是否为合法号码。 \
\r
4. 用户：「只知道前 6 位，想确认大概地区」→ 仍使用 `query`，传入前 6 位，结合返回的 `province/city/town/area` 做说明。 \
\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息 \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测 \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询 \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别 \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令 \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换 \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r
安全使用建议
This skill appears to do exactly what it says: call JisuAPI to look up ID-card origin using the JISU_API_KEY you supply. Before installing, be aware that: (1) the script requires the Python 'requests' package but the README doesn't show how to install it (pip install requests), so you may need to ensure that dependency is available; (2) the skill will make network requests to api.jisuapi.com and will use whatever AppKey you provide—only provide a key you trust for this purpose; and (3) the package's source/homepage is listed as unknown, so if provenance matters to you, consider obtaining the API integration from a verified source or reviewing the code yourself (it is short and readable).
功能分析
Type: OpenClaw Skill
Name: idcard
Version: 1.0.3
The skill is a legitimate wrapper for the JisuAPI ID card lookup service. The Python script (idcard.py) correctly implements API requests using the requests library and handles environment variables for authentication as described in SKILL.md. No evidence of data exfiltration, malicious execution, or prompt injection was found.
能力评估
Purpose & Capability
Name/description map directly to the included code and the JisuAPI endpoints (api.jisuapi.com). The required env var (JISU_API_KEY) is the expected AppKey for that API; no unrelated credentials or services are requested.
Instruction Scope
SKILL.md instructs the agent to set JISU_API_KEY and run the included Python script with a JSON argument. The script only reads that env var and performs HTTP GETs to the documented JisuAPI endpoints; it does not access other system files, tokens, or unexpected endpoints.
Install Mechanism
This is an instruction-only skill with a bundled Python script (no install spec). The script requires python3 (declared) and the third-party 'requests' library (imported but not documented in SKILL.md). Missing dependency documentation may cause runtime failure but is not a security concern.
Credentials
Only a single API key (JISU_API_KEY) is required and used for calls to the JisuAPI service. No extra secrets, system config paths, or unrelated credentials are requested.
Persistence & Privilege
The skill is not forced-always, does not request persistent elevated privileges, and does not modify other skills or system-wide settings.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install idcard - 安装完成后，直接呼叫该 Skill 的名称或使用
/idcard触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.3
**Changelog for idcard v1.0.3**
- Improved skill description for clarity and guided use
- Added API provider introduction and use-case scenarios
- Expanded API key acquisition and setup instructions
- Detailed recommended usage examples for common scenarios
- Enhanced coverage of related API services from the provider
- General content reorganization for better readability and onboarding
v1.0.2
- No code or documentation changes detected in this version.
- Behavior, features, and usage remain identical to the previous release.
v1.0.1
Version 1.0.1
- No file or documentation changes detected in this version.
- Functionality, usage, and documentation remain unchanged from the previous release.
v1.0.0
- Initial release of jisu-idcard skill.
- Supports querying ID card location, birth date, gender, and checksum validation via the 极速数据 API.
- Adds the ability to look up the first 6 digits of an ID card based on city name.
- Includes command-line usage examples and environment variable setup instructions.
- Provides example responses and common error codes for easier troubleshooting.
元数据
常见问题
ID Card Number Origin Query - 身份证号码归属地查询 是什么？
根据身份证号解析地区、出生日期、性别与校验位；可按城市查前六位规则。当用户说：这个身份证号是哪里发的？110101 开头是哪？或类似身份证归属问题时，使用本技能。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 412 次。
如何安装 ID Card Number Origin Query - 身份证号码归属地查询？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install idcard」即可一键安装，无需额外配置。
ID Card Number Origin Query - 身份证号码归属地查询 是免费的吗？
是的，ID Card Number Origin Query - 身份证号码归属地查询 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
ID Card Number Origin Query - 身份证号码归属地查询 支持哪些平台？
ID Card Number Origin Query - 身份证号码归属地查询 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 ID Card Number Origin Query - 身份证号码归属地查询？
由 极速数据（@jisuapi）开发并维护，当前版本 v1.0.3。
推荐 Skills