中国居民户口本识别与抽取 Skill

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

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

快速接入指南

核心工作流

1. 安装依赖：首次执行时，安装 ADP CLI 工具。
2. 认证配置：首次执行时，运行 adp config get 检查凭证。若未配置，提示用户提供 API Key。
3. 获取应用列表：首次执行时，通过 adp app-id list --app-type 0 获取开箱即用应用列表，找到户口本抽取应用并记录其 app_id（以 ootb_ 开头）。后续优先使用 adp app-id cache。
4. 执行抽取：运行 adp extract url \x3CURL> --app-id \x3C户口本抽取应用ID> 或 adp extract local \x3C文件路径> --app-id \x3C户口本抽取应用ID>。
5. 结果处理：解析返回的 JSON，提取户别、户主姓名、户号、住址、姓名、与户主关系、曾用名、性别、出生地、民族、籍贯、出生日期、本市其他住址、宗教信仰、身份证号码、身高、血型、文化程度、婚姻状况、服务处所、职业、登记日期、编号等结构化字段。
6. 错误处理：命令失败时，解析 stderr JSON 确定错误类型和恢复操作。

场景 → 命令映射

单张识别

批量识别

异步处理

并发限制：免费用户最大 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 与认证配置

1. 访问 ADP 门户获取凭证

我们为国内和海外用户提供了独立的公有云访问地址，需按地区分别配置。就近访问可更好地保障高速稳定的网络调用。

2. 注册/登录后获取 API Key

新用户需先注册 ADP 账号，注册后即可获得每月 100 免费积分。

• 登录后，点击个人头像，即可直接进入 API_Key 入口。

3. 完成认证配置

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

4. 验证配置

adp config get

注意事项：

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

第三步：获取户口本抽取应用 ID

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

应用类型说明

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

户口本识别属于开箱即用应用，可通过 --app-type 0 筛选查询。

查询并筛选户口本应用

# 仅查询开箱即用应用（推荐）
adp app-id list --app-type 0

# 或查询所有应用
adp app-id list

从返回列表中找到 app_label 包含 "户口本" 的应用，记录其 app_id：

[
  {
    "app_id": "ootb_******xx",
    "app_label": ["户口本", "户口簿", "户籍", "个人证件", "信息提取"],
    "app_name": "户口本",
    "app_type": 0
  }
]

上例中 "app_id": "ootb_******xx" 即为户口本抽取应用。app_type 为 0 表示开箱即用应用，1 表示自定义应用。

缓存应用 ID（推荐）

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

# 后续使用缓存
adp app-id cache

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

第四步：执行户口本抽取

单张户口本抽取（URL）

adp extract url https://example.com/hukou-page.jpg --app-id \x3C户口本抽取应用ID>

单张户口本抽取（本地文件）

adp extract local ./hukou-page.jpg --app-id \x3C户口本抽取应用ID>

单张户口本抽取（Base64）

adp extract base64 \x3Cbase64字符串> --app-id \x3C户口本抽取应用ID> --file-name hukou.jpg

返回结果示例

ADP 户口本抽取统一返回结构化 JSON，支持户口本首页和个人页共 23 个关键字段识别抽取。

[
  {
    "field_key": "household_type",
    "field_name": "户别",
    "field_values": [
      {
        "field_value": "非农业家庭户"
      }
    ]
  },
  {
    "field_key": "householder_name",
    "field_name": "户主姓名",
    "field_values": [
      {
        "field_value": "张三"
      }
    ]
  },
  {
    "field_key": "household_number",
    "field_name": "户号",
    "field_values": [
      {
        "field_value": "110108001234"
      }
    ]
  },
  {
    "field_key": "residential_address",
    "field_name": "住址",
    "field_values": [
      {
        "field_value": "北京市海淀区中关村大街1号"
      }
    ]
  },
  {
    "field_key": "member_name",
    "field_name": "姓名",
    "field_values": [
      {
        "field_value": "张三"
      }
    ]
  },
  {
    "field_key": "relationship_with_head_of_household",
    "field_name": "与户主关系",
    "field_values": [
      {
        "field_value": "户主"
      }
    ]
  },
  {
    "field_key": "previous_names",
    "field_name": "曾用名",
    "field_values": [
      {
        "field_value": "张小三"
      }
    ]
  },
  {
    "field_key": "gender",
    "field_name": "性别",
    "field_values": [
      {
        "field_value": "男"
      }
    ]
  },
  {
    "field_key": "place_of_birth",
    "field_name": "出生地",
    "field_values": [
      {
        "field_value": "北京市海淀区"
      }
    ]
  },
  {
    "field_key": "nationality",
    "field_name": "民族",
    "field_values": [
      {
        "field_value": "汉"
      }
    ]
  },
  {
    "field_key": "hometown",
    "field_name": "籍贯",
    "field_values": [
      {
        "field_value": "山东省济南市"
      }
    ]
  },
  {
    "field_key": "date_of_birth",
    "field_name": "出生日期",
    "field_values": [
      {
        "field_value": "1985年06月20日"
      }
    ]
  },
  {
    "field_key": "this_city_other_address",
    "field_name": "本市其他住址",
    "field_values": [
      {
        "field_value": "北京市朝阳区望京西路8号院"
      }
    ]
  },
  {
    "field_key": "religious_belief",
    "field_name": "宗教信仰",
    "field_values": [
      {
        "field_value": "无"
      }
    ]
  },
  {
    "field_key": "id_number",
    "field_name": "身份证号码",
    "field_values": [
      {
        "field_value": "110108198506201234"
      }
    ]
  },
  {
    "field_key": "height",
    "field_name": "身高",
    "field_values": [
      {
        "field_value": "175cm"
      }
    ]
  },
  {
    "field_key": "blood_type",
    "field_name": "血型",
    "field_values": [
      {
        "field_value": "A"
      }
    ]
  },
  {
    "field_key": "education_level",
    "field_name": "文化程度",
    "field_values": [
      {
        "field_value": "大学本科"
      }
    ]
  },
  {
    "field_key": "marital_status",
    "field_name": "婚姻状况",
    "field_values": [
      {
        "field_value": "已婚"
      }
    ]
  },
  {
    "field_key": "service_place",
    "field_name": "服务处所",
    "field_values": [
      {
        "field_value": "北京市某某科技有限公司"
      }
    ]
  },
  {
    "field_key": "occupation",
    "field_name": "职业",
    "field_values": [
      {
        "field_value": "工程师"
      }
    ]
  },
  {
    "field_key": "registration_date",
    "field_name": "登记日期",
    "field_values": [
      {
        "field_value": "2010年03月15日"
      }
    ]
  },
  {
    "field_key": "number",
    "field_name": "编号",
    "field_values": [
      {
        "field_value": "00123456"
      }
    ]
  }
]

