用 MinerU Agent 轻量解析 API 将 PDF/Word/PPT/Excel/图片解析为 Markdown，无需 Token，IP 限频。适用于文档解析、表格提取、OCR 识别。
📄 MinerU - 文档解析
功能概述
📄 MinerU - 文档解析是一项面向实际任务的技能，主要用于PDF/Word/PPT/Excel/图片 → 结构化 Markdown；🎯 触发条件；
核心要点
- 当用户要求解析文档、提取文档内容、OCR 识别、将文件转为 Markdown 时使用；
- 🔗 API 信息；
- Base URL: https://mineru.net/api/v1/agent；
使用与执行
认证方式: 无需 Token，IP 限频；文档: https://mineru.ne。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
📄 MinerU - 文档解析
PDF/Word/PPT/Excel/图片 → 结构化 Markdown
🎯 触发条件
当用户要求解析文档、提取文档内容、OCR 识别、将文件转为 Markdown 时使用。
🔗 API 信息
- Base URL:
https://mineru.net/api/v1/agent - 认证方式: 无需 Token，IP 限频
- 文档: https://mineru.net/apiManage/docs
📋 支持的文件类型
| 类型 | 格式 |
|---|---|
| 论文、书籍、扫描件 | |
| 📝 Word | .docx |
| 📊 PPT | .pptx |
| 📊 Excel | .xls, .xlsx |
| 🖼️ 图片 | .png, .jpg, .jpeg, .jp2, .webp, .gif, .bmp |
⚠️ 限制
| 限制项 | 限制值 |
|---|---|
| 文件大小 | 10 MB |
| 文件页数 | 20 页 |
🚀 使用方式
方式一：URL 解析（文件有公开 URL 时）
直接调用解析脚本：
python3 SKILL_DIR/scripts/mineru_parse.py --url "https://example.com/file.pdf"
可选参数：
--language ch|en（默认 ch）--page_range 1-10（仅 PDF 有效）--output /path/to/output.md（指定输出文件）
方式二：文件上传解析（本地文件）
python3 SKILL_DIR/scripts/mineru_parse.py --file /path/to/document.pdf
方式三：在对话中直接使用
用户发送文件或提供文件路径/URL 时，调用脚本解析，将结果返回给用户。
🔄 API 流程
URL 模式
POST /parse/url→ 获取 task_idGET /parse/{task_id}→ 轮询直到 done- 下载 markdown_url 返回结果
文件上传模式
POST /parse/file→ 获取 task_id + file_urlPUT file_url→ 上传文件到 OSSGET /parse/{task_id}→ 轮询直到 done- 下载 markdown_url 返回结果
❌ 错误码
| 错误码 | 说明 | 应对策略 |
|---|---|---|
| -30001 | 文件大小超出限制（10MB） | 拆分文件或告知用户 |
| -30002 | 不支持的文件类型 | 检查文件格式 |
| -30003 | 页数超出限制 | 指定 page_range 拆分 |
| -30004 | 请求参数错误 | 检查必填参数 |
💡 使用技巧
- 中文文档用
language: ch - 大文件指定
page_range分段解析 - Word/PPT 用 Office 原生 API 解析，速度最快
- 解析结果为 Markdown 格式，可直接用于后续处理
轻量快速，无需 Token！📄
相关专题
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。
2026.10.22
0
15
PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。
2026.10.22
0
12
热门下载
相关下载
精品课程
