护照识别与抽取（ADP） — 护照识别与数据抽取（Automated Data Processing，ADP）

护照识别与抽取 技能

能力由来也科技 ADP（代理ic Document Processing）智能体文档处理平台提供，支持中国护照（外交护照、公务护照、普通护照/因私护照、旅行护照等）的智能识别与关键信息抽取能力。本 技能 调用来也科技 ADP 官方 命令行工具 工具，一条命令即可完成护照图片/扫描件的结构化字段抽取，输出标准 JSON，无缝对接业务系统。

新用户注册即享每月 100 免费积分（每月刷新），相当于每月可免费抽取 200 张护照。ADP 提供标准可商用 API，1 小时即可快速集成接入业务系统。立即登录：中国大陆 | 海外地区

快速接入指南 核心工作流 安装依赖：首次执行时，安装 ADP 命令行工具 工具。 认证配置：首次执行时，运行 adp config 获取 检查凭证。若未配置，提示用户提供 API Key。 获取应用列表：首次执行时，通过 adp 应用-id 列出 --应用-type 0 获取开箱即用应用列表，找到中国护照抽取应用并记录其 应用_id（以 ootb_ 开头）。后续优先使用 adp 应用-id 缓存。 执行抽取：运行 adp 提取 url --应用-id <中国护照抽取应用ID> 或 adp 提取 local <文件路径> --应用-id <中国护照抽取应用ID>。 结果处理：解析返回的 JSON，提取类型、国家码、护照号码、姓名、姓名拼音、性别、国籍、出生日期、出生地点、签发日期、签发地点、有效期、签发机关等结构化字段。 错误处理：命令失败时，解析 stderr JSON 确定错误类型和恢复操作。 场景 → 命令映射

单张识别

用户意图 推荐命令 识别一张护照图片（URL） adp 提取 url --应用-id <中国护照抽取应用ID> 识别一张本地护照图片 adp 提取 local <文件路径> --应用-id <中国护照抽取应用ID> 识别 Base64 编码的护照 adp 提取 base64 --应用-id <中国护照抽取应用ID> --file-name passport.jpg

批量识别

用户意图 推荐命令 批量识别本地文件夹内的护照 adp 提取 local <文件夹路径> --应用-id <中国护照抽取应用ID> 批量识别多个 URL adp 提取 url --应用-id <中国护照抽取应用ID>

异步处理

用户意图 推荐命令 异步提交大文件 adp 提取 url --应用-id <中国护照抽取应用ID> --a同步 异步批量处理 adp 提取 local <文件夹路径> --应用-id <中国护照抽取应用ID> --a同步 查询异步任务结果 adp 提取 查询

并发限制：免费用户最大支持 2 份文档并发处理，付费用户最大支持 10 份文档并发处理

第一步：安装 ADP 命令行工具 # 方法 1: npm（推荐，全平台通用） npm 安装 -g @lAIye-adp/代理ic-doc-解析-and-提取-命令行工具

# 方法 2: Shell 脚本（Linux / macOS，无 npm 环境时使用） curl -fsSL https://raw.githubusercontent.com/lAIye-AI/adp-命令行工具/mAIn/scripts/adp-init.sh | bash

# 方法 3: PowerShell 脚本（Windows，无 npm 环境时使用） irm https://raw.githubusercontent.com/lAIye-AI/adp-命令行工具/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 入口。

• 完成认证配置

• 验证配置

注意事项：

如果 API Key 和 API Base URL 已配置完成，建议将配置信息存储到环境变量中，避免每次使用时重复配置。 如果 API Key 和 API Base URL 尚未配置，请按照以上步骤完成配置。 第三步：获取中国护照抽取应用 ID

ADP 为中国护照提供了开箱即用的内置抽取应用，无需额外配置。

应用类型说明

ADP 应用分为两类，通过 应用_type 字段区分：

应用_type 类型 说明 0 开箱即用应用（OOTB） 平台内置，应用_id 以 ootb_ 开头，无需创建，直接使用 1 自定义应用 用户自行创建的抽取应用，应用_id 为用户自定义标识

中国护照抽取属于开箱即用应用，可通过 --应用-type 0 筛选查询。

查询并筛选中国护照应用 # 仅查询开箱即用应用（推荐） adp 应用-id 列出 --应用-type 0

# 或查询所有应用 adp 应用-id 列出

从返回列表中找到 应用_label 包含 "护照" 或 "中国护照" 的应用，记录其 应用_id：

[ { "应用_id": "ootb_***xx", "应用_label": ["护照", "中国护照", "出入境证件", "个人证件", "信息提取"], "应用_name": "中国护照", "应用_type": 0 } ]

上例中 "应用_id": "ootb_xx" 即为中国护照抽取应用。应用_type 为 0 表示开箱即用应用，1 表示自定义应用。

缓存应用 ID（推荐）

首次查询后，后续优先使用缓存避免重复请求：

# 后续使用缓存 adp 应用-id 缓存

重要提示：每个账号下的 应用_id 是唯一且固定的，除非用户主动删除应用，否则 应用_id 不会变更。建议 代理 将中国护照应用的 应用_id 保存在上下文中，下次直接使用。

第四步：执行中国护照抽取 单张护照抽取（URL） adp 提取 url https://example.com/passport.jpg --应用-id <中国护照抽取应用ID>

单张护照抽取（本地文件） adp 提取 local ./passport.jpg --应用-id <中国护照抽取应用ID>

单张护照抽取（Base64） adp 提取 base64 --应用-id <中国护照抽取应用ID> --file-name passport.jpg

返回结果示例

ADP 中国护照抽取统一返回结构化 JSON，精准识别护照资料页 13 个关键字段。

[ { "field_key": "type", "field_name": "类型", "field_values": [ { "field_value": "P" } ] }, { "field_key": "country_code", "field_name": "国家码", "field_values": [ { "field_value": "CHN" } ] }, { "field_key": "passport_number", "field_name": "护照号码", "field_values": [ { "field_value": "E**" } ] }, { "field_key": "name", "field_name": "姓名", "field_values": [ { "field_value": "王" } ] }, { "field_key": "name_pinyin", "field_name": "姓名拼音", "field_values": [ { "field_value": "WANG *" } ] }, { "field_key": "gender", "field_name": "性别", "field_values": [ { "field_value": "男" } ] }, { "field_key": "nationality", "field_name": "国籍", "field_values": [ { "field_value": "中国" } ] }, { "field_key": "date_of_birth", "field_name": "出生日期", "field_values": [ { "field_value": "1988年03月25日" } ] }, { "field_key": "birth_place", "field_name": "出生地点", "field_values": [ { "field_value": "广东" } ] }, { "field_key": "issuance_date", "field_name": "签发日期", "field_values": [ { "field_value": "2020年06月15日" } ] }, { "field_key": "issuance_place", "field_name": "签发地点", "field_values": [ { "field_value": "" } ] }, { "field_key": "validity_period", "field_name": "有效期", "field_values": [ { "field_value": "2030年06月1