mcpField
N
nutrient-document-processing

nutrient-document-processing

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

nutrient-document-processing について

nutrient-document-processing は、Nutrient DWS を使った管理型ドキュメント処理を案内するスキルです。忠実性、コンプライアンス、複数段階の処理が重要なタスク向けに、製品を区別し、有料の外部送信前に承認を求めます。

主な機能

  1. 01用途に応じた DWS 製品の振り分け
  2. 02Processor 用の固定バージョン Python ヘルパー
  3. 03ドキュメント変換とページ操作
  4. 04OCR とテキスト・表の抽出
  5. 05外部処理前の承認ゲート
  6. 06段階的な墨消しと署名の安全対策

活用シーン

  1. 01ドキュメントファイルの変換や結合
  2. 02テキスト、表、キーと値の抽出
  3. 03PDF の墨消しや署名の準備
  4. 04複数段階のドキュメント処理

インストール

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

$npx skills add https://github.com/pspdfkit-labs/nutrient-agent-skill --skill nutrient-document-processing

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

同梱ファイル

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

.clawhubignore
LICENSE.txt
agents/
openai.yaml
assets/
nutrient.svg
assets/templates/
custom-workflow-template.py
references/
compliance-and-optimization.md
extraction-and-ocr.md
generation-and-conversion.md
pdf-manipulation.md
REFERENCE.md
request-basics.md
security-signing-and-forms.md
workflow-recipes.md
scripts/
add-pages.py
convert.py
delete-pages.py
duplicate-pages.py
extract-key-value-pairs.py
extract-table.py
extract-text.py
merge.py
ocr.py
optimize.py
password-protect.py
redact-ai.py
rotate.py
sign.py
split.py
watermark-text.py
scripts/lib/
common.py

詳細

Nutrient のドキュメント処理

忠実性、コンプライアンス、または複数ステップのワークフローを考慮すると、ユーザーのファイルを Nutrient DWS に送信するのが妥当な、管理されたドキュメント処理にはこのスキルを使用してください。

製品の選択

コストの見積もりや認証情報の選択を行う前に、使用する製品を選択してください。

ニーズ製品ここで使用する経路
変換、生成、組み立て、OCR、JSON コンテンツ抽出、墨消し、署名、最適化、PDF/A または PDF/UA 出力DWS ProcessorNUTRIENT_API_KEY を使用する scripts/ 内の固定バージョンの Python ヘルパー
Markdown または空間 JSON への高忠実度ドキュメント解析Data Extraction別の /extraction/parse 製品、認証情報、クレジットプールを使用します。現行の公式クライアント／ドキュメントに従ってください
アクセシビリティの自動タグ付けと PDF/UA 検証ワークフローAccessibility現行の独立した Accessibility API／製品を使用してください。非推奨の Processor /processor/pdfua エンドポイントは使用しないでください

Processor のコスト見積もり、認証情報、ペイロードを Data Extraction または Accessibility に流用しないでください。

セットアップ

  • https://dashboard.nutrient.io/sign_up/?product=processor から Processor API キーを取得します。

  • エージェントホストの保護された実行環境またはシークレットマネージャーを通じて NUTRIENT_API_KEY を設定します。ユーザーにキーをチャットへ貼り付けるよう求めないでください。また、コマンド引数、ログ、生成されたスクリプト、コミットする設定ファイルにキーを含めないでください。確認するのは変数が設定されていることだけとし、その値は確認しないでください。

  • 各スクリプトは nutrient-dws==3.1.0 に固定された PEP 723 メタデータを使用します。uv run で実行してください。

  • インストール済みスキルディレクトリ内のパスを指定してヘルパーを実行してください。カレントディレクトリがスキルディレクトリであると想定しないでください。

  • ページ範囲は 0 始まりで、終端を含みます。0:4 は 5 ページを意味します。負のインデックスは末尾から数えます。

有料実行の承認ゲート

ヘルパーを呼び出すたびに、ドキュメントの内容が外部の DWS Processor API に送信され、クレジットを消費します。実行前に、以下を行ってください。

  1. 実行する操作と、転送されるすべてのローカルファイルまたはリモート URL を特定します。
  2. ダッシュボード／該当する料金体系から、その操作の最新のクレジット見積もりを取得します。
  3. 製品、操作、転送する入力、見積もり、出力先として提案するパスをユーザーに提示します。
  4. リクエストを送信する直前に承認を得ます。
  5. 承認後に限り、--estimated-credits NUMBER と --confirm-external-processing の両方を指定します。

