biaoshu-ai-git/tools/mineru-agent-demo

MinerU Agent 轻量解析 API Demo

这是一个完全独立的 MinerU Agent 轻量解析 API demo，不使用 Token，不读取 .env，不发送 Authorization 请求头。

能力

• 调用 POST https://mineru.net/api/v1/agent/parse/file 获取上传链接。
• 使用 PUT 上传本地文件。
• 轮询 GET https://mineru.net/api/v1/agent/parse/{task_id}。
• 下载 markdown_url 并保存 Markdown。

限制

• 无需 Token。
• 文件大小上限 10MB。
• PDF 页数上限 20 页。
• 可能触发 IP 限频。
• 轻量 API 只返回 Markdown 链接，不返回精准 API 的 zip 包。

安装

cd tools\mineru-agent-demo
npm install

单文件测试

npm run parse -- "..\测试文件\pdf-1.pdf" --out-dir ".\out"
npm run parse -- "..\测试文件\word-1.docx" --out-dir ".\out"

批量测试

npm run smoke -- "..\测试文件" --out-dir ".\out"

常用参数

npm run parse -- "..\测试文件\pdf-1.pdf" --out-dir ".\out" --timeout 300 --interval 3

• --language：默认 ch。
• --ocr：开启 OCR，默认关闭。
• --no-table：关闭表格识别。
• --no-formula：关闭公式识别。
• --page-range：Agent API 页码范围，例如 1-10，不支持逗号分隔。

输出

out/
  pdf-1.md
  pdf-1.raw.json
  pdf-1.error.txt
  summary.md
  summary.json