← Back to Skills Marketplace
sales-report-parser
by
zhoutianwang
· GitHub ↗
· v1.0.1
· MIT-0
243
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install sales-report-parser
Description
Extract sales data from report images using OCR with cnocr, parse JSON via MiniMax API, and convert results to Excel spreadsheets.
Usage Guidance
This skill appears to do what it says: run cnocr OCR locally then send OCR text and/or base64-encoded images to the MiniMax API to obtain structured JSON, and convert that JSON to Excel. Before installing/running: 1) Understand that image contents and extracted text will be transmitted to the MiniMax endpoint — do not upload sensitive or confidential reports unless you trust the service and its data-handling. 2) Run pip install -r requirements.txt in an isolated virtual environment to avoid dependency conflicts. 3) The script expects you to pass an API key on the command line; avoid putting keys in version-controlled files or shared shells. 4) Review minimax_langchain.py if you want to confirm logging/telemetry behavior; the hardcoded API_KEY is just a placeholder and not an active backdoor. If you need offline processing or stricter data controls, do not use the remote API steps and instead rely solely on local OCR output.
Capability Analysis
Type: OpenClaw Skill
Name: sales-report-parser
Version: 1.0.1
The skill bundle is a legitimate utility designed for parsing sales report images using OCR and LLM-based data extraction. The code uses standard libraries such as cnocr for text recognition, pandas for Excel generation, and LangChain for interfacing with the MiniMax API. There is no evidence of data exfiltration, malicious execution, or harmful prompt injection; the scripts strictly follow the functional requirements described in SKILL.md.
Capability Assessment
Purpose & Capability
Name/description (sales OCR → MiniMax JSON → Excel) match the included scripts. Required functionality (OCR via cnocr, LLM calls to MiniMax, JSON→Excel) is implemented and nothing in the code asks for unrelated capabilities or credentials.
Instruction Scope
SKILL.md instructs installing requirements and running the provided scripts; the runtime steps align with the code. Important note: images are base64-embedded and sent to the MiniMax API via the ChatOpenAI wrapper — both OCR text and image content will be transmitted to the remote service. The documentation does not prominently warn about uploading image contents to a third party.
Install Mechanism
There is no built-in install spec in the registry; SKILL.md recommends pip install -r requirements.txt. The requirements list standard packages (cnocr, langchain-openai, pandas, pillow, etc.). No arbitrary downloads from personal servers or URL shorteners are present in the code.
Credentials
The tool does not require hidden environment variables; API keys are supplied as CLI arguments (api_key). There is a hardcoded placeholder API_KEY = "自己的apk" in minimax_langchain.py (harmless placeholder). The only sensitive secret you must provide is the MiniMax API key — which is proportional to the stated purpose — but you should be aware that providing that key gives the script the ability to send your data to the remote API.
Persistence & Privilege
Skill is not always-enabled, does not request system-wide config paths, and does not modify other skills or system settings. It has no persistence privileges beyond running the scripts and writing output files (JSON/Excel) in the working directory.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install sales-report-parser - After installation, invoke the skill by name or use
/sales-report-parser - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added new script: scripts/minimax_langchain.py
- This script likely introduces MiniMax API integration using the LangChain framework.
v1.0.0
Initial release of sales-report-parser.
- Extracts data from sales report images using OCR (cnocr).
- Supports parsing OCR text to structured JSON via MiniMax API.
- Converts JSON data to Excel format.
- Includes batch extraction for processing multiple images at once.
- Command-line tools provided for each step with flexible parameters.
- Supports common sales report fields and provides usage examples.
Metadata
Frequently Asked Questions
What is sales-report-parser?
Extract sales data from report images using OCR with cnocr, parse JSON via MiniMax API, and convert results to Excel spreadsheets. It is an AI Agent Skill for Claude Code / OpenClaw, with 243 downloads so far.
How do I install sales-report-parser?
Run "/install sales-report-parser" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is sales-report-parser free?
Yes, sales-report-parser is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does sales-report-parser support?
sales-report-parser is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created sales-report-parser?
It is built and maintained by zhoutianwang (@zhoutianwang); the current version is v1.0.1.
More Skills