Paper Parser

Convert and extract content from .pdf using MinerU (mineru-open-api).

Install

npm install -g mineru-open-api
# or via Go (macOS/Linux):
go install github.com/opendatalab/MinerU-Ecosystem/cli/mineru-open-api@latest

Quick Start

# Parse academic paper (requires token)
mineru-open-api extract paper.pdf -o ./out/

# Use VLM for complex layouts
mineru-open-api extract paper.pdf --model vlm -o ./out/

# Extract from arXiv URL
mineru-open-api extract https://arxiv.org/pdf/2309.10918 -o ./out/

Authentication

Token required for extract and crawl:

mineru-open-api auth            # Interactive token setup
export MINERU_TOKEN="your-token" # Or via environment variable

Create token at: https://mineru.net/apiManage/token

Capabilities

• Supports local files and URLs
• Requires token (mineru-open-api auth or MINERU_TOKEN env)
• Supported input: .pdf
• Language hint with --language (default: ch, use en for English)
• Page range with --pages (where applicable)

Notes

• Academic papers benefit from --model vlm for better layout accuracy. Requires extract with token.
• Output goes to stdout by default; use -o to save to file
• Binary formats (docx) require -o flag (cannot stream to stdout)
• All progress/status messages go to stderr
• MinerU is an open-source project by OpenDataLab (Shanghai AI Lab): https://github.com/opendatalab/MinerU