AI Agent Hub
Back to plugins
🤖

xby-ocr-id-card

Model Inference Updated 2026.09.02

Run the following command in DeepSeek Harness:

dsh plugin install xby-skill/xby-ocr-id-card

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install xby-skill/xby-ocr-id-card in your terminal to install this ID card OCR plugin; the source code is hosted at https://github.com/xby-skill/xby-ocr-id-card .

About this plugin

Processing ID card images in a chat workflow typically means guessing which side is facing up, extracting each field by hand, and double-checking the ID number manually, a tedious and error-prone cycle. xby-ocr-id-card collapses that entire pipeline into a single call: hand it an image and get every field back in structured form right away.

Under the hood the plugin auto-detects the front and back of a Chinese ID card. From the front it extracts name, gender, ethnicity, date of birth, address, and the ID number; from the back it pulls the issuing authority and the validity period, then validates the ID number for format and checksum correctness. It accepts three input formats, image URL, BASE64 string, or local file path, so it plugs naturally into whatever pipeline you already have. The API key is set once through a chat command and persists across restarts, removing repetitive configuration.

The plugin is well-suited for developers who need to batch-process ID card images inside a conversational workflow, engineers building identity-verification or auto-fill pipelines, and anyone who simply wants to turn a photo of an ID card into clean, structured data with a single message.

Use Cases

  • Batch-processing ID card photos inside a conversational workflow to obtain structured fields
  • Automating the extraction step in an identity-verification or auto-fill pipeline
  • Converting an ID card image into name, gender, address, and number fields with a single call

Best For

  • Developers who need to process ID card images within a chat-based workflow
  • Engineers building identity-verification or auto-fill systems
  • Users who want to quickly turn ID card photos into clean, structured data