← Back to Skills Marketplace
alex-zxyz

Mineru Pdf Parser

by ZxYz · GitHub ↗ · v3.0.3 · MIT-0
cross-platform ✓ Security Clean
388
Downloads
1
Stars
1
Active Installs
5
Versions
Install in OpenClaw
/install mineru-pdf-parser
Description
使用 MinerU API 将 PDF 解析为 Markdown,支持公式、表格、OCR。提供本地文件和在线 URL 两种解析方式。触发条件:(1) 用户说"解析 PDF [路径]",(2) 用户说"将 PDF 转为 Markdown",(3) 在 paper-workflow 中自动调用。使用场景:学术论文解析...
Usage Guidance
This skill is coherent with its described purpose, but it will upload your PDF files and your MINERU_TOKEN to mineru.net. Only proceed if you trust MinerU's service and privacy policy. Before installing: (1) review the included mineru_api.py yourself (it is the active code that will run); (2) consider creating a scoped API token you can revoke; (3) verify where results are saved on disk (SKILL.md and code show slightly different defaults); and (4) avoid supplying highly sensitive documents unless you're comfortable they will be processed by an external service. If you need assurance, ask the publisher for a signed release or run the script in an isolated environment first.
Capability Analysis
Type: OpenClaw Skill Name: mineru-pdf-parser Version: 3.0.3 The skill is a legitimate integration for the MinerU PDF parsing service. It uses the `requests` library to upload files and retrieve Markdown results from `https://mineru.net`, with all actions aligning with the stated purpose in `SKILL.md`. The code in `mineru_api.py` is transparent, includes proper error handling, and stores results in a dedicated local directory (`~/.openclaw/MinerU_Results/`). While it requires an API token, the documentation explicitly warns the user about this requirement and the data transfer to the third-party service.
Capability Assessment
Purpose & Capability
Name and description match the code and SKILL.md: the package uploads local files or URLs to MinerU (https://mineru.net) and polls for parsed results. Required env var (MINERU_TOKEN) is appropriate for authenticating to MinerU. No unrelated services, binaries, or credentials are requested.
Instruction Scope
SKILL.md explicitly instructs setting MINERU_TOKEN and installing requests, and warns that the token and files will be sent to https://mineru.net — this is transparent and consistent with the code. Minor inconsistency: SKILL.md states parsed results are saved to ~/.openclaw/MinerU_Results/, but the visible download() implementation defaults to a local 'result' directory (the file also defines BASE_DIR = ~/.openclaw/MinerU_Results which may be used elsewhere in truncated code). This is a small documentation/code mismatch to be aware of.
Install Mechanism
No automated install spec is present (instruction-only), aside from recommending 'pip install requests'. No downloads from unknown URLs and no archive extraction into the system are performed by the skill itself. This is low-risk for install-time code execution.
Credentials
Only one environment variable (MINERU_TOKEN) is required and documented. That token is necessary for the MinerU API and the skill clearly documents that it will be sent to mineru.net. No other secrets or unrelated env vars are requested.
Persistence & Privilege
always is false and the skill does not request to modify other skills or system-wide configuration. It writes results to local disk (expected for a parser) but does not request elevated privileges or permanent platform presence.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install mineru-pdf-parser
  3. After installation, invoke the skill by name or use /mineru-pdf-parser
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.3
- 简化并拓展了描述,明确支持本地文件和在线 URL 两种解析方式 - 新增技能触发条件说明,包括用户命令触发和 paper-workflow 自动调用 - 新增典型使用场景说明(学术论文解析、文档提取、知识库构建) - 其他内容与上版一致,未涉及核心功能代码调整
v3.0.2
声明 MINERU_TOKEN 为必需环境变量;移除 __pycache__/.pyc;完善主页与描述
v3.0.1
添加安全警告说明
v3.0.0
默认引擎改为 vlm,修复 OSS 上传问题
v1.0.0
初始版本
Metadata
Slug mineru-pdf-parser
Version 3.0.3
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 5
Frequently Asked Questions

What is Mineru Pdf Parser?

使用 MinerU API 将 PDF 解析为 Markdown,支持公式、表格、OCR。提供本地文件和在线 URL 两种解析方式。触发条件:(1) 用户说"解析 PDF [路径]",(2) 用户说"将 PDF 转为 Markdown",(3) 在 paper-workflow 中自动调用。使用场景:学术论文解析... It is an AI Agent Skill for Claude Code / OpenClaw, with 388 downloads so far.

How do I install Mineru Pdf Parser?

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

Is Mineru Pdf Parser free?

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

Which platforms does Mineru Pdf Parser support?

Mineru Pdf Parser is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Mineru Pdf Parser?

It is built and maintained by ZxYz (@alex-zxyz); the current version is v3.0.3.

💬 Comments