xfyun-invoice

Extract structured fields from Chinese invoice and receipt images via the xfyun OCR API.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Jaykaijack/openclaw-backup --skill xfyun-invoice
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xfyun-invoice
Source: https://github.com/Jaykaijack/openclaw-backup/tree/main/skills/xfyun-invoice
Command: npx skills add https://github.com/Jaykaijack/openclaw-backup --skill xfyun-invoice

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Scanning and manually transcribing invoices and receipts is slow, error-prone, and difficult to scale; this Skill converts photos or scanned documents into structured data to automate expense reporting, bookkeeping, and recordkeeping.

Core Features & Use Cases

  • OCR-based recognition for a wide range of Chinese invoice and receipt types including VAT invoices, taxi receipts, train tickets, toll invoices, medical bills, and bank receipts.
  • Outputs either a human-readable, formatted summary of extracted fields or the raw API JSON for downstream processing; supports common image formats and PDFs.
  • Use cases include automating expense reports, extracting vendor/date/amount fields for accounting systems, and digitizing paper archives.

Quick Start

Run the included invoice recognition script on an image while ensuring XFYUN_APP_ID, XFYUN_API_KEY, and XFYUN_API_SECRET environment variables are set.

Frequently Asked Questions about xfyun-invoice

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract structured data from Chinese VAT invoices and receipt images?

To extract structured data from Chinese VAT invoices and receipt images, use an OCR Skill that processes image files and returns formatted fields like vendor, date, and amount. It supports VAT invoices, taxi receipts, train tickets, and medical bills.

What do I need to configure before using the xfyun-invoice OCR script?

Before using the xfyun-invoice OCR script, you need a Python 3 runtime and must set three environment variables: XFYUN_APP_ID, XFYUN_API_KEY, and XFYUN_API_SECRET. These credentials authenticate HMAC-SHA256 requests to the iFlytek OCR API.

Can I use this OCR tool to digitize PDF invoices for accounting automation?

Yes, you can use this OCR tool to digitize PDF invoices for accounting automation. It supports common image formats and PDFs, outputting either a human-readable summary or raw API JSON for downstream bookkeeping and expense reporting systems.

What types of Chinese receipts and bills does the iFlytek OCR API recognize?

The iFlytek OCR API recognizes Chinese VAT invoices, taxi receipts, train tickets, toll invoices, medical bills, and bank receipts. This coverage allows you to automate expense reporting and document digitization across various document categories.

Does the invoice recognition script output raw JSON or formatted text?

The invoice recognition script outputs both raw API JSON and human-readable formatted text. You can choose the raw JSON for downstream processing in accounting systems or the formatted summary for direct expense automation and recordkeeping.