thumbnail-of-pptx

PPTX スライドのサムネイル

thumbnail_of_pptx.py スクリプトを実行して、OneDrive／Office プレゼンテーションのリンクからスライドのサムネイルを取得します。

uv run .agents/skills/thumbnail-of-pptx/thumbnail_of_pptx.py <url> <output_path>

引数

• url（必須）：OneDrive の共有リンク、または OneDrive の共有リンクにリダイレクトする aka.ms の短縮リンク（例：https://aka.ms/my-talk-slides）。リンクを開くと、Office Online／PowerPoint のウェブビューアーが表示される必要があります。
• output_path（必須）：PNG サムネイルの出力先パス（例：thumbnail.png）。必要に応じて親ディレクトリが作成されます。
• --slide N（任意）：取得するスライド番号（1 始まり）。デフォルトはタイトルスライドの 1 です。
• --scale N（任意）：画像をより鮮明にするデバイススケールファクター。デフォルトは 2 です。
• --wait MS（任意）：スクリーンショットを撮る前にスライドの描画を待つ時間（ミリ秒）。デフォルトは 9000 です。スライド数の多いデッキやネットワークが遅い場合は、値を大きくしてください。

出力

指定したスライドをスライドキャンバスに合わせて切り抜いた PNG 画像が 1 枚出力されます（おおよそ 16:9 で、PowerPoint ビューアーの UI は含まれません）。

前提条件

Playwright のブラウザーをインストールしておく必要があります。

uv run playwright install chromium

動作の仕組み

1. ヘッドレス Chromium を起動し、URL に移動します（aka.ms のリダイレクトをたどり、実際の OneDrive ビューアーを開きます）。
2. ネットワークがアイドル状態になるまで待機し、その後、Office Online ビューアーがスライドを読み込んで描画するまで一定時間待ちます。
3. ビューアーの iframe（名前が wacIframe のもの。見つからない場合は、<canvas> を含むフレームを検索します）を特定します。
4. キャンバスにフォーカスして右矢印キーを押すことで、スライド番号 N まで進めます（任意）。
5. スライドの <canvas> の要素スクリーンショットを撮り、周囲のビューアー UI を含めず、スライドだけを出力します。

注意事項

• これは fetch-slides を補完するものです。PDF 形式でデッキ全体が必要な場合は fetch-slides を使用してください（PPTX の場合は LibreOffice が必要です）。ダウンロードできない可能性のあるファイルから、スライド 1 枚の軽量なサムネイル画像だけが必要な場合は、このスキルを使用してください。
• 公開ウェブビューアーを利用するため、共有リンクはリンクを知っている全員が閲覧できる必要があります。