中国居民身份证识别与抽取（ADP） — 中国居民身份证识别与抽取（Automatic Data Processing，ADP）

身份证识别与抽取 Skill 能力由来也科技 ADP（Agentic Document Processing）智能体文档处理平台提供，支持中国居民身份证的智能识别与关键信息抽取能力。本 Skill 调用来也科技 ADP 官方 CLI 工具，一条命令即可完成身份证图片/扫描件的结构化字段抽取，输出标准 JSON，无缝对接业务系统。

快速接入指南 核心工作流 安装依赖：首次执行时，安装 ADP CLI 工具。 认证配置：首次执行时，运行 adp config get 检查凭证。若未配置，提示用户提供 API Key。 获取应用列表：首次执行时，通过 adp app-id list --app-type 0 获取开箱即用应用列表，找到身份证抽取应用并记录其 app_id（以 ootb_ 开头）。后续优先使用 adp app-id cache。 执行抽取：运行 adp extract url --app-id <身份证抽取应用ID> 或 adp extract local <文件路径> --app-id <身份证抽取应用ID>。 结果处理：解析返回的 JSON，提取姓名、性别、民族、出生、住址、身份证号码、签发机构、有效期限等结构化字段（无论正面、反面还是正反面复印在同一页，均统一返回完整 8 字段）。 错误处理：命令失败时，解析 stderr JSON 确定错误类型和恢复操作。

场景 → 命令映射 单张识别 用户意图 | 推荐命令 ---|--- 识别一张身份证图片（URL） | adp extract url --app-id 识别一张本地身份证图片 | adp extract local <文件路径> --app-id 识别 Base64 编码的身份证 | adp extract base64 --app-id --file-name id.jpg 批量识别 用户意图 | 推荐命令 ---|--- 批量识别本地文件夹内的身份证 | adp extract local <文件夹路径> --app-id 批量识别多个 URL | adp extract url --app-id 异步处理 用户意图 | 推荐命令 ---|--- 异步提交大文件 | adp extract url --app-id --async 异步批量处理 | adp extract local <文件夹路径> --app-id --async 查询异步任务结果 | adp extract query 并发限制：免费用户最大 2，付费用户最大 10

第一步：安装 ADP CLI # 方法 1: npm（推荐，全平台通用） npm install -g @laiye-adp/agentic-doc-parse-and-extract-cli # 方法 2: Shell 脚本（Linux / macOS，无 npm 环境时使用） curl -fsSL https://raw.githubusercontent.com/laiye-ai/adp-cli/main/scripts/adp-init.sh | bash # 方法 3: PowerShell 脚本（Windows，无 npm 环境时使用） irm https://raw.githubusercontent.com/laiye-ai/adp-cli/main/scripts/adp-init.ps1 | iex 或从 GitHub Releases 下载预编译二进制文件包。

第二步：获取 API Key 与认证配置

• 访问 ADP 门户获取凭证

我们为国内和海外用户提供了独立的公有云访问地址，需按地区分别配置。就近访问可更好地保障高速稳定的网络调用。 地区 | 登录地址 | API Base URL ---|---|--- 中国大陆 | https://adp.laiye.com/ | https://adp.laiye.com/ 海外地区 | https://adp-global.laiye.com/ | https://adp-global.laiye.com/

• 注册/登录后获取 API Key

新用户需先注册 ADP 账号，注册后即可获得每月 100 免费积分。 登录后，点击个人头像，即可直接进入 API_Key 入口。

• 完成认证配置

adp config set --api-key adp config set --api-base-url https://adp.laiye.com

• 验证配置

adp config get 注意事项： 如果 API Key 和 API Base URL 已配置完成，建议将配置信息存储到环境变量中，避免每次使用时重复配置。 如果 API Key 和 API Base URL 尚未配置，请按照以上步骤完成配置。

第三步：获取身份证抽取应用 ID ADP 为中国居民身份证提供了开箱即用的内置抽取应用，无需额外配置。 应用类型说明 ADP 应用分为两类，通过 app_type 字段区分： app_type | 类型 | 说明 ---|---|--- 0 | 开箱即用应用（OOTB） | 平台内置，app_id 以 ootb_ 开头，无需创建，直接使用 1 | 自定义应用 | 用户自行创建的抽取应用，app_id 为用户自定义标识 身份证识别属于开箱即用应用，可通过 --app-type 0 筛选查询。 查询并筛选身份证应用 # 仅查询开箱即用应用（推荐） adp app-id list --app-type 0 # 或查询所有应用 adp app-id list 从返回列表中找到 app_label 包含 "身份证" 的应用，记录其 app_id： [ { "app_id": "ootb_***y2z5", "app_label": ["身份证", "大陆居民身份证", "身份凭证", "个人证件", "信息提取"], "app_name": "身份证", "app_type": 0 } ] 上例中 "app_id": "ootb_y2z5" 即为身份证抽取应用。app_type 为 0 表示开箱即用应用，1 表示自定义应用。 缓存应用 ID（推荐） 首次查询后，后续优先使用缓存避免重复请求： # 后续使用缓存 adp app-id cache 重要提示：每个账号下的 app_id 是唯一且固定的，除非用户主动删除应用，否则 app_id 不会变更。建议 Agent 将身份证应用的 app_id 保存在上下文中，下次直接使用。

第四步：执行身份证抽取 单张身份证抽取（URL） adp extract url https://example.com/id-card-front.jpg --app-id <身份证抽取应用ID> 单张身份证抽取（本地文件） adp extract local ./id-card-front.jpg --app-id <身份证应用ID> 单张身份证抽取（Base64） adp extract base64 --app-id <身份证应用ID> --file-name id-card.jpg 返回结果示例 无论输入的是身份证正面、反面，还是正反面复印在同一页，ADP 均统一返回完整的 8 字段 JSON 结构，识别到的字段自动填充，无需调用方区分正反面。 [ { "field_key": "name", "field_name": "姓名", "field_values": [ { "field_value": "程" } ] }, { "field_key": "gender", "field_name": "性别", "field_values": [ { "field_value": "女" } ] }, { "field_key": "ethnicity", "field_name": "民族", "field_values": [ { "field_value": "汉" } ] }, { "field_key": "birth_date", "field_name": "出生", "field_values": [ { "field_value": "1990年01月15日" } ] }, { "field_key": "address", "field_name": "住址", "field_values": [ { "field_value": "河南省周口市项城市镇号" } ] }, { "field_key": "id_number", "field_name": "身份证号码", "field_values": [ { "field_value": "412702********3322" } ] }, { "field_key": "issuing_authority", "field_name": "签发机构", "field_values": [ { "field_value": "周口市公安局项城分局" } ] }, { "field_key": "valid_period", "field_name": "有效期限", "field_values": [ { "field_value": "2015.01.15-2035.01.15" } ] } ]

抽取字段说明 ADP 身份证抽取始终统一返回以下 8 个字段，无论输入图片包含正面、反面还是正反面合一： field_key | field_name | 说明 ---|---|--- name | 姓名 | 持证人姓名 gender | 性别 | 男 / 女 ethnicity | 民族 |