Claude Code에서 MinerU로 문서를 변환하기

Install

npx skills add tanis90/pdf-converter-mineru

누구에게 맞나

이미 Claude Code에서 로컬 문서를 다루며 PDF, 이미지, Office 문서를 편집 가능한 텍스트로 바꾸고 싶다면 이 스킬이 맞습니다. 공식은 MinerU 생태계 기반 Claude Code 스킬로 PDF와 다른 문서를 변환한다고 씁니다. MinerU 페이지는

https://mineru.net/

출력 형식은 Markdown, Word, HTML, LaTeX 또는 평문으로 적혀 있습니다. 지목된 환경은 Claude Code: 변환이나 문서 추출을 요청하면 Claude가 mineru-open-api를 자동 호출합니다. 페이지는 다른 에이전트 설치 명령을 적지 않았고 지원 면을 배타 명단으로 쓰지도 않았습니다.

더 맞는 사람은 로컬 변환해도 되는 PDF나 사무 파일이 있고 먼저 기본 flash-extract 결과를 보고 싶은 사람입니다. 처음부터 완전한 extract를 하지 마세요. 공식 설명은

https://github.com/tanis90/pdf-converter-mineru

3분 만에 첫 시도

공식 설치 경로는 이 한 줄만 사용하세요:

npx skills add tanis90/pdf-converter-mineru

전제: 로컬에서 Claude Code를 열 수 있고 로컬 PDF나 사무 문서가 준비되어 있어야 합니다. 설치는 위 명령으로 끝나며 페이지는 두 번째 설치기를 주지 않습니다.

첫 작업은 낮은 위험 변환을 고르세요. 먼저 Claude와 원본 경로, 대상 형식(먼저 Markdown 또는 평문), 결과를 쓸 위치를 확인한 뒤 동의한 다음에 변환하게 하세요. 기본 모드는 flash-extract이며 먼저 인증할 필요는 없습니다. 변환은 새 파일을 쓰고 외부 호출이기도 합니다. 경로를 확인한 뒤 실행하세요.

성공 신호: 스킬이 설치된 뒤 Claude가 mineru-open-api를 자동으로 쓰고 열 수 있는 Markdown 또는 평문을 만들며 「미설치」를 말하지 않습니다. mineru-open-api auth를 하려 하면 먼저 멈추고 extract 모드를 잠금 해제하려는 것인지 확인하세요. 첫 시도의 필수 단계가 아닙니다.

사용 사례

사례 1: 기본 flash-extract로 PDF를 Markdown으로 변환.

공식은 PDF를 Markdown으로 바꿀 수 있고 기본은 flash-extract라고 합니다. 첫 번째는 아는 PDF 하나만 변환하고 제목과 문단이 남는지 대조하세요. 페이지는 머리말·바닥글, 스캔본, 암호화 PDF가 어떻게 되는지, flash-extract와 extract의 품질 차이도 적지 않았습니다. 확인할 수 있는 것은 기본 모드 이름과 Claude가 mineru-open-api를 자동 호출한다는 점뿐입니다.

사례 2: 먼저 인증한 뒤 이미지나 Office 문서에 extract.

공식은 mineru-open-api auth를 실행해야 extract 모드가 잠금 해제되며 변환 범위는 이미지와 Office 문서를 포함하고 대상은 여전히 Markdown, Word, HTML, LaTeX 또는 평문일 수 있다고 합니다. 먼저 인증만 돌리고 잠금 해제 성공을 본 뒤 이미지나 사무 파일을 고르세요. 인증은 로컬 자격 증명을 바꿉니다. 명령 창이 mineru-open-api auth에서 왔는지 확인한 뒤 계속하세요. 페이지는 인증에 채울 필드나 extract의 추가 스위치도 적지 않았습니다.

두 사례 모두 같은 npx 설치 명령 위에 있습니다. 첫 시도에서 다른 설치 방식을 병렬로 시도하지 마세요.

사용 경계

복사 가능한 공식 설치 명령은 npx skills add tanis90/pdf-converter-mineru뿐입니다. 기본은 항상 flash-extract입니다. extract를 하려면 먼저 mineru-open-api auth를 성공해야 합니다. 페이지는 인증을 첫 변환의 전제로 쓰지 않았고 Claude를 건너뛰고 독립 변환기로 쓸 수 있다고도 하지 않았습니다.

능력은 PDF, 이미지, Office에서 다섯 가지 텍스트 또는 문서 형식까지이지만 파일 크기, 페이지 수, 언어 범위는 없습니다. 변환은 새 파일을 쓰므로 경로를 먼저 확인하세요. MinerU는 하위 생태계로 쓰이며 세부는