mcpField
D
docling

docling

github.com/docling-projectドキュメント69.8k42 回インストール1 日前に更新
リポジトリ

docling について

さまざまなファイルを読み取り、処理する開発者やユーザー向けのドキュメント変換スキルです。CLI、Python SDK、構造化抽出、チャンク化、サービス経由の変換を紹介し、Markdown または JSON に出力します。

主な機能

  1. 01多様なドキュメント形式の変換
  2. 02Markdown または構造化 JSON への出力
  3. 03CLI または Python SDK の利用
  4. 04型付きフィールドの抽出と文書のチャンク化
  5. 05サービス経由の変換

活用シーン

  1. 01シェルから PDF や URL を読み取る
  2. 02独自パイプラインで文書を一括変換する
  3. 03検索用の文書チャンクを準備する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/docling-project/docling --skill docling

インストール後、Claude Code で/doclingを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
cli.md
extraction.md
python-sdk.md
rag.md
service-client.md
slim-packaging.md

詳細

Docling

Docling は、PDF、DOCX、PPTX、XLSX、HTML、Markdown、AsciiDoc、CSV、画像、音声、XML などのドキュメントを、統一された単一の形式である DoclingDocument に変換します。Markdown（人が読みやすい形式）または JSON（構造化され、情報を損なわない形式）としてエクスポートできます。直接読み取れないファイル、特に PDF（スキャンされたものも含み、OCR または視覚言語モデルを使用）から内容を理解する必要がある場合は、Docling を利用してください。

まずは CLI で手早く実行

ドキュメントの内容を読むだけなら、CLI を実行してください。docling パッケージとともにインストールされ、ローカルパス または URL を指定できます。

docling report.pdf --to md --output /tmp/        # → /tmp/report.md
docling https://example.com/paper.pdf --to json --output /tmp/

出力ファイルには入力ファイルの名前が使われます（report.pdf → report.md）。デフォルトの出力先ディレクトリは現在のディレクトリです。「このファイルには何が書かれていますか」という依頼の大半には、これで対応できます。パイプライン（標準、VLM、ネイティブ）、OCR エンジン、表、スキャンされた PDF、パスワード、すべてのフラグについては references/cli.md を参照してください。

Docling の使い方を選ぶ

必要なこと…使用するものリファレンス
シェルからファイルを一度だけ読み取る／変換するCLI（docling …）references/cli.md
プログラムから変換する、パイプラインを調整する、バッチ処理する、ASR を使用する、画像や表をエクスポートするPython SDK（DocumentConverter + PipelineOptions）references/python-sdk.md
ドキュメント全体ではなく、特定の型付きフィールドを抽出するDocumentExtractor（構造化抽出、ベータ版）references/extraction.md
ドキュメントをチャンク化して検索に使う／RAG インデックスに取り込むチャンク化 + フレームワークローダーreferences/rag.md
変換をリモートサービスに委任する — 低レイテンシ、スケーラブル、ローカルの ML 依存関係や GPU が不要サービスクライアント（セルフホストまたはマネージドの docling-serve）references/service-client.md
実際に使う依存関係だけをインストールするdocling-slim の追加パッケージreferences/slim-packaging.md

目安：

  • ローカルで一度だけ、コードなし → CLI。
  • カスタムパイプライン、チャンク化、構造解析、アプリへの組み込み → Python SDK。
  • 大量のドキュメント、低レイテンシ、GPU／ML のインストール管理が不要、必要に応じてスケール → docling-serve エンドポイント（セルフホストまたはマネージドの Docling for IBM watsonx サービス）に接続するサービスクライアント。
  • インストールサイズを最小限にする／不要な torch や OCR エンジンの取得を避ける → 必要な追加パッケージを選択した docling-slim。

インストールせずに実行する（uvx）

CLI は、永続的にインストールせずに実行できます。

uvx --from docling docling report.pdf --to md --output /tmp/

出力に関するルール

  • 変換ステータスと（PDF の場合は）ページ数を必ず報告してください。
  • ユーザーが形式を指定していない場合は、Markdown（読みやすい形式）と JSON / DoclingDocument（構造化され、情報を損なわない形式）のどちらを希望するか確認してください。
  • 表については、表アイテムに対する export_to_markdown()／export_to_dataframe()（Python）を優先してください。references/python-sdk.md を参照してください。
  • 変換された PDF の内容がほとんどない、繰り返しが多い、または � だらけの場合、元ファイルがスキャン画像または複雑なレイアウトである可能性があります。OCR または --pipeline vlm で再試行してください（references/cli.md を参照）。

コメント

Markdown 対応