anyixing-verify 1.0.3 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anyixing-verify",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "实名认证核验：身份证二要素、银行卡四要素、手机号二/三要素。可一键装成 AI 技能（Claude Code / Cursor / WorkBuddy），也能直接当命令行工具用。",
   "keywords": [
     "实名认证",

package/skill/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: anyixing-verify
-version: 1.0.3
+version: 1.0.5
 display_name: 安宜星实名认证
 display_name_en: Anyixing Identity Verification
+icon: assets/icon.png
 description: 核验中国居民身份证号、银行卡号、手机号的实名信息，判断姓名与证件号／银行卡号／手机号是否属于同一人。当用户要求实名认证、KYC 校验、实名核验、身份证二要素核验、银行卡四要素核验（含预留手机号）、手机号实名核验、绑定银行卡前校验、注册风控、确认身份证号与姓名是否匹配、验证手机号是否为本人实名时使用；也用于把这类核验能力接入用户自己的网站、后端、小程序或 App（写调用代码、配环境变量、联调）。接口由安宜星提供，按次计费，调用前需在官网获取 API Key（新用户赠 2 元）。
 description_zh: 核验身份证号、银行卡号、手机号的实名信息，判断姓名与证件是否属于同一人。支持身份证二要素、银行卡四要素（含预留手机号）、手机号二／三要素核验，也可把这套能力接入你自己的网站或应用。
 description_en: Verify Chinese ID numbers, bank cards and mobile numbers against a person's name. Supports ID 2-element, bank card 4-element (with reserved phone) and mobile 2/3-element verification. Can also be integrated into your own website or app.
@@ -69,7 +70,25 @@ python3 scripts/verify.py config --clear   # 清除
 
 ## 调用方式
 
-统一走 `scripts/verify.py`，三种核验都是它的子命令：
+**先看当前环境有哪些能力，按顺序选一种能跑通的，不要因为某一种不可用就放弃：**
+
+1. **平台已注册核验工具**（例如豆包「自定义工具」里已有 `anyixing_verify_*`）→ 直接调工具，最稳
+2. **能发 HTTP 请求**（有 curl、有代码解释器、能跑任意语言）→ 用下面的 HTTP 示例
+3. **能跑 Python** → 用 `scripts/verify.py`，它会顺带翻译结论、报费用和余额
+
+三种方式打的是同一个接口，返回结构完全一致，选哪个都不影响结果与计费。
+
+### 方式一：HTTP 请求（最通用）
+
+```bash
+curl -s https://smrz.anyixing.com.cn/api/v1/idcard \
+  -H "X-Api-Key: $SMRZ_API_KEY" -H "Content-Type: application/json" \
+  -d '{"name":"张三","idcard":"330102199001010012"}'
+```
+
+银行卡换 `/api/v1/bankcard`（四个字段都要传），手机号换 `/api/v1/mobile`。字段说明见 `references/api.md`。
+
+### 方式二：Python 脚本（有 Python 时更省事）
 
 ```bash
 # 身份证二要素
@@ -88,14 +107,6 @@ python3 scripts/verify.py mobile --name 张三 --mobile 13800138000 --idcard 330
 
 需要机器可读结果时加 `--json`，输出接口原始 JSON。
 
-直接发 HTTP 请求也可以，详见 `references/api.md`：
-
-```bash
-curl -s https://smrz.anyixing.com.cn/api/v1/idcard \
-  -H "X-Api-Key: $SMRZ_API_KEY" -H "Content-Type: application/json" \
-  -d '{"name":"张三","idcard":"330102199001010012"}'
-```
-
 ## 帮用户接进他自己的项目
 
 用户说「把实名认证接到我的网站 / 后端 / 小程序里」时走这条路径，完整示例见 `references/integration.md`。