PDF · 오피스 문서 · 스캔본을 AI가 읽는 마크다운으로 바꾸는 오픈소스
MinerU
PDF 와 워드 · 파워포인트 · 엑셀, 스캔한 이미지를 마크다운이나 JSON 으로 바꿉니다. 표 · 수식 · 복잡한 배치가 있는 문서에 특히 쓸모 있다고 공식 스킬 파일이 밝힙니다. 클로드 코드에 mineru 스킬로 붙이면 긴 문서를 페이지 단위로 이어 읽고, 읽은 자리를 doc:…/page:…/block:… 위치로 남겨 출처를 짚습니다. 기본은 내 컴퓨터에서 읽고, 원격 처리는 직접 허락했을 때만 씁니다.
- 가격
- 무료 · 오픈소스
- 라이선스
- MinerU Open Source License (Apache 2.0 기반 + 추가 조건)
- GitHub 별
- 83,369 2026-11-10
공식 설치
npx --yes rebornstudio-mineru
저희 한국어 안내 스킬(mineru-ko)을 ~/.claude/skills 에 넣습니다. MinerU 본체나 공식 mineru 스킬을 대신 깔지 않습니다. 넣은 뒤 클로드 코드를 껐다 켭니다.
pip install uv
공식 README 의 첫 줄입니다. 파이썬 설치 도구 uv 를 받습니다.
uv venv .mineru --python 3.12
MinerU 전용 가상 환경을 만듭니다. 윈도우 PowerShell 은 .\.mineru\Scripts\Activate.ps1, 맥 · 리눅스는 source .mineru/bin/activate 로 켭니다.
uv pip install -U "mineru>=4.0,<5"
MinerU 4.x 를 설치합니다.
mineru-kit parse document.pdf -o document.md --tier standard
PDF 하나를 마크다운 파일로 바꿔 봅니다(README 예시).
npx skills add opendatalab/MinerU --skill mineru --global --yes
README 의 에이전트용 명령입니다. 공식 mineru 스킬을 전역 스킬 폴더에 넣어 클로드 코드가 문서를 읽을 때 MinerU 를 쓰게 합니다.
막히는 자리
- 파이썬 3.10 이하에서는 설치되지 않습니다. 3.11~3.14 가 필요하고 README 는 3.12 를 권합니다.
- 처음 standard · basic 품질로 읽을 때 모델 파일(약 0.8~2GB)을 내려받습니다. 메모리가 적으면 basic 을 씁니다(SKILL.md 표).
- 워드 · 엑셀 · 파워포인트 · HTML 은 flash 단계로 내 컴퓨터에서 읽습니다. 네 단계를 다 쓸 수 있는 건 PDF 와 이미지입니다.
- --remote 를 붙이면 문서를 공식 서비스로 보냅니다. 계약서 · 개인정보가 든 문서는 붙이지 않습니다.
- 명령이 server_not_running 으로 멈추면 mineru server start 를 먼저 칩니다(SKILL.md).