HTML OCR
Use OCR to extract text from HTML files that contain scanned images or image-embedded content using MinerU.
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
# OCR extraction from local HTML file (requires token)
mineru-open-api extract page.html --ocr -o ./out/
# With VLM model for better accuracy
mineru-open-api extract page.html --ocr --model vlm -o ./out/
Authentication
Token required:
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
- Supported input: local .html file
- OCR requires
extractwith token — not available inflash-extract - Use
--ocrflag to enable OCR on image-embedded content in HTML - Use
--model vlmfor complex or mixed-content pages
Notes
- HTML is NOT supported by
flash-extract; useextractwith token - If the HTML has normal text content, OCR is not needed — use
html-extractinstead - Output goes to stdout by default; use
-o <dir>to save to a file or directory - All progress/status messages go to stderr; document content goes to stdout
- MinerU is open-source by OpenDataLab (Shanghai AI Lab): https://github.com/opendatalab/MinerU
Scan to join WeChat group