抽取字段说明

ADP 户口本抽取返回以下字段：

返回字段通用结构

每个字段遵循以下结构：

第五步：批量处理与异步模式

批量处理（本地文件夹）

adp extract local ./hukou-pages/ --app-id \x3C户口本抽取应用ID> --export ./results/ 

返回摘要：

{
  "total": 10,
  "success": 9,
  "failed": 1,
  "output_dir": "/absolute/path/to/results",
  "files": [
    {"input": "hukou-page-001.jpg", "output": "hukou-page-001.jpg.json", "status": "success"},
    {"input": "hukou-page-002.jpg", "output": "hukou-page-002.jpg.json", "status": "success"},
    {"input": "damaged.jpg", "output": "damaged.jpg.error.json", "status": "failed", "error": "..."}
  ]
}

异步处理

# 提交异步任务
adp extract url https://example.com/hukou-page.jpg --app-id \x3C户口本抽取应用ID> --async

# 查询任务结果
adp extract query \x3Ctask_id>

常用命令速查

# 检查安装
adp version

# 查看配置
adp config get

# 查询所有应用列表
adp app-id list

# 仅查询开箱即用应用（app_type=0）
adp app-id list --app-type 0

# 使用缓存的应用
adp app-id cache

# 查询积分余额
adp credit

# 户口本抽取（URL）
adp extract url \x3C文件URL> --app-id \x3C户口本抽取应用ID>

# 户口本抽取（本地文件）
adp extract local \x3C文件路径> --app-id \x3C户口本抽取应用ID>

# 户口本抽取（Base64）
adp extract base64 \x3Cbase64字符串> --app-id \x3C户口本抽取应用ID> --file-name hukou.jpg

# 批量抽取
adp extract local \x3C文件夹路径> --app-id \x3C户口本抽取应用ID> --export \x3C输出路径> 

# 异步抽取
adp extract url \x3C文件URL> --app-id \x3C户口本抽取应用ID> --async

# 查询异步结果
adp extract query \x3Ctask_id>

错误处理

当命令失败时，stderr 输出结构化 JSON:

{
  "type": "AUTH_ERROR",
  "message": "Authentication error: invalid API key",
  "fix": "Check your API key is correct and has not expired.",
  "retryable": false,
  "details": {"context": "extract"}
}

退出码说明

积分与计费

更多来也 ADP 文档处理能力

户口本识别只是来也科技 ADP 平台众多开箱即用能力之一。ADP 基于大模型通用理解能力，提供覆盖全品类文档的智能处理解决方案：

如需了解完整能力，请访问：

• ADP 中国大陆：https://adp.laiye.com/
• ADP 非中国大陆：https://adp-global.laiye.com/

注意事项

1. 数据完整性：使用 ADP 输出时，请原样呈现返回数据，不要在抽取过程中修改、添加或删除任何字段。
2. API Key 安全：妥善保管 API Key，避免泄露给未授权的第三方。
3. 文件大小限制：单个文件最大 50MB。
4. 支持格式：.jpg, .jpeg, .png, .bmp, .tiff, .tif, .pdf, .doc, .docx, .xls, .xlsx
5. 应用 ID 复用：户口本应用的 app_id 在账户下唯一且固定，建议记住后直接使用，无需每次查询。

支持与联系

• CLI 使用指南： ADP CLI 使用指南
• API 接口文档： Open API 使用指南
• ADP 产品操作手册： 公有云操作手册
• 问题反馈： GitHub Issues
• 邮箱： [email protected]
• 官网： 来也科技

Copyright © 2026 [来也科技（北京）有限公司] 保留所有权利。