借助 MinerU 将 PDF、扫描件和 Office 文件解析为 Markdown

Nebutra/MinerU-Skill

借助 MinerU 将 PDF、扫描件和 Office 文件解析为 Markdown,支持 OCR、公式表格提取、批量处理及可选本地解析。

最近更新于:

查看 GitHub 项目
npx skills add Nebutra/MinerU-Skill
133Stars6Forks仓库最近推送

关于这个 Skill

通过 Python CLI 解析本地文件或公开文档 URL,并把 Markdown 返回给 Agent。默认云端路径使用 MinerU 服务;可选本地引擎用于支持的有文字层 PDF。仓库根入口与 Claude 插件入口描述同一个 mineru 工作流,不拆成重复商品。

为什么推荐

为 MinerU 增加面向 Agent 的命令行工作流,提供 Markdown 标准输出、结构化状态、批量续跑及明确的云端/本地模式。

适合用来做什么

  • 为后续文档工作流提取文字、表格与公式。
  • 批量处理文档文件夹,并跳过已完成的输入。
  • 直接向 Agent 返回 Markdown,或写入本地知识文件夹。

工作流程

选择处理路径

先判断输入需要云端 OCR,还是可以使用可选的本地文字 PDF 引擎。

解析并核对状态

使用 --stdout 输出 Markdown,或用 --json 取得结构化状态;重复批次可使用 --resume。

核对提取结果

复用 Markdown 前,将表格、公式和图片与原页面核对。

作者维护的 Skill 指令

安装与运行环境

先安装 Skill 指令,再按文档配置运行时依赖后执行任务。

命令用途与使用时机
python3 scripts/mineru.py paper.pdf --stdout将解析后的 Markdown 返回终端。
python3 scripts/mineru.py paper.pdf --json返回结构化解析状态。
python3 scripts/mineru.py --doctor检查本地环境和可选集成。

作者维护的 Skill 指令项目官方 README

适用范围与限制

这是围绕 MinerU 的第三方工作流,与已收录的 MinerU 引擎是不同项目;云端 OCR 和本地文字解析是两条执行路径。

作者维护的 Skill 指令项目官方 README

许可证与来源

项目采用 MIT 许可证;Agent 订阅、外部服务和可选集成另有各自要求。

MIT 许可证

使用前需要了解

  • 标准库 CLI 需要 Python 3.8+;本地解析、拆分及部分集成需要额外依赖。
  • 默认云端处理会把文档传给 MinerU;Token、配额和支持格式取决于服务及所选路径。
  • 免 Token 的 Agent 路径与使用 Token 的 Standard 路径限制不同,大批量任务前需核对当前服务条件。

支持的 Agent

Claude CodeCodex CLICursorHermes AgentGoogle Antigravity

资料与来源

原始资料见下方链接;文中的上手建议由 SkillHey 编辑整理。