开源文档(PDF)解析神器MinerU的几种使用姿势大家好，我是小码，本文简单介绍下MinerU这个 #PDF文档解析 开源项目在实际使用中的几种方式： 在线API、Agent（Skills/MCP）、客户端、本地推理部署等。// MinerU Open API 的官方生态系统工具包https://github.com/opendatalab/MinerU-Ecosystem
#MinerU 这个项目在 #RAG知识库 类应用开发中是主流的文档处理组件，PDF解析质量比较好，能高准确率的提取表格、图表、图片、公式等元素，复杂排版也处理的较好。// GithubStars: 76.8khttps://github.com/opendatalab/mineru// 文档https://opendatalab.github.io/MinerU/// 在线体验、官网https://mineru.net/
其实在日常的 #Agent 办公中也很好用，不需要复杂的部署、安装，官方提供了丰富的Agent生态组件：Skills和MCP以及各种官方组件。在线API服务
1、精准解析 API
需填写token（API管理页面自定创建），支持单文件/批量、表格/公式/多格式输出，每天支持5000份PDF文件！最高页数支持单文件200页！最大文件大小200MB！支持最多200个文件批量解析！使用这个在线API服务我们可以很轻松的接入自己RAG知识库等应用系统，不用考虑安装部署这种麻烦事，而且5000个/日的数量，大部分场景都够用了。// 注意但我不确定5000个文件/日是大家都有还是有分级的，可以注册申请试试。
2、Agent 轻量解析API
免登录，IP 限频防滥用，专为 AI Agent 工作流设计。但是限制比较大：最大文件尺寸20MB、最高支持20页、只支持单文件解析。这个API主要是结合Agent的日常办公用途，除了防止滥用的考量，也有其设计思考：延迟、耗时等问题。毕竟在AI会话任务中解析一个200MB的文档可太耗时了。Agent中使用（Skill+Cli）
MinerU官方提供了#Skills技能包，这个技能主要是是使用cli命令和上面的轻量解析API完成PDF等文档的解析任务：// 官方skill https://github.com/opendatalab/MinerU-Ecosystem/tree/main/skills
你可以直接复制上面的链接给你的Agent应用，告诉它自行安装到合适的位置，主流Agent都会自行安装cli工具：mineru-open-api。轻量解析API默认免配置Token，Skill安装后就能直接使用，但是如果你需求较高、已经有了Token，则可以执行命令：mineru-open-api auth Interactive token setupexport MINERU_TOKEN="your-token" # Or set via environment variable
本地私有化部署推理服务
这是最复杂的模式，不是简单的安装CLI工具，而是本地私有化部署并对外提供文档解析API服务。这个场景其实也是我接触最多的场景，在部署模型推理服务的时候顺带就一起部署了。这类场景大多是企业需要私有化部署RAG知识库/Agent应用，MinerU作为比较重要的文档解析组件是必不可少的一部分（也可能是#PaddleOCR等其他的类似项目）。企业#私有化部署一般需要具备充足的算力支持、对数据敏感性有要求、甚至可能是无网环境。我一般使用官方Docker镜像或者根据客户需求定制镜像，使用vLLM部署推理服务，不展开说了，详情查看：// 本地部署推理 https://opendatalab.github.io/MinerU/quick_start/docker_deployment/
客户端
客户端支持Windows和苹果操作系统，应该支持上面说的精准解析API的功能。
客户端虽然安装较重，但是适合重度的资料管理需求的用户：// 演示视频地址 https://webpub.shlab.tech/dps/openxlabs/xlab-dataset/mineru-fe/mineru-seo-fe/mineru-seo-prod.40.ef930945/videos/client-home-video.mp4
在线使用
// 使用地址 https://mineru.net/OpenSourceTools/Extractor
适合轻量应用，临时有PDF要解析的场景，优点就是方便！最后
其实我主要是想写一下MinerU如何简单的在Agent客户端中应用，它不光是重型的RAG组件，日常办公中也可以轻量的使用，不需要算力、高性能的硬件。
MinerU官方还提供有各种SDK和集成。无论是在构建生产级流水线、集成#LangChain用于RAG，还是让AI代理能够即时解析文档，都能满足你的需求！
感谢阅读！
你的关注、点赞、转发、收藏是我持续更新的动力！
夜雨聆风
