コンテキストウィンドウが小さすぎてドキュメントが大きすぎる場合は、必要な部分だけを変換してください。GroupDocs.Markdown.Mcp は、Claude Desktop、Claude Code、Cursor、GitHub Copilot からローカルで選択したページやワークシートを Markdown に変換する AI エージェントを提供し、LLM が全体の本ではなく 1 つの章だけを読み取ります。

handbook.pdf のページ40から52をMarkdownに変換してください。

設定とトラブルシューティングを含むステップバイステップのバージョンはドキュメントにあります: ドキュメントの一部だけをMarkdownに変換する方法.

スコープ付き変換で何が節約できるか？

プロンプトに入力したすべての単語はモデル提供者によって読み取られ、課金され、他のすべての単語と注意を争います。長いドキュメントに関する質問のほとんどは、そのごく一部に関するものです。最初にすべてを変換し、モデルにほとんどを無視させるようにすると、質問ごとにドキュメント全体の費用がかかります。

節約効果は自分のドキュメントで簡単に測定できます。以下は実際の測定例とその方法です。このファイルは、ドキュメント内の本サーバーのライセンスページの Markdown ソースです。フロントマターの後で分割し、空白で区切られた単語、コードブロック、Hugo ショートコードマークアップを含めてカウントしました（ショートコードを除くと全ページは 810 語です）。表はセクションとページ全体の比率を示していますが、pages オプションはページを選択し、見出しを選択しないことに注意してください。

ページのセクション 語数
導入と3つのライセンスモード 167
評価モードの制限 93
ライセンスの適用 78
従量課金（使用量課金）ライセンス 366
アクティブなモードの確認 113
ライセンスの取得 27
全ページ 844

どのライセンスモードがアクティブかという質問は、113語のセクションだけで十分です。これはページ全体の約13％、つまり全体の約7.5倍短いことに相当します。カウントは語数で示していますが、トークン数はモデルのトークナイザーに依存するため、語数に比例します。測定していないトークン数は記載していません。このページは意図的に短くしています。あなたのハンドブックはもっと大きくなるでしょうし、比率は自分で計算してください。

方法 1: 直接指定できるページはどれですか？

ページが分かっている場合は、直接指定してください。convert_to_markdown の pages は、1 から始まる番号のカンマ区切りリスト（例: "40,41,42"）を受け取ります。パラメータに範囲指定構文はなく、エージェントが「40 to 52」をリストに展開します。pages を省略すると、ドキュメント全体が変換されます。

handbook.pdf のページ40から52をMarkdownに変換してください。

結果は保存された .md ファイルとインラインで返されるコンテンツです。長い出力はインラインで切り詰められ、保存されたファイルには全文が保持されます。

方法 2: 第3章だけを変換するには？

このツールには見出しスコープのオプションがないため、まず「第3章」をページ番号に変換する必要があります。2 つの小さなステップで行います。

handbook.pdf は何ページあり、タイトルは何ですか？

get_document_info は変換せずにファイルから情報を返します: pageCount、title、author、fileFormat、isEncrypted。また、パスワードが必要かどうかも早期に教えてくれます。次に、目次ページを変換して内容を読み取り、そこが示す範囲を問い合わせます。

例（抜粋）:

You:   How many pages does handbook.pdf have, and what is its title?
Agent: get_document_info -> pageCount: 212, title: "Operations Handbook".
You:   Convert pages 3 to 4 (the table of contents), then convert chapter 3.
Agent: convert_to_markdown (pages: "3,4") -> contents read: chapter 3 runs pages 61 to 64.
       convert_to_markdown (pages: "61,62,63,64") -> saved chapter 3 as Markdown.

2 回の小さな変換が、1 回の大規模な変換に置き換わります。

方法 3: ワークブックから1つのワークシートだけを取得するには？

XLSX、XLS、ODS ファイルでは、番号は印刷ページではなくワークシートを選択します。

model のワークシート2をMarkdownに変換してください。

これにより、同じワークブック内の他のシートを含めずに、1 つのテーブルだけがドキュメントに入ります。

スコープ付き変換は追加の手間に見合うのはいつですか？

  • コンテキスト。 LLM は質問に答える部分だけを受け取り、長いドキュメントはウィンドウ内に収まります。
  • 従量課金コスト。 従量課金ライセンスでは処理した分だけ課金されるため、ページ数が少ないほど請求額が低くなります。
  • 検索品質。 関連する付録だけを保持したインデックスは、毎回のクエリでバックカタログ全体に希釈されません。

正直な制限: 評価モードでのページ数

ライセンスがない場合、サーバーは評価モードで動作します：最初の 3 ページのみが処理され、各ページに評価用の透かしが付加されます。これにより pages が上書きされます。評価モードでページ40から52を要求すると、エラーなくページ1から3が返されるため、書籍の途中の章を無許可でテストすることはできません。出力が期待した場所から始まらない場合は、まず get_license_status を呼び出してください。

目次は印刷ページラベルを使用できます。変換されたページが期待した見出しから始まらない場合は、エージェントに隣接するページを変換させ、リストを調整してください。get_document_info は総ページ数を返すので、リストの上限を把握できます。

よくある質問

第3章だけをMarkdownに変換するには？

まず章のページ番号を特定し、pages に渡してください。エージェントに目次ページを変換させて内容を読み取り、示された範囲を要求します。

コンテキストウィンドウが小さすぎてドキュメントが大きすぎる場合はどうすればいいですか？

ドキュメント全体ではなく、一部だけを変換してください。pages を使用して質問に答えるページやワークシートを選択し、開始前に get_document_info でページ数を確認します。

AIでPDFのページ10から20をMarkdownに変換できますか？

はい。シンプルに「report.pdf のページ10から20をMarkdownに変換してください」と尋ねれば、エージェントがページ番号の展開リストを送ります。ライセンスがない場合、最初の3ページのみが処理されます。

さらに詳しく