mcpField
Q
query

query

github.com/pspdfkit-labsドキュメント1884 回インストール2 週間前に更新
リポジトリ

query について

queryは、ローカルのMarkdownやテキストファイルから関連箇所を探すコマンドラインスキルです。文書調査向けで、繰り返し検索するファイルのインデックスを再利用できます。

主な機能

  1. 01関連箇所の順位付け検索
  2. 02該当行範囲の表示
  3. 03検索インデックスの再利用
  4. 04言語に応じた語形検索
  5. 05ローカルファイルの処理

活用シーン

  1. 01長い文書から特定の事実を探す
  2. 02正確な表現が不明な内容を検索する
  3. 03同じファイルに繰り返し質問する

インストール

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

$npx skills add https://github.com/pspdfkit-labs/nutrient-skills --skill query

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

同梱ファイルbin/query

詳細

エージェント向けルール

  • 用語が分かっている場合は、grep -n -i -C2 "term" file | head のような範囲を絞った検索から始めます。
  • 正確な表現が分からない場合や、通常の検索で一致が多すぎる場合は、query を使います。
  • 単一の事実を調べる場合は、-k 1 または -k 2 を使います。関連する語形も検索するには、--language <lang> を追加します。
  • 同じファイルに対して複数回クエリを実行する予定がある場合にのみ、--emit-index でインデックスを作成します。

ドキュメントを検索する

抽出した Markdown ファイルまたはテキストファイルを検索し、関連性の高い行範囲を返します。このコマンドはローカルファイルを読み込みます。PDF は解析しません。

関連するスキル

  • pdf-to-markdown — PDF を構造化された Markdown に変換します。
  • pdf-to-text — 列と間隔を保持しながら、PDF をプレーンテキストに変換します。

使い方

SKILL_DIR に、このファイルを含むディレクトリの絶対パスを設定します。以下のコマンドでは $SKILL_DIR/bin/query を使います。

ラッパーは初回使用時に Nutrient の CDN から CLI をダウンロードし、~/.local/share/nutrient/cli/ に保存します。6 時間ごとに更新を確認します。

$SKILL_DIR/bin/query text INPUT.md "your question" [-k N] [-e N]
  • INPUT.md — 抽出した Markdown ファイルまたはテキストファイル、あるいは保存済みのクエリインデックスです。
  • "your question" — 順位付けの対象となる語句です。必要に応じて、具体的な語句をいくつか含めます。
  • -k N — 結果ウィンドウの最大数です。既定値は 8 です。ほとんどの質問では 1～3 を使います。
  • -e N — 前後に含める行数です。既定値は 5 です。該当する行のみを返すには 0 を使います。

各結果は、1 始まりの Lines A-B 範囲で示されます。必要に応じて、この範囲を使って該当箇所を絞り込んで再度読み込みます。

インデックスを再利用する

同じファイルについて複数の質問をする予定がある場合は、インデックスを作成します。

$SKILL_DIR/bin/query text INPUT.md "first question" --emit-index INPUT.idx
$SKILL_DIR/bin/query text INPUT.idx "second question"

インデックスにはソースの行が含まれるため、以降のクエリではインデックスファイルだけを指定すればよくなります。

ワークフロー

  1. pdf-to-markdown または pdf-to-text を使って、PDF を一度変換します。
  2. -k の値を小さくして、焦点を絞ったクエリを 1 回実行します。
  3. 返された抜粋から回答します。必要な場合にのみ、より広い行範囲を読みます。
  4. 同じファイルに関する後続の質問には、インデックスを再利用します。

クエリのヒント

  • ドキュメントに記載されていそうな具体的な語句を使います。
  • 範囲を絞ったクエリを複数回実行するのではなく、関連する語句を 1 つのクエリに含めます。
  • 語形変化した表現も検索するには、--language en または別の ISO 言語コードを追加します。
  • コンテキストを増やすには -e の値を大きくします。個別の回答がいくつか予想される場合にのみ、-k の値を大きくします。

トラブルシューティング

  • No relevant matches found： より具体的な語句や同義語を試すか、--mode lenient を指定してください。このメッセージはドキュメントの内容ではありません。
  • 出力が空： 変換後のファイルにテキストが含まれていることを確認してください。query は OCR を実行しません。
  • 一致精度が低い： より珍しい語句を追加するか、--mode strict を使ってください。
  • 終了コードが 0 以外： stderr を確認し、具体的なエラーを報告してください。よくある原因は、入力ファイルが見つからないこと、または初回実行時のダウンロード失敗です。
  • 初回実行が遅い： ラッパーはプラットフォーム用バイナリを一度ダウンロードします。以降の実行ではキャッシュされたコピーを使います。

使用条件とライセンス

query は無料で使用できます。ローカルで実行され、アカウントは不要です。使用状況は報告されず、Vision ページも使用しません。

使用には、Nutrient PDF to Markdown License および Nutrient の Privacy Policy が適用されます。再配布、OEM、組み込み、およびホワイトラベルでの使用には、Nutrient との別途契約が必要です。

コメント

Markdown 対応