기능
- 입력 형식: PDF·DOCX·PPTX·XLSX·HTML·EPUB 및 이미지.
- 출력 형식: Markdown(기본)·HTML·LaTeX·DOCX·EPUB(README에 기재된 내보내기 대상 중 일부이며, README에 따르면 각 CLI/API는 그중 일부만 제공).
- OCR: 스캔 문서 및 이미지 PDF 처리.
- 페이지 간 표 병합: 여러 페이지에 걸친 표를 하나로 재구성.
- 바운딩박스: 블록 수준 좌표(인용에 활용 가능).
- GPU 자동 감지: NVIDIA/AMD/Intel/Apple Silicon; README에 따르면 대표적인 추론 워크로드에서 CPU 대비 약 2–3배 속도.
- 기본값은 로컬: 기본적으로 문서를 업로드하지 않으며, 원격 파싱은 명시적 설정이 필요합니다.
MinerU 설치
- 설치:
pip install mineru - 소스코드: github.com/opendatalab/MinerU (MinerU Open Source License).
데이터 흐름
- 기본적으로 파싱은 사용자의 컴퓨터에서 실행되며 문서는 업로드되지 않습니다. 원격 파싱에는 명시적 설정이 필요합니다. 로컬 파싱을 설정하려면 모델 다운로드가 필요할 수 있으며(README는 등급에 따라 약 0.8–3GB로 안내), 첫 설정에는 네트워크 연결이 필요합니다.
- 원격/클라우드 모드는 명시적 설정이 필요하며 기본값이 아닙니다.
- README에 따르면 Doclib 구성 요소에는 사용 및 진단 텔레메트리가 포함되어 있습니다(초기 활성화, 문서 내용·추출 텍스트·파일 이름·검색어는 제외).
mineru telemetry disable또는 Doclib 서버 환경의 MINERU_TELEMETRY_DISABLED=1로 끌 수 있습니다. - OpenDataLab GitHub 조직은 위치를 중국으로 표기합니다(GitHub 프로필). mineru.net의 호스팅 서비스는 하단에 개인정보 처리방침과 이용 약관 링크를 제공합니다. 기밀 문서를 원격 모드로 보내기 전에 읽어 보시기 바랍니다. 로컬 파싱은 문서를 업로드하지 않습니다.
라이선스 및 가격
- 라이선스: MinerU Open Source License — Apache 2.0을 기반으로 추가 조건을 더한 라이선스(표준 Apache-2.0이 아님). 사용자와 계열사의 월간 활성 사용자가 1억 명을 넘지 않고 월 총매출도 2,000만 달러(USD)를 넘지 않는 한 별도 라이선스 없이 상업 이용이 가능하며, MinerU 기반 온라인 서비스는 MinerU 사용 사실을 명확히 표시해야 하며, 위반 시 라이선스는 자동으로 종료됩니다. 상업 이용 전에 LICENSE.md를 읽어 보시기 바랍니다.
- 가격: 라이브러리는 무료로 내려받아 로컬에서 실행할 수 있으며, mineru.net의 호스팅 서비스와 원격 API의 가격 및 사용 한도는 평가하지 않았습니다.
- 위의 기준치는 LICENSE.md에서 가져온 것이며, 이 문서는 모델 가중치를 언급하지 않습니다. 설정 시 내려받는 모델에는 별도 라이선스가 적용될 수 있으므로 상업 배포 전에 확인하시기 바랍니다.
경쟁 도구 및 대안
- Docling — MIT 라이선스; IBM Research Zurich에서 시작, LF AI & Data Foundation이 호스팅; MCP는 별도 패키지 docling-mcp로 제공.
- Marker — 코드는 Apache 2.0, 모델 가중치는 상업적 제한이 있는 수정된 AI Pubs Open RAIL-M 라이선스(상업 이용 전 확인); Surya OCR; Markdown·JSON.
- Unstructured — Python ETL; 이메일 포함 광범위한 형식 지원.
- OpenDataLoader PDF — PDF 전용 파서, Python·Node.js·Java SDK; 바운딩박스 포함 JSON, Markdown, HTML 출력.
자주 묻는 질문
MinerU는 상업 이용이 무료인가요?
대체로 그렇습니다. MinerU는 MinerU Open Source License(Apache 2.0+추가 조건)를 사용합니다. 사용자와 계열사의 월간 활성 사용자가 1억 명을 넘지 않고 월 총매출도 2,000만 달러(USD)를 넘지 않는 한 별도 라이선스 없이 상업 이용이 가능하며, MinerU 기반 온라인 서비스는 MinerU 사용 사실을 명확히 표시해야 합니다. GitHub의 LICENSE.md를 확인하세요.
MinerU와 Docling·Marker의 차이는?
MinerU의 README에는 LaTeX 출력과 페이지 간 표 병합이 기재되어 있습니다. 선택하기 전에 Docling과 Marker 문서에서 같은 기능이 있는지 확인하세요. Docling은 별도 패키지 docling-mcp로 MCP를 지원하고, Marker는 Surya OCR을 사용합니다.
MinerU에 GPU가 필요한가요?
아니요. CPU에서 동작하며, GPU는 NVIDIA/AMD/Intel/Apple Silicon에서 자동 감지됩니다. README는 대표적인 추론 워크로드에서 CPU 대비 약 2–3배 속도라고 밝히며, 실제 속도는 하드웨어와 문서 유형에 따라 다릅니다.
MinerU 설치 방법은?
Python 3.11–3.14 환경에서 pip install mineru 실행. 가상 환경 권장.
스캔 PDF를 처리할 수 있나요?
네. 모델 기반 OCR이 스캔 문서와 이미지 PDF를 처리합니다.
어떤 출력 형식을 지원하나요?
Markdown(기본)·HTML·LaTeX·DOCX·EPUB(README에 기재된 내보내기 대상 중 일부이며, README에 따르면 각 CLI/API는 그중 일부만 제공).
MinerU에 MCP 서버가 있나요?
README에는 v4.2.2의 MCP 서버에 대한 설명이 없습니다. MCP 통합은 Docling(별도 패키지 docling-mcp)을 고려하세요.
MinerU를 개발하는 곳은?
OpenDataLab이 GitHub 저장소를 관리합니다.
페이지 간 표 병합이란?
여러 PDF 페이지에 걸친 표를 감지해 출력에서 하나의 표로 재구성합니다(README 기재).
현재 버전은?
v4.2.2, 2026년 11월 13일 릴리스(GitHub Releases). 2026년 11월 15일 확인.
출처
- github.com/opendatalab/MinerU (2026-11-15 조회).
- opendatalab.com (2026-11-15 조회).
