compdf-pdf-to-markdown について
エージェントやコンテンツチーム向けの PDF から Markdown への変換スキルで、ComPDF Server API を使った構造化 Markdown の生成リクエストを計画します。PDF から Markdown へのエンドポイントのみを扱い、編集、文書作成、研究のワークフローに適しています。
主な機能
- 01PDF を Markdown に変換
- 02PDF から Markdown へのエンドポイント限定
- 03公式 API 仕様に基づくリクエスト作成
- 04仕様に沿った同期・非同期処理
活用シーン
- 01PDF の内容をナレッジベースに取り込む
- 02開発者向け文書の整理
- 03研究資料を編集可能なテキストに変換
- 04公開用に PDF の内容を再利用
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ compdfkit/ compdf-skills --skill compdf-pdf-to-markdownインストール後、Claude Code で/compdf-pdf-to-markdownを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/endpoint-index.mdofficial-api-reference.md詳細
ComPDF PDF から Markdown への変換
概要
ComPDF PDF to Markdown は、AI エージェントやコンテンツチームが PDF ファイルを、読みやすく、編集、要約、公開しやすい構造化 Markdown に変換するのに役立ちます。ナレッジベースへの取り込み、開発者向けドキュメント、SEO コンテンツの再利用、調査ワークフローなど、容量の大きい PDF の代わりに軽量なテキストを活用できるあらゆるパイプラインに最適です。
このスキルを使用して、公式の ComPDF Server API エンドポイントを選択し、以下でサポートされている操作の正確なリクエスト計画を作成してください。
サポートされている操作
| 操作 | 公式ページまたはインデックスのセクション |
|---|---|
| PDF から Markdown への変換 | pdf-to-md |
範囲
Markdown のみを生成してください。他の 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 ファイルへの保存を確認してください。以降のリクエストでは、保存済みのキーが再利用されます。