china-kyc-doc-parse

china-kyc-doc-parse

用途

解析中国身份文件——提取并核验中国 KYC 文件中的数据。

数据来源

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)

次要来源

• 国家企业信用信息公示系统——营业执照核验
• 天眼查 / 企查查——企业信息
• 公安部——身份证核验（通过获批渠道）

文件类型

1. 个人身份证

身份证正面：

字段	位置	数据类型
姓名	上方区域	文本
性别	姓名下方	男/女
民族	性别下方	文本（例如，汉）
出生日期	民族下方	YYYY年MM月DD日
住址	下方区域	地址
公民身份号码	下方区域	18 位数字

身份证背面：

字段	描述
签发机关	签发机关
有效期限	有效期
证件签发	签发日期
证件失效	失效日期

身份证号码结构：

位置	长度	内容
1-6	6 位数字	地址码（行政区划）
7-14	8 位数字	出生日期（YYYYMMDD）
15-17	3 位数字	顺序码 + 性别（奇数=男性，偶数=女性）
18	1 位数字	校验码

2. 营业执照

统一社会信用代码：

结构	长度	内容
登记管理部门代码	1 位数字	9=工商，1=机构编制等
机构类别代码	1 位数字
登记管理机关行政区划码	6 位数字
主体标识码	9 位数字	组织机构代码
校验码	1 位数字	校验码

营业执照字段：

字段	内容
统一社会信用代码	18 位代码
名称	公司名称
类型	主体类型
法定代表人	法定代表人
注册资本	注册资本
成立日期	成立日期
住所	注册地址
经营范围	经营范围
登记机关	登记机关
登记日期	登记日期

3. 护照

字段	内容
护照号码	字母 + 8 位数字
姓名	中文 + 拼音
国籍	国籍
出生日期	DD/MM/YYYY
性别	男/女
出生地点	出生地点
签发日期	签发日期
有效期至	到期日期
签发机关	签发机关

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

字段	内容
证件号码	港澳台通行证号码
姓名	姓名
出生日期	出生日期
性别	性别
有效期至	到期日期

5. 外国人居留许可证

字段	内容
姓名	姓名（本国语言 + 中文）
国籍	国籍
出生日期	出生日期
性别	性别
有效期至	到期日期
签发机关	签发机关

解析工作流

步骤 1：文件接收

文件核验：

检查项	通过标准
照片清晰	照片清晰可辨
文字清晰	文字清晰可读
无遮挡	关键信息未被遮挡
证件在有效期内	未过期
证件真实	外观真实

步骤 2：数据提取

提取清单：

文件	待提取字段
身份证	姓名、身份证号码、出生日期、性别、地址
营业执照	公司名称、统一社会信用代码、法定代表人、注册资本、经营范围
护照	护照号码、姓名、国籍、出生日期、有效期
其他	视情况而定

步骤 3：身份证号码校验

身份证号码检查：

检查项	方法	通过
长度	18 位数字	✓
出生日期	有效日期	✓
性别	奇偶校验	✓
校验码	Mod 11 算法	✓
地址码	有效代码	✓

校验码算法：

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, ...

步骤 4：地址码解码

地址码查询：

代码	省份/城市
11	北京
31	上海
44	广东
33	浙江
32	江苏
...	...

步骤 5：数据规范化

规范化规则：

字段	规范化方式
名称	去除空白，不含间隔号
身份证号码	校验位使用大写 X
出生日期	YYYY-MM-DD 格式
地址	标准化
电话	+86 格式
注册资本	换算为万元
日期	YYYY-MM-DD 格式

步骤 6：质量检查

提取质量：

检查项	通过
已提取所有必填字段	✓
数据格式正确	✓
已验证身份证号码	✓
日期有效	✓
无 OCR 错误	✓

中国特定注意事项

反洗钱（AML）

要求	实施方式
客户身份识别	识别并验证客户
受益所有人	最终受益所有人
持续识别	持续监控
风险分类	风险分类
身份证明文件	所需的最低文件要求

按客户类型要求提供的文件

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

常见问题

问题	解决方法
照片模糊	请对方提供更清晰的副本
证件过期	请对方提供当前有效的文件
信息矛盾	通过其他来源进行核实
扫描不全	请对方提供完整文件

质量检查

完成前：

• 已提取所有字段
• 数据已验证
• 文件已核实
• 已执行 AML 检查
• 记录完整

数据源模式切换：设置环境变量 IFIND_DATA_SOURCE_MODE 以控制数据源偏好。

• ifind-only（严格）：仅使用 iFind；不可用时返回错误
• ifind-fallback（默认）：优先使用 iFind，不可用时回退到 AkShare
• akshare-only：跳过 iFind，仅使用 AkShare
• wind-only：仅使用 Wind；不可用时返回错误
• wind-fallback：优先使用 Wind，不可用时依次回退到 iFind → AkShare