mineru

MinerU PDF Parser

PDF、Office（Word／PPT／Excel）、画像ファイルを、LaTeX 数式、表、画像、OCR を含むクリーンな Markdown に変換します。依存関係のないスクリプト 1 つ、2 つのバックエンド、自動ルーティングを備えています。

ゼロ設定ですぐに使う（トークン不要、インストール不要）

# Parse a local file or URL — the Agent API needs no login
python3 scripts/mineru.py paper.pdf

# Pipe the Markdown straight back to an agent
python3 scripts/mineru.py paper.pdf --stdout

# Machine-readable status for tool pipelines
python3 scripts/mineru.py paper.pdf --json

pip install も API キーも不要です。無料の Agent API では、10 MB 以下かつ 20 ページ以下のファイルを処理できます。

uv で実行する（インストール不要、Python を管理）

scripts/mineru.py には PEP 723 のインラインメタデータが含まれているため、uv から直接実行できます。venv も pip install も不要で、uv が管理するインタープリターを使用します。

uv run scripts/mineru.py paper.pdf --stdout       # zero-install run
uv run --no-project --with pytest pytest -q       # dev suite via uv

パワーモード（トークン）— 大容量ファイル、一括処理、追加形式

export MINERU_TOKEN="..."          # https://mineru.net/apiManage/token

# Parallel batch a directory, resume on re-run
python3 scripts/mineru.py ./pdfs/ --output ./out/ --workers 8 --resume

# Export DOCX/HTML/LaTeX alongside Markdown (auto-routes to the Standard API)
python3 scripts/mineru.py report.pdf --format docx --format latex

トークンを設定すると、ツールが自動でルーティングします。単一の小さなファイルは引き続き無料の Agent API を使用し、大容量（10 MB 超／20 ページ超）、一括処理、または追加のエクスポート形式が必要な場合は Standard API（200 MB 以下／200 ページ以下）を使用します。Agent API がサイズまたはページ数の上限に達した場合は、Standard API に自動的に切り替わります。

対応する形式

形式	拡張子	OCR
PDF	.pdf	--ocr
画像	.png .jpg .jpeg .jp2 .webp .gif .bmp	内蔵
Word	.doc .docx	—
スライド	.ppt .pptx	—
表計算シート	.xls .xlsx	—
HTML	.html（Standard API、MinerU-HTML モデル）	—

よく使うオプション

INPUT...          One or more files, a directory, or a URL
--output, -o      Output directory (default: ./output)
--api             auto | agent | standard   (default: auto)
--model           pipeline | vlm | MinerU-HTML  (default: vlm)
--format          docx | html | latex  (repeatable; forces Standard API)
--lang            OCR/document language (default: ch)
--ocr             Enable OCR for scanned documents
--pages           Page range, e.g. "1-10" or "2,4-6"
--workers, -w     Concurrent submit/upload/download slots (default: 8)
--resume          Skip inputs already parsed
--stdout          Print Markdown to stdout
--json            Print machine-readable status to stdout
--to SINK         Deliver into a content tool (repeatable); --list-sinks to enumerate
--obsidian PATH   Shortcut for --to obsidian with this vault
--engine          cloud | local | auto  (local/auto parse born-digital PDFs offline)
--split           Split oversized PDFs past the page caps, parse parts, merge (needs pypdf)
--chunk           Emit heading-aware RAG chunks (.chunks.json + --json)
--doctor          Environment self-check and exit

MCP サーバー

依存関係のない stdio JSON-RPC を使って MinerU を MCP 経由で公開し、MCP ホストから呼び出せるようにします。

python3 scripts/mineru_mcp.py

ツール：mineru_parse、mineru_parse_to（解析してシンクに配信）、mineru_list_sinks。

ツールへ配信する（--to）

一度解析し、それぞれの公式経路を通じてコンテンツツールに Markdown を送信します。

python3 scripts/mineru.py paper.pdf --to obsidian --to notion --to feishu

対象：obsidian logseq siyuan notion linear yuque coda slack feishu confluence onenote ticktick dingtalk airtable wecom（すべて依存関係不要）。また、オプションの追加機能を使って roam と wps にも対応します。各ツールは環境変数から設定を読み込みます（--list-sinks を実行してください）。対象ごとの認証、再現性、画像に関する注意事項については、references/integrations.md を参照してください。

出力

output/
└── document-name/
    ├── document-name.md    # clean Markdown
    └── images/             # extracted figures (Standard API)

パフォーマンス（実測値）

無料の Agent API を使った公式デモ PDF のエンドツーエンドのレイテンシー： コールド ≈ 14 秒 · ウォーム ≈ 13 秒（送信 → ポーリング → ダウンロード）。一括処理の速度は --workers に応じて拡大します。数値は tests/test_live.py のモックを使わない実環境ベンチマークに基づいています。

テスト

python3 -m pytest                      # fast unit suite (offline)
MINERU_LIVE=1 python3 -m pytest -m live -s   # real API + benchmark (no mocks)

API リファレンス

references/api_reference.md を参照してください。公式ドキュメント： https://mineru.net/apiManage/docs · トークン：https://mineru.net/apiManage/token