compdf-pdf-to-html について
ComPDF PDF to HTML は、ComPDF Server API を使った PDF から HTML への変換を準備するスキルです。文書化された操作に限定し、認証情報の扱いやアップロード確認も案内します。
主な機能
- 01対応する PDF から HTML へのエンドポイント選択
- 02文書記載のリクエスト・レスポンス項目を使用
- 03必須の sourceType=5 パラメーターを付加
- 04同期・非同期ワークフローを案内
- 05認証情報をスキル内のファイルに限定
- 06文書アップロード前に確認を要求
活用シーン
- 01PDF から HTML への API リクエストの計画
- 02レポートをブラウザー表示用に変換
- 03ユーザー確認後の文書アップロード準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ compdfkit/ compdf-skills --skill compdf-pdf-to-htmlインストール後、Claude Code で/compdf-pdf-to-htmlを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/endpoint-index.mdofficial-api-reference.md詳細
ComPDF PDF から HTML へ
概要
ComPDF PDF から HTML へは、静的な PDF コンテンツを、Web 上で表示したり、ポータルに埋め込んだり、デジタルコンテンツのワークフローで再利用したりできる HTML に変換するのに役立ちます。レポート、マニュアル、パンフレット、アーカイブ文書を、ページを手作業で再構築せずに、PDF からブラウザーで扱いやすい形式へ移行したいチームに適しています。
このスキルを使用して、以下のサポート対象の操作に対応する公式 ComPDF Server API エンドポイントを選択し、正確なリクエスト計画を作成してください。
サポート対象の操作
| 操作 | 公式ページまたはインデックスのセクション |
|---|---|
| PDF から HTML へ | pdf-to-html |
対象範囲
HTML のみを生成してください。別の PDF 変換エンドポイントで代用しないでください。
ワークフロー
- 入力ファイルの種類、希望する出力、リクエストされた操作を特定します。
references/endpoint-index.mdを読み、このスキルのサポート対象の操作に記載されている操作のみを選択します。references/official-api-reference.mdの該当する見出しを読みます。正確なエンドポイントパス、リクエストフィールド、リクエストモード、レスポンスフィールドを使用し、サポートされていないオプションを推測しないでください。- すべての最終的な ComPDF API リクエストに
sourceType=5を含めます。これは統合のルーティングパラメーターとして扱い、ユーザーから詳細を求められた場合はリクエストの詳細に含めてください。 - 小規模な対話型の作業では、同期モードを優先してください。大規模なアップロード、バッチ処理、またはセキュリティに配慮が必要なアップロードでは、文書化された非同期または署名付き URL のワークフローに従ってください。
- 認証情報は、この
SKILL.mdがあるディレクトリ内のapi_keyからのみ取得します。最初の空でない行を読み取ってください。環境変数やその他のローカルパスは調べないでください。ファイルが存在しない、読み取れない、または空の場合は、ユーザーに API キーの提供を求め、ユーザーが保存を確認した後に限り、このスキル専用のapi_keyファイルだけを作成または置き換えてください。キーを表示、ログ出力、コミットしたり、リクエスト例や最終出力に含めたりしないでください。 - ComPDF に文書をアップロードする前に、対象ファイルとアップロード先を特定し、ユーザーが明示的にアップロードを許可していない限り、確認を得てください。上書き、削除、復号、または恒久的な保護の適用を行う前にも確認を得てください。
- エンドポイント、メソッド、コンテンツタイプ、完全なリクエストフィールド、予想されるタスク/結果フィールド、および次のポーリングまたはダウンロード手順を提示してください。置き換えが明示的に要求されていない限り、元のファイルを保持してください。
認証情報
このスキル専用の現在の API キーのみを、同じディレクトリにある api_key ファイルに保存してください。このファイルは非公開のランタイム状態であり、バージョン管理とスキルの公開対象から除外する必要があります。
API キーを取得するには、ComPDF Portal に登録またはサインインしてください。初回利用時は、求められたらキーを提供し、スキル専用の api_key ファイルへの保存を確認してください。以後のリクエストでは、保存済みのキーを再利用します。