Claude Code で MinerU により文書を変換する

インストール

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分で初回トライ

公式導入経路はこの1本だけです：

npx skills add tanis90/pdf-converter-mineru

前提：ローカルで Claude Code を開け、ローカル PDF またはオフィス文書が用意できていること。導入は上のコマンドで、ページは2本目のインストーラを出していません。

初回は低リスク変換を選びます。先に Claude とソースパス、目標形式（まずは Markdown またはプレーンテキスト）、結果の書き先を確認し、うなずいてから変換させます。既定モードは flash-extract で、先に認証は不要です。変換は新ファイルを書き、外部呼び出しでもあります。パスを確認してから実行します。

成功の合図：スキル導入後、Claude が mineru-open-api を自動で使い、開ける Markdown またはプレーンテキストを出すこと。「未導入」と出ないこと。mineru-open-api auth を求められたら先に止め、extract モードを解錠したいのか確認します。それは初回に必須ではありません。

利用ケース

ケース 1：既定の flash-extract で PDF を Markdown にする。

公式は PDF を Markdown にでき、既定は flash-extract と書きます。初回は既知の PDF 1件だけ変換し、見出しと段落が残るかを照合します。ページはヘッダ・フッタ、スキャン、暗号化 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 から5種のテキストまたは文書形式までですが、ファイルサイズ、ページ数、言語範囲はありません。変換は新ファイルを書きます。パスを先に確認してください。MinerU は下層エコシステムと書かれ、詳細は