China Kyc Doc Parse

Parse and extract data from Chinese identity documents for KYC (Know Your Customer) compliance. Adapts the original kyc-doc-parse skill for Chinese ID cards, business licenses, and domestic compliance requirements. Triggers on "A股KYC", "身份文件解析", "parse Chinese ID", "KYC document", "客户身份识别", or "extract [document type]".

jwangkun b795a1a 7.0 KB Updated Sep 17, 2026

Coding & Dev Tools

Install

Press C to copy

$ npx skillmds@latest add jwangkun/china-kyc-doc-parse

Installs into ~/.claude/skills (or .claude/skills inside a project). Restart Claude Code to pick it up.

Download SKILL.md

＋ Add to collection

README badge

[![SkillMD](https://skillmd.com/badge/jwangkun/china-kyc-doc-parse.svg)](https://skillmd.com/skills/jwangkun/china-kyc-doc-parse)

Trust & safety

Audits pending

Not yet audited · commit b795a1a

Works with: Claude Code Claude.ai OpenAI Codex +

File contents

china-kyc-doc-parse

Purpose

Parse 中国身份文件 — extract and verify data from Chinese KYC documents.

Data Sources

Tier 0 — 万得 Wind（最全面付费数据）

覆盖：A股/港美股/基金/指数/债券/宏观/研报/分析（44个工具）
MCP 服务：wind-mcp（需 WIND_API_KEY 密钥，以 ak_ 开头）
优势：全市场覆盖面最广、数据最全面、包含研报和量化分析
密钥申请：https://aifinmarket.wind.com.cn/#/home

Tier 1 — 同花顺 iFind（付费精确数据）/ AkShare MCP（Tier-2 免费备选）

# Not typically used for KYC; for background checks:
get_stock_info(ticker)                    → Company verification (if applicable)

Secondary Sources

国家企业信用信息公示系统 — business license verification
天眼查 / 企查查 — corporate information
公安部 — ID verification (via approved channels)

Document Types

1. 个人身份证 (Personal ID Card)

Front of ID card:

Field	Location	Data Type
姓名	Upper section	Text
性别	Below name	男/女
民族	Below gender	Text (e.g., 汉)
出生日期	Below ethnicity	YYYY年MM月DD日
住址	Lower section	Address
公民身份号码	Lower section	18-digit number

Back of ID card:

Field	Description
签发机关	Issuing authority
有效期限	Validity period
证件签发	Issue date
证件失效	Expiry date

ID number structure:

Position	Length	Content
1-6	6 digits	Address code (行政区划)
7-14	8 digits	Birth date (YYYYMMDD)
15-17	3 digits	Order code + gender (odd=male, even=female)
18	1 digit	Check digit

2. 营业执照 (Business License)

Unified Social Credit Code (统一社会信用代码):

Structure	Length	Content
登记管理部门代码	1 digit	9=工商, 1=机构编制, etc.
机构类别代码	1 digit
登记管理机关行政区划码	6 digits
主体标识码	9 digits	Org code
校验码	1 digit	Check digit

Business license fields:

Field	Content
统一社会信用代码	18-digit code
名称	Company name
类型	Entity type
法定代表人	Legal representative
注册资本	Registered capital
成立日期	Establishment date
住所	Registered address
经营范围	Business scope
登记机关	Registration authority
登记日期	Registration date

3. 护照 (Passport)

Field	Content
护照号码	Letter + 8 digits
姓名	Chinese + Pinyin
国籍	Nationality
出生日期	DD/MM/YYYY
性别	M/F
出生地点	Place of birth
签发日期	Issue date
有效期至	Expiry date
签发机关	Issuing authority

4. 港澳通行证 / 台湾通行证

Field	Content
证件号码	HK/Macau/Taiwan travel permit number
姓名	Name
出生日期	DOB
性别	Gender
有效期至	Expiry date

5. 外国人居留许可证

Field	Content
姓名	Name (native + Chinese)
国籍	Nationality
出生日期	DOB
性别	Gender
有效期至	Expiry date
签发机关	Issuing authority

Parsing Workflow

Step 1: Document Intake

Document verification:

Check	Pass Criteria
照片清晰	Photo clear enough to read
文字清晰	Text legible
无遮挡	No obstruction of key fields
证件在有效期内	Not expired
证件真实	Genuine appearance

Step 2: Data Extraction

Extraction checklist:

Document	Fields to Extract
身份证	Name, ID number, DOB, gender, address
营业执照	Company name, USCC, legal rep, registered capital, scope
护照	Passport number, name, nationality, DOB, expiry
其他	As applicable

Step 3: ID Number Validation

ID number checks:

Check	Method	Pass
Length	18 digits	✓
Birth date	Valid date	✓
Gender	Odd/even check	✓
Check digit	Mod 11 algorithm	✓
Address code	Valid code	✓

Check digit algorithm:

Weights: 7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2
Remainder → 0-10 → Code: 10→X, 0→1, 1→0, 2→9, ...

Step 4: Address Code Decoding

Address code lookup:

Code	Province/City
11	北京
31	上海
44	广东
33	浙江
32	江苏
...	...

Step 5: Data Normalization

Normalization rules:

Field	Normalization
Name	Trim whitespace, no middle dots
ID number	Uppercase X for check digit
DOB	YYYY-MM-DD format
Address	Standardize
Phone	+86 format
Registered capital	Convert to 万元
Dates	YYYY-MM-DD format

Step 6: Quality Checks

Extraction quality:

Check	Pass
All required fields extracted	✓
Data format correct	✓
ID number validated	✓
Dates valid	✓
No OCR errors	✓

China-Specific Considerations

Anti-Money Laundering (AML)

Requirement	Implementation
客户身份识别	Identify and verify customer
受益所有人	Ultimate beneficial owner
持续识别	Ongoing monitoring
风险分类	Risk categorization
身份证明文件	Minimum documents required

Required Documents by Customer Type

Type	Required
中国个人	身份证
外国个人	护照 + 居留许可
中国企业	营业执照 + 法人身份证
外国企业	注册文件 + 授权代表证件

Common Issues

Issue	Resolution
照片模糊	Request clearer copy
证件过期	Request current document
信息矛盾	Verify with other sources
扫描不全	Request complete document

Quality Checks

Before completing:

All fields extracted
Data validated
Documents verified
AML checks performed
Records complete
Data Source Mode Switch: Set env var IFIND_DATA_SOURCE_MODE to control data source preference.
- ifind-only (strict): Use iFind only, error if unavailable
- ifind-fallback (default): iFind preferred, fallback to AkShare
- akshare-only: Skip iFind, use AkShare only
- wind-only: Wind only, error if unavailable
- wind-fallback: Wind first, fallback to iFind → AkShare

---name: china-kyc-doc-parsedescription: Parse and extract data from Chinese identity documents for KYC (Know Your Customer) compliance. Adapts the original kyc-doc-parse skill for Chinese ID cards, business licenses, and domestic compliance requirements. Triggers on "A股KYC", "身份文件解析", "parse Chinese ID", "KYC document", "客户身份识别", or "extract [document type]".---# china-kyc-doc-parse## PurposeParse **中国身份文件** — extract and verify data from Chinese KYC documents.## Data Sources### Tier 0 — 万得 Wind（最全面付费数据）- 覆盖：A股/港美股/基金/指数/债券/宏观/研报/分析（44个工具）- MCP 服务：`wind-mcp`（需 `WIND_API_KEY` 密钥，以 `ak_` 开头）- 优势：全市场覆盖面最广、数据最全面、包含研报和量化分析- 密钥申请：https://aifinmarket.wind.com.cn/#/home### Tier 1 — 同花顺 iFind（付费精确数据）/ AkShare MCP（Tier-2 免费备选）```python# Not typically used for KYC; for background checks:get_stock_info(ticker) → Company verification (if applicable)```### Secondary Sources- 国家企业信用信息公示系统 — business license verification- 天眼查 / 企查查 — corporate information- 公安部 — ID verification (via approved channels)## Document Types### 1. 个人身份证 (Personal ID Card)**Front of ID card:**| Field | Location | Data Type ||-------|----------|-----------|| 姓名 | Upper section | Text || 性别 | Below name | 男/女 || 民族 | Below gender | Text (e.g., 汉) || 出生日期 | Below ethnicity | YYYY年MM月DD日 || 住址 | Lower section | Address || 公民身份号码 | Lower section | 18-digit number |**Back of ID card:**| Field | Description ||-------|-------------|| 签发机关 | Issuing authority || 有效期限 | Validity period || 证件签发 | Issue date || 证件失效 | Expiry date |**ID number structure:**| Position | Length | Content ||----------|--------|---------|| 1-6 | 6 digits | Address code (行政区划) || 7-14 | 8 digits | Birth date (YYYYMMDD) || 15-17 | 3 digits | Order code + gender (odd=male, even=female) || 18 | 1 digit | Check digit |### 2. 营业执照 (Business License)**Unified Social Credit Code (统一社会信用代码):**| Structure | Length | Content ||-----------|--------|---------|| 登记管理部门代码 | 1 digit | 9=工商, 1=机构编制, etc. || 机构类别代码 | 1 digit | || 登记管理机关行政区划码 | 6 digits | || 主体标识码 | 9 digits | Org code || 校验码 | 1 digit | Check digit |**Business license fields:**| Field | Content ||-------|---------|| 统一社会信用代码 | 18-digit code || 名称 | Company name || 类型 | Entity type || 法定代表人 | Legal representative || 注册资本 | Registered capital || 成立日期 | Establishment date || 住所 | Registered address || 经营范围 | Business scope || 登记机关 | Registration authority || 登记日期 | Registration date |### 3. 护照 (Passport)| Field | Content ||-------|---------|| 护照号码 | Letter + 8 digits || 姓名 | Chinese + Pinyin || 国籍 | Nationality || 出生日期 | DD/MM/YYYY || 性别 | M/F || 出生地点 | Place of birth || 签发日期 | Issue date || 有效期至 | Expiry date || 签发机关 | Issuing authority |### 4. 港澳通行证 / 台湾通行证| Field | Content ||-------|---------|| 证件号码 | HK/Macau/Taiwan travel permit number || 姓名 | Name || 出生日期 | DOB || 性别 | Gender || 有效期至 | Expiry date |### 5. 外国人居留许可证| Field | Content ||-------|---------|| 姓名 | Name (native + Chinese) || 国籍 | Nationality || 出生日期 | DOB || 性别 | Gender || 有效期至 | Expiry date || 签发机关 | Issuing authority |## Parsing Workflow### Step 1: Document Intake**Document verification:**| Check | Pass Criteria ||-------|--------------|| 照片清晰 | Photo clear enough to read || 文字清晰 | Text legible || 无遮挡 | No obstruction of key fields || 证件在有效期内 | Not expired || 证件真实 | Genuine appearance |### Step 2: Data Extraction**Extraction checklist:**| Document | Fields to Extract ||----------|------------------|| 身份证 | Name, ID number, DOB, gender, address || 营业执照 | Company name, USCC, legal rep, registered capital, scope || 护照 | Passport number, name, nationality, DOB, expiry || 其他 | As applicable |### Step 3: ID Number Validation**ID number checks:**| Check | Method | Pass ||-------|--------|------|| Length | 18 digits | ✓ || Birth date | Valid date | ✓ || Gender | Odd/even check | ✓ || Check digit | Mod 11 algorithm | ✓ || Address code | Valid code | ✓ |**Check digit algorithm:**```Weights: 7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2Remainder → 0-10 → Code: 10→X, 0→1, 1→0, 2→9, ...```### Step 4: Address Code Decoding**Address code lookup:**| Code | Province/City ||------|--------------|| 11 | 北京 || 31 | 上海 || 44 | 广东 || 33 | 浙江 || 32 | 江苏 || ... | ... |### Step 5: Data Normalization**Normalization rules:**| Field | Normalization ||-------|--------------|| Name | Trim whitespace, no middle dots || ID number | Uppercase X for check digit || DOB | YYYY-MM-DD format || Address | Standardize || Phone | +86 format || Registered capital | Convert to 万元 || Dates | YYYY-MM-DD format |### Step 6: Quality Checks**Extraction quality:**| Check | Pass ||-------|------|| All required fields extracted | ✓ || Data format correct | ✓ || ID number validated | ✓ || Dates valid | ✓ || No OCR errors | ✓ |## China-Specific Considerations### Anti-Money Laundering (AML)| Requirement | Implementation ||-------------|----------------|| 客户身份识别 | Identify and verify customer || 受益所有人 | Ultimate beneficial owner || 持续识别 | Ongoing monitoring || 风险分类 | Risk categorization || 身份证明文件 | Minimum documents required |### Required Documents by Customer Type| Type | Required ||------|----------|| 中国个人 | 身份证 || 外国个人 | 护照 + 居留许可 || 中国企业 | 营业执照 + 法人身份证 || 外国企业 | 注册文件 + 授权代表证件 |### Common Issues| Issue | Resolution ||-------|-----------|| 照片模糊 | Request clearer copy || 证件过期 | Request current document || 信息矛盾 | Verify with other sources || 扫描不全 | Request complete document |## Quality ChecksBefore completing:- [ ] All fields extracted- [ ] Data validated- [ ] Documents verified- [ ] AML checks performed- [ ] Records complete> **Data Source Mode Switch**: Set env var `IFIND_DATA_SOURCE_MODE` to control data source preference.> - `ifind-only` (strict): Use iFind only, error if unavailable> - `ifind-fallback` (default): iFind preferred, fallback to AkShare> - `akshare-only`: Skip iFind, use AkShare only> - `wind-only`: Wind only, error if unavailable> - `wind-fallback`: Wind first, fallback to iFind → AkShare

jwangkun/claude-for-financial-services-cn/tree/main/vertical-plugins/operations/skills/china-kyc-doc-parse commit b795a1a57e

Frequently asked questions

npx skillmds@latest add jwangkun/china-kyc-doc-parse