← Back to Skills Marketplace
haxck

mineru-agent-free

by haxck · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
144
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install mineru-agent
Description
用 MinerU Agent 轻量解析 API 将 PDF/Word/PPT/Excel/图片解析为 Markdown,无需 Token,IP 限频。适用于文档解析、表格提取、OCR 识别。
Usage Guidance
This skill appears to do what it says: it uploads documents to mineru.net and returns Markdown. Before installing/using it, consider: (1) Privacy: any file you submit will be sent to mineru.net and then to the OSS URL the service provides—do not upload sensitive or confidential documents unless you trust MinerU and have reviewed its privacy policy. (2) Dependencies: ensure the runtime has Python 3 and the 'requests' package. (3) Test with non-sensitive files first to confirm behavior and confirm where uploaded files are stored (the service returns the upload URL). (4) Note the documented limits (10MB, 20 pages) and IP rate-limiting. If you need offline or self-hosted document parsing for sensitive data, prefer a local solution instead of this remote API.
Capability Analysis
Type: OpenClaw Skill Name: mineru-agent Version: 1.0.0 The skill is a legitimate document parsing tool that interfaces with the MinerU API (mineru.net) to convert various file formats (PDF, Word, PPT, etc.) to Markdown. The Python script (scripts/mineru_parse.py) implements standard file upload and polling logic using the requests library, and its behavior strictly aligns with the functionality described in SKILL.md. No evidence of malicious intent, obfuscation, or unauthorized data exfiltration was found.
Capability Assessment
Purpose & Capability
Name/description (document→Markdown parsing) matches the included code and SKILL.md. The Python script implements URL-based and file-upload-based parsing against https://mineru.net/api/v1/agent, which is exactly the stated purpose. Minor note: the script depends on Python and the 'requests' library, but the registry metadata did not explicitly declare these runtime dependencies.
Instruction Scope
Runtime instructions and the script are narrowly scoped to submitting documents (either by URL or uploading local files) to MinerU, polling for results, and returning Markdown. They do not attempt to read unrelated system files or environment variables. Important privacy implication: the instructions explicitly upload user files and download parsed Markdown from external URLs—expected for this purpose but potentially sensitive.
Install Mechanism
No install spec is provided (instruction-only plus a Python script). Nothing is downloaded from arbitrary URLs and no extract/install actions are defined. This lowers installation risk. The only operational requirement is that the agent environment has Python and the 'requests' package available.
Credentials
The skill requests no environment variables or credentials, which is proportionate. It does, however, transmit user files over the network to an external service (mineru.net) and to whatever OSS upload URL the service returns—this is necessary for the stated purpose but has privacy/egress implications.
Persistence & Privilege
The skill is not always-enabled and does not request persistent system privileges or modify other skills. It runs only when invoked (user-invocable/autonomous invocation allowed by default).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install mineru-agent
  3. After installation, invoke the skill by name or use /mineru-agent
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release with lightweight API for parsing documents to Markdown; no token required. - Added support for PDF, Word, PPT, Excel, and multiple image formats. - Introduced CLI utility script (`mineru_parse.py`) for both URL and local file parsing. - API features lightweight agent endpoint with IP rate limiting instead of token authentication. - Supports language selection, page range (PDF), and Markdown output. - Clearly documented usage, API flow, supported formats, and error codes.
Metadata
Slug mineru-agent
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is mineru-agent-free?

用 MinerU Agent 轻量解析 API 将 PDF/Word/PPT/Excel/图片解析为 Markdown,无需 Token,IP 限频。适用于文档解析、表格提取、OCR 识别。 It is an AI Agent Skill for Claude Code / OpenClaw, with 144 downloads so far.

How do I install mineru-agent-free?

Run "/install mineru-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is mineru-agent-free free?

Yes, mineru-agent-free is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does mineru-agent-free support?

mineru-agent-free is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created mineru-agent-free?

It is built and maintained by haxck (@haxck); the current version is v1.0.0.

💬 Comments