📄 MinerU - 文档解析#

PDF/Word/PPT/Excel/图片 → 结构化 Markdown

🎯 触发条件#

当用户要求解析文档、提取文档内容、OCR 识别、将文件转为 Markdown 时使用。

🔗 API 信息#

• Base URL: https://mineru.net/api/v1/agent
• 认证方式: 无需 Token，IP 限频
• 文档: https://mineru.net/apiManage/docs

📋 支持的文件类型#

类型格式📕 PDF论文、书籍、扫描件📝 Word.docx📊 PPT.pptx📊 Excel.xls, .xlsx🖼️ 图片.png, .jpg, .jpeg, .jp2, .webp, .gif, .bmp

⚠️ 限制#

限制项限制值文件大小10 MB文件页数20 页

🚀 使用方式#

方式一：URL 解析（文件有公开 URL 时）#

直接调用解析脚本：

bash

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（指定输出文件）

方式二：文件上传解析（本地文件）#

bash

python3 SKILL_DIR/scripts/mineru_parse.py --file /path/to/document.pdf

方式三：在对话中直接使用#

用户发送文件或提供文件路径/URL 时，调用脚本解析，将结果返回给用户。

🔄 API 流程#

URL 模式#

1. POST /parse/url → 获取 task_id
2. GET /parse/{task_id} → 轮询直到 done
3. 下载 markdown_url 返回结果

文件上传模式#

1. POST /parse/file → 获取 task_id + file_url
2. PUT file_url → 上传文件到 OSS
3. GET /parse/{task_id} → 轮询直到 done
4. 下载 markdown_url 返回结果

❌ 错误码#

错误码说明应对策略-30001文件大小超出限制（10MB）拆分文件或告知用户-30002不支持的文件类型检查文件格式-30003页数超出限制指定 page_range 拆分-30004请求参数错误检查必填参数

💡 使用技巧#

1. 中文文档用 language: ch
2. 大文件指定 page_range 分段解析
3. Word/PPT 用 Office 原生 API 解析，速度最快
4. 解析结果为 Markdown 格式，可直接用于后续处理

---

轻量快速，无需 Token！📄