← Back to Skills Marketplace
讯飞票据识别
by
Iflytek AIcloud
· GitHub ↗
· v1.0.0
· MIT-0
212
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install xfei-invoice
Description
Recognize and extract structured data from invoices, receipts, and bills using iFlytek OCR API (科大讯飞票据识别). Supports VAT invoices, taxi receipts, train ticket...
Usage Guidance
This skill appears to genuinely implement iFlytek invoice OCR, but the package metadata omitted the three required environment variables. Before installing: 1) Confirm the registry entry is updated to declare XFEI_APP_ID, XFEI_API_KEY, and XFEI_API_SECRET. 2) Only supply credentials that are scoped/minimal (use a dedicated/test account if possible). 3) Do not run the SKILL.md echo debug lines in a shared environment (they print secrets). 4) Test with non-sensitive images first and verify the endpoint (https://api.xf-yun.com/v1/private/sc45f0684) and your account limits/costs. 5) If you need stronger assurance, request the publisher to explain why metadata lacks env var declarations and to provide a homepage/source repository for review.
Capability Analysis
Type: OpenClaw Skill
Name: xfei-invoice
Version: 1.0.0
The skill is a functional OCR tool for Chinese invoices and receipts using the iFlytek (iFlytek) API. The Python script (scripts/invoice.py) uses standard libraries to perform HMAC-SHA256 signed requests to the legitimate iFlytek endpoint (api.xf-yun.com). While the SKILL.md includes troubleshooting instructions that suggest printing environment variables (XFEI_APP_ID, etc.) to verify configuration, this is presented as a standard debugging aid for the user and does not indicate malicious intent or hidden data exfiltration.
Capability Assessment
Purpose & Capability
The name/description, SKILL.md, and scripts/invoice.py all consistently implement iFlytek (讯飞) invoice OCR and call the documented API endpoint (api.xf-yun.com). However, the registry metadata shows no required environment variables while both the documentation and code require XFEI_APP_ID, XFEI_API_KEY, and XFEI_API_SECRET — a coherence mismatch that should be corrected.
Instruction Scope
SKILL.md instructs the user to run scripts/invoice.py and to set the three XFEI env vars. The runtime instructions and code only read the provided image file and the three credentials and make a POST to the iFlytek API; they do not access other system files or unrelated services. One minor caution: SKILL.md includes explicit echo commands to print environment variables for debugging, which could expose secrets if run in an unsafe/shared environment.
Install Mechanism
Instruction-only skill with no install spec and no external downloads. The included Python script uses only standard library modules; nothing will be written to disk beyond the normal runtime behavior.
Credentials
Requiring XFEI_APP_ID, XFEI_API_KEY, and XFEI_API_SECRET is proportionate to the stated purpose (signed API calls). The concern is that the registry metadata did not declare those required env vars; this omission can mislead users about what secrets they'll need to provide and trust the skill with.
Persistence & Privilege
The skill does not request always:true and does not attempt to modify other skills or system configuration. It runs as an on-demand script and uses environment variables for credentials.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install xfei-invoice - After installation, invoke the skill by name or use
/xfei-invoice - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of xfei-invoice: OCR-based invoice and receipt recognition using the iFlytek (科大讯飞) API.
- Supports extraction of structured data from multiple invoice types, including VAT invoices, taxi receipts, train tickets, toll invoices, medical bills, and bank receipts.
- Accepts common image formats (png, jpg, bmp, gif, tif, pdf) for recognition.
- Simple CLI tool (scripts/invoice.py) for processing images and retrieving results in human-readable or raw JSON formats.
- Authentication via environment variables for secure API access.
- Comprehensive troubleshooting guide and error code reference included for easy problem resolution.
Metadata
Frequently Asked Questions
What is 讯飞票据识别?
Recognize and extract structured data from invoices, receipts, and bills using iFlytek OCR API (科大讯飞票据识别). Supports VAT invoices, taxi receipts, train ticket... It is an AI Agent Skill for Claude Code / OpenClaw, with 212 downloads so far.
How do I install 讯飞票据识别?
Run "/install xfei-invoice" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 讯飞票据识别 free?
Yes, 讯飞票据识别 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 讯飞票据识别 support?
讯飞票据识别 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 讯飞票据识别?
It is built and maintained by Iflytek AIcloud (@qingzhe2020); the current version is v1.0.0.
More Skills