MinerU Document Extractor Skill

基于官方开源客户端 mineru-open-api 封装的 Agent Skill， 用于把 PDF、扫描件、图片、Word、PPT、Excel 和网页转换为干净的 Markdown / HTML / LaTeX / DOCX，并具备表格识别、公式识别、OCR 与批量处理能力。

特性

• 两种提取模式：flash-extract（免 token，快，仅 Markdown，≤10 MB / 20 页）与 extract（需 token，支持多格式 / VLM / 批量，≤200 MB / 600 页）。
• 多格式输出：md / json / html / latex / docx。
• 多语言：80+ 语言，含中文、英文、日文、韩文、阿拉伯文等（见 SKILL.md 的 --language 表）。
• 备用 key 自动轮换：每日每个 token 约 1000 页高优先级配额，mineru-run 会在配额/鉴权失败时自动切换到下一个 key。

目录结构

.
├── SKILL.md              # 主入口：触发条件、工作流、参数、语言表、多 key 说明
├── bin/
│   ├── mineru-run        # 多 key 自动轮换封装（extract / crawl）
│   └── mineru-key        # 安全地管理 token 列表（add / list）
└── README.md

安装

先安装官方 CLI（二选一）：

npm install -g mineru-open-api
# 或
go install github.com/opendatalab/MinerU-Ecosystem/cli/mineru-open-api@latest

然后安装本 skill 的辅助脚本：

ln -sf "$PWD/bin/mineru-run" ~/.local/bin/mineru-run
ln -sf "$PWD/bin/mineru-key" ~/.local/bin/mineru-key

使用

快速提取（免 token）

mineru-open-api flash-extract report.pdf

精确提取（需 token）

mineru-open-api auth            # 首次配置 token
mineru-open-api extract report.pdf -o ./out/ -f md,docx

多 key 自动轮换

把 token 追加到 ~/.mineru/keys（每行一个，首行为主 key），然后：

mineru-key add                  # 安全追加（隐藏输入）
mineru-run extract report.pdf -o ./out/   # 配额耗尽时自动切换下一个 key

认证与安全

• token 解析优先级：--token > MINERU_TOKEN 环境变量 > ~/.mineru/config.yaml。
• mineru-key add 使用隐藏输入，避免 token 落入 shell 历史。
• 文档内容发送到 MinerU API（mineru.net）进行服务端提取，处理完成后不留存。

完整 CLI 参考：https://github.com/opendatalab/MinerU-Ecosystem/tree/main/cli