# Id Card Ocr

> 识别二代居民身份证正反面信息（姓名、性别、民族、出生、住址、证件号等），适用于实名认证、用户注册、身份验证场景

- Skill: `qq5855144/id-card-ocr` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add qq5855144/id-card-ocr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qq5855144/id-card-ocr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: qq5855144 (https://skillmd.com/u/qq5855144)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qq5855144/id-card-ocr

---


## 能力概述

调用百度 OCR 接口对二代居民身份证正反面进行结构化识别，返回 JSON 格式的文字识别结果。

- **Endpoint**：`POST https://app-bo4w33bsdqm9-api-k93RZBjP0zqa-gateway.appmiaoda.com/rest/2.0/ocr/v1/idcard`
- **Content-Type**：`application/x-www-form-urlencoded`
- **认证模式**：`platform_managed`（密钥由平台注入，客户端无需关心）
- Auth Header 为 `X-Gateway-Authorization: Bearer ${INTEGRATIONS_API_KEY}`（注意不是标准的 `Authorization`）。
- **Plugin ID**：`feccaf6c-9221-4532-b7e0-f95086eec01d`
- **支持平台**：Web、MiniProgram

### 正面识别结果示例

```json
{
  "log_id": "1559208562721579319",
  "image_status": "normal",
  "words_result": {
    "姓名":       { "words": "伍云龙" },
    "性别":       { "words": "男" },
    "民族":       { "words": "汉" },
    "出生":       { "words": "19990417" },
    "住址":       { "words": "南京市江宁区弘景大道3889号" },
    "公民身份号码": { "words": "330881199904173914" }
  },
  "words_result_num": 6
}
```

### 反面识别结果示例

```json
{
  "words_result": {
    "签发机关": { "words": "陆丰市公安局" },
    "签发日期": { "words": "20190606" },
    "失效日期": { "words": "20390711" }
  }
}
```

---

## 生成期用法（Agent 直接调用）

完整参数表、请求示例及生成期代码详见 [references/idcard-ocr-api.md](references/idcard-ocr-api.md)。

---

## 生成后用法（应用内通过 Edge Function 调用）

将 Edge Function 部署为 `id-card-ocr`，前端通过 `supabase.functions.invoke` 传入图片（base64 或 URL）和
`id_card_side`（正面 `front` / 反面 `back`），即可获得结构化 OCR 结果。

各平台的完整 Edge Function 代码和前端调用代码详见 [references/idcard-ocr-api.md](references/idcard-ocr-api.md)。

| 平台 | Edge Function 实现 | 前端调用方式 |
|------|--------------------|-------------|
| Web  | 返回 JSON，标准流程 | `supabase.functions.invoke` 或原生 `fetch` |
| MiniProgram | 返回 JSON，标准流程 | `supabase.functions.invoke` |