承認は、再試行、一括処理、第 2 段階、墨消しの適用、署名には引き継がれません。確認フラグを推測で追加しないでください。

ヘルパーの優先順位

  1. 対応する scripts/*.py ヘルパーを優先してください。固定バージョンの型付きクライアントと安全な出力ライターを使用します。
  2. 複数ステップの Processor ジョブでは、実行時に assets/templates/custom-workflow-template.py をコピーしてカスタマイズしてください。
  3. 現行の公式仕様が該当するリファレンスに記載されている場合に限り、直接リクエストを使用してください。正確な仕様が不確かな場合は、推測せず、型付きの 3.1.0 ヘルパーを使用してください。

すべての出力ヘルパーは、所有者のみがアクセスできる権限でファイルをアトミックに作成し、既存のパスへの上書きを拒否します。再試行には新しいパスを選択してください。

単一操作のヘルパー

  • convert.py：pdf、pdfa、pdfua、docx、xlsx、pptx、png、jpeg、jpg、webp、html、または markdown。バイナリ、テキストコンテンツ、JSON コンテンツの各結果に対応します。
  • merge.py、split.py、add-pages.py、delete-pages.py、duplicate-pages.py、rotate.py：ページおよびドキュメントパケットの操作。
  • ocr.py、extract-text.py、extract-table.py、extract-key-value-pairs.py：Processor OCR および JSON コンテンツ抽出。
  • watermark-text.py、optimize.py：出力用の変換。
  • redact-ai.py：ローカル PDF の AI によるステージングのみ。ステージング結果を目視で確認してから、別途承認を得たうえで適用してください。
  • sign.py：ローカル PDF のみを対象とします。signatureType を含む明示的な JSON 設定ファイルが必要で、出力が PDF コンテナーであることを検証します。埋め込まれた署名と信頼チェーンは、別途検証してください。
  • password-protect.py：パスワードは、所有者のみがアクセスできるローカルファイル（chmod 600）からのみ読み込みます。argv からは読み込みません。

複数ステップのワークフローテンプレート

ジョブ固有のパイプラインを scripts/ にコミットしないでください。テンプレートをタスク固有の一時パスにコピーしてから、インストール済みのスキルディレクトリを参照するように変更してください。

export NUTRIENT_SKILL_DIR="/absolute/path/to/nutrient-document-processing"
cp "$NUTRIENT_SKILL_DIR/assets/templates/custom-workflow-template.py" /tmp/ndp-workflow.py
# customize /tmp/ndp-workflow.py
NUTRIENT_SKILL_DIR="$NUTRIENT_SKILL_DIR" uv run /tmp/ndp-workflow.py --help

最後の有料呼び出しにも、操作の見積もりと明示的な確認フラグが必要です。ユーザーから保持するよう求められない限り、ジョブが完了したら一時スクリプトを削除してください。

安全ルール

  • ソースに有用なテキストレイヤーがない場合に限り、抽出または墨消しの前に OCR を実行してください。
  • 墨消しは 2 段階で行います。注釈を作成し、一致した箇所と見落とした箇所をすべて目視で確認してから、不可逆な適用について別途承認を求めてください。最終 PDF を検索・レンダリングして、削除を検証してください。
  • 署名には、明示的な CMS または CAdES の設定が必要です。署名する前に、入力、フラット化、墨消し、結合、最適化を行ってください。署名済み PDF は変更不可として扱ってください。
  • Instant JSON または XFDF で表現された、実際のフォームフィールドデータを使用してください。fillForm ビルドアクションを作り出さないでください。
  • パスワードや署名シークレットを argv、ログ、コミットする JSON に含めないでください。
  • PDF/A と PDF/UA はコンプライアンス目標として扱ってください。適合を主張する前に、最終成果物をユーザー指定のバリデーターで検証してください。
  • 新しい統合では、非推奨の /processor/pdfua エンドポイントを決して呼び出さないでください。

リファレンスマップ

  • references/request-basics.md：製品の範囲、認証、型付き出力、承認、エラー
  • references/generation-and-conversion.md：現在の変換および生成のパターン
  • references/pdf-manipulation.md：両端を含む範囲とページ操作
  • references/extraction-and-ocr.md：Processor の JSON コンテンツ抽出と Data Extraction の解析
  • references/security-signing-and-forms.md：段階的な墨消し、署名、フォーム、パスワード、透かし
  • references/compliance-and-optimization.md：PDF/A、PDF/UA のルーティング、最適化、検証
  • references/workflow-recipes.md：複数ステップのジョブを安全に進める手順

コメント

Markdown 対応