Parse and read research papers or other document PDFs with MinerU over HTTP APIs using Python requests. Use when Codex needs a reliable paper-reading workflow for local PDFs or PDF URLs, and should choose between fast no-auth Markdown extraction (`flash`) and token-based high-precision extraction (`precision`) with richer layout/assets.
Use this skill to turn paper PDFs into readable Markdown with MinerU's HTTP APIs.
Prefer flash when the goal is quick reading or summarization. Prefer precision when the paper has complex layout, formulas, tables, or figures that should be preserved more faithfully.
flash for a fast first pass, quick literature reading, and no-token workflows.precision when the paper is important enough to justify a token and asynchronous polling.flash for local files up to 10 MB and 20 pages.precision for larger PDFs, scanned documents, or when the user wants the zip bundle with full.md, JSON, and assets.flash or precision.scripts/.precisionfull.mdscripts/mineru_flash_extract.py
Use for no-auth parsing of a local PDF or PDF URL. Saves Markdown directly.scripts/mineru_precision_extract.py
Use for token-based parsing of a local PDF or PDF URL. Polls until done, downloads the result zip, and extracts it. It reads the token in this order: --token -> MINERU_API_TOKEN -> saved local token file.scripts/mineru_token_manager.py
Use to save, inspect, or clear the MinerU token used by precision mode.Both scripts require requests in the Python environment.
python scripts/mineru_flash_extract.py --input "C:\path\paper.pdf" --output-dir .\out
python scripts/mineru_flash_extract.py --input "https://example.com/paper.pdf" --output-dir .\out
python scripts/mineru_token_manager.py save --token "YOUR_TOKEN"
python scripts/mineru_precision_extract.py --input "C:\path\paper.pdf" --output-dir .\out
python scripts/mineru_token_manager.py save --token "YOUR_TOKEN"
python scripts/mineru_precision_extract.py --input "https://example.com/paper.pdf" --output-dir .\out --model vlm
python scripts/mineru_token_manager.py status
python scripts/mineru_token_manager.py clear
method, experiment, ablation, kernel, or appendix.flash loses too much structure, rerun with precision.precision requires a MinerU token.scripts/mineru_token_manager.py save, then continue.~/.codex/state/mineru-paper-reader/token.json.flash does not require a token but has tighter size/page limits.references/api-modes.md.