← Back to Skills Marketplace
vietnam-invoice
by
liuwei19820201
· GitHub ↗
· v1.0.0
· MIT-0
84
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install vietnam-invoice
Description
越南发票验真 - 识别发票信息并通过越南税务 API 查验真伪
Usage Guidance
This skill implements the declared task, but be aware of several risks before installing/using it:
- Manifest mismatch: the registry lists no required env vars, but the SKILL.md and code require VL_API_KEY, CJY_USER, and CJY_PASS. Expect to set sensitive credentials for operation.
- Data leakage: the skill uploads full invoice images (base64) to an external VL/model endpoint and sends captcha images to a third‑party captcha solver (ChaoJiYing). If invoices contain PII or confidential tax numbers, those will be transmitted to those services. Only use with data you are comfortable sharing with those providers.
- Credential handling: CJY uses account+password (not an API token); avoid reusing high-privilege credentials. Prefer accounts with minimal privileges and rotate credentials if exposed.
- Environment/setup: the skill requires Playwright and an msedge browser install, plus PyMuPDF/Pillow — run in an isolated environment (container/VM) if possible.
- Trust & provenance: the skill's source/homepage is unknown. If you will process real invoices, request provenance from the author or prefer an officially supported tool. Review the code yourself (or have a trusted reviewer) before supplying credentials.
What would increase confidence: author/source verification, corrected registry metadata declaring required env vars, and explicit user-facing warnings that images and data are sent to the VL provider and ChaoJiYing (with option to disable external services or use local OCR).
Capability Analysis
Type: OpenClaw Skill
Name: vietnam-invoice
Version: 1.0.0
The skill is a legitimate tool for verifying Vietnamese invoices by extracting fields via a Vision-Language model (Alibaba Cloud Bailian) and querying the official Vietnamese tax portal (hoadondientu.gdt.gov.vn). It utilizes the Chaojiying service for captcha recognition and Playwright for rendering SVG captchas. While it disables SSL verification for requests and requires external API keys (CJY_USER, CJY_PASS, VL_API_KEY), these actions are consistent with its stated functionality, and no evidence of malicious intent, data exfiltration, or unauthorized execution was found in scripts/verify_vl.py or skill.md.
Capability Assessment
Purpose & Capability
The code (verify_vl.py + pdf_to_images.py) matches the stated purpose: it extracts invoice fields (via a VL model) and queries the Vietnam tax API. Requiring a VL API key and a captcha-solving account (CJY_USER/CJY_PASS) is coherent with that functionality. However, the skill registry metadata declares no required environment variables while the SKILL.md and code clearly require VL_API_KEY, CJY_USER, and CJY_PASS — this manifest mismatch is an incoherence.
Instruction Scope
Runtime instructions and code send full invoice images (base64 data URLs) to an external VL/model service and send captcha images to a third‑party captcha solving service (upload.chaojiying.net). The script also contacts the Vietnam tax endpoint (hoadondientu.gdt.gov.vn:30000). These operations may exfiltrate sensitive invoice data (including personal/company tax IDs) to external providers. The SKILL.md does instruct the user to set env vars, but does not explicitly warn that invoice images will be uploaded to these external services.
Install Mechanism
There is no package download or remote installer; dependencies are installed via pip and Playwright (msedge). requirements.txt lists standard PyPI packages. No arbitrary remote code downloads or obscure URLs are present in the install process.
Credentials
The code requires credentials named CJY_USER/CJY_PASS (captcha solver account) and VL_API_KEY (model API key), which are sensitive and are used to send image data to external services. While these credentials are functionally required, the registry metadata failed to declare them. Requiring a username/password (CJY) and an API key is proportional to the feature but increases privacy risk because invoice images and captcha images are transmitted off‑site.
Persistence & Privilege
The skill does not request persistent/always-on status and does not modify system-wide settings. It is user-invocable and runs only when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install vietnam-invoice - After installation, invoke the skill by name or use
/vietnam-invoice - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Vietnam Invoice Verification skill.
- Supports uploading PDF/PNG/JPG files to verify Vietnamese invoices.
- Integrates field extraction and authenticity verification using the VL API.
- Requires environment variables for Super Eagle (验证码识别) and 百炼 VL API.
- Clear user guidance on environment variable setup and dependency installation.
- Robust handling of image conversion, verification retries, and result explanations.
Metadata
Frequently Asked Questions
What is vietnam-invoice?
越南发票验真 - 识别发票信息并通过越南税务 API 查验真伪. It is an AI Agent Skill for Claude Code / OpenClaw, with 84 downloads so far.
How do I install vietnam-invoice?
Run "/install vietnam-invoice" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is vietnam-invoice free?
Yes, vietnam-invoice is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does vietnam-invoice support?
vietnam-invoice is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created vietnam-invoice?
It is built and maintained by liuwei19820201 (@liuwei19820201); the current version is v1.0.0.
More Skills