API Platform

HTML-to-PPTX エクスポートジョブの作成とステータスポーリングのための標準HTTPエンドポイント。バックエンド統合、社内ツール、SaaS組み込みに最適。curl、JavaScript、Python、Go、Rubyなど、あらゆる言語で利用可能。テンプレート公開は REST API の役割ではありません。

Skills

Claude Code や Codex などのエージェントツール向けに html2pptx スキルを登録。エージェントがHTMLの診断、書き換え、エクスポート、ローカル編集、HTMLテンプレートdraft公開まで内蔵のremote MCPワークフローで実行。AIワークフローでエージェントがパイプライン全体を管理する場合に最適。

MCPプロトコル経由でAIエージェントにバックエンドを公開。remote HTTP MCP (`/mcp`) はエクスポート、docs、catalog、テンプレート公開に使い、local stdio MCP はローカルHTMLを edit-slide で開く場合だけ使います。HTMLテンプレートdraftは、検証後にremote MCP経由で作成します。

プライバシーとファイルアクセス

• bridge は `127.0.0.1` のみに bind します。ネットワーク上の他ユーザーはその bridge を開けません。
• bridge 起動ごとにセッショントークンを生成し、エディタはローカル読み書き時にその token を提示する必要があります。表示URLからは起動後に token を除去します。
• スライドプレビューは no-referrer を使うため、外部画像やフォントに token 付き editor URL が送られにくくなっています。
• 読み書きできるのは、カレントディレクトリ配下の `.html` / `.htm` ファイルだけです。
• `app/`、`components/`、`lib/`、`.git/`、`.next/`、`node_modules/` などのプロジェクトソースや内部ディレクトリはブロックされます。
• ノーコード編集だけではデッキは公開・アップロードされません。Export PPTX ボタンは `Claude Codeや各エージェントに、html2pptx skillsを使って、HTMLをPowerPoint出力してください。` という案内だけを表示し、直接変換は行いません。
• local stdio MCP の追加はユーザーのエージェント環境設定を変更します。Skills やエージェントは黙って追加せず、事前に確認してから実行します。
• エディタ状態はプロジェクトごとに `.html2pptx/edit-slide/` に保存されます。バージョン履歴、バックアップ、監査ログは作成されません。

よくあるつまずき

スライド用HTML/CSSの作成・診断・修正。HTMLがPPTXに正しく変換されるかを事前チェックし、問題があれば自動で書き換え。

• HTML診断（safe / needs-rewrite / out-of-scope）
• マークアップ自動書き換え
• スライドHTML新規生成
• 入力バリデーション

APIジョブの作成・ステータス管理・エラーハンドリング。REST API / MCP の使い分け判断も含む。

• エクスポートジョブ作成
• ポーリング＆完了待機
• エラー分析＆リトライ
• プラン制限の事前チェック

ローカルHTMLスライドをlocalhost上のvisual editorで開き、localhost bridge 経由で同じファイルに保存。

• html2pptx edit <file>
• PowerPoint風UIで視覚編集
• ローカルHTMLへの自動保存
• 変更検知と競合防止

APIキー（推奨）

ダッシュボードで発行したAPIキーを使用します。APIキーには有効期限がない（設定しない限り）ため、再認証の必要がありません。エクスポート、docs、catalog の日常的なMCP利用にはこちらを推奨します。作成者所有のテンプレートdraftは作成できません。

ダッシュボードでAPIキーを発行し、Bearerトークンとして設定してください。ほとんどのMCPクライアントはサーバー追加時に自動で処理します。

• ✓トークン期限切れなし — 安定した長期セッション
• ✓シンプルな設定 — キーを貼るだけ
• ✓日常利用や自動化に最適

OAuth（ブラウザログイン）

WorkOS AuthKit経由でGoogleアカウントやメールアドレスでログインします。アクセストークンの有効期限は24時間で、期限切れ後は再認証が必要です。html2pptx_publish_template にはこの identity-bound な認証が必要です。

MCPサーバーを追加すると、ブラウザでログイン画面が自動的に開きます。サインインして認証を完了してください。

• ✓APIキー管理が不要
• ✓お試しや評価に最適

OAuthセッションは24時間で期限切れになります。途切れないアクセスが必要な場合は、APIキーの利用を推奨します。

認証と認可

REST API は API キー、remote MCP は商用 API キーまたは WorkOS 認証済みセッションを利用します。ジョブ参照は、そのジョブを作成した API キーまたは principal に紐付きます。

SVG と未信頼マークアップ

公開 API と MCP は受信HTMLをサニタイズし、インライン SVG を安全に処理します。SVG は高品質な PNG 画像に変換されます。

ワーカー隔離

プライベートワーカーは分離ブラウザコンテキストでレンダリングし、任意の外部ネットワーク要求を遮断し、リクエストボディ上限と job TTL を適用します。

利用制御

1分あたりのリクエスト数、日次ガードレール、月次の公平利用レビュー閾値、1ジョブあたりの最大スライド数、最大 payload サイズ、同時実行数はすべてサーバー側で強制されます。

他社のHTML-to-PPTXソリューションとの違いは？

ほとんどの代替サービスはHTMLのスクリーンショットを撮り、各スライドにフラット画像として埋め込みます。html2pptx.app はネイティブシェイプ変換を行います -- CSSを解析し、flexbox、グラデーション、border-radius、シャドウなどのプロパティをネイティブPPTX Officeシェイプにマッピングします。結果は完全に編集可能なテキスト、スケーラブルなベクターグラフィックス、小さいファイルサイズです。

どんなHTMLでもPPTXに変換できますか？

安定した変換は保証されません。html2pptx.app は .slide クラス要素と明示サイズを持つスライド指向のHTMLに最適化されています。1600x900 はデフォルト例ですが、縦長やカスタムサイズにも対応しています。任意のWebページ、インタラクティブアプリ、スクロールベースのレイアウト、JavaScript依存のレンダリングを持つページは非対応です。HTML契約セクションに正確な要件が記載されています。

何が1枚のスライドになりますか？

.slide クラスを持つ各要素が出力PPTXの1スライドになります。HTMLに class="slide" を持つ要素が5つあれば、出力は5スライドになります。予測可能な結果のために、明確なスライド境界を定義してください。

エクスポート後のコンテンツはPowerPointで編集可能ですか？

はい、ほとんどの場合。テキストは編集可能なテキストボックスに変換され、シンプルな図形もPowerPoint上で編集できます。インラインSVGは高品質なPNG画像に変換されます。

エクスポートにはどのくらい時間がかかりますか？

単一スライドのジョブは通常3-5秒で完了します。マルチスライドデッキ（10-50スライド）は、複雑さ、画像数、フォント埋め込みに応じて8-20秒かかります。ワーカーは可能な場合スライドを並列処理します。最適なレスポンシブ性のため、ジョブステータスエンドポイントを2秒間隔でポーリングしてください。

どのフォントに対応していますか？

システムフォント（Arial、Helvetica、Times New Romanなど）はデフォルトで動作します。Webフォントの場合、autoEmbedFonts: true を有効にしてください -- html2pptx.app がGoogle Fontsやカスタム@font-face URLからフォントファイルをダウンロードしてPPTXに埋め込みます。Noto Sans JP、游ゴシック、メイリオ、ヒラギノなどの日本語フォントにも完全対応しています。

無料プランはありますか？

はい。現在の公開カタログには Early Access ティアがあり、制限付きで API / Skills / MCP を利用できます。正確な上限はコードと GET /api/export/plans のレスポンスが正です。

スライドでSVGは使えますか？

はい。インラインSVGに対応しています。公開APIでは安全のためPNG画像に変換されます。

最大ファイルサイズは？

HTMLペイロードは5MB以下を推奨。生成されるPPTXファイルはコンテンツにより異なりますが、通常100KB〜10MBの範囲です。多数の高解像度画像をbase64で埋め込んだジョブはファイルサイズが大きくなります。大きな画像にはURL参照の使用を検討してください。

セキュリティ対策は？

複数の防御を実装しています。ワーカーの外部要求遮断、ジョブ所有者バインディング、APIキーのハッシュ保存、リクエストボディ上限、同時実行数制限、公開SVGのサニタイズとPNG化などです。バックエンド自動化では Hosted Web Export ではなく REST API を使うのが推奨です。

日本語テキストやCJK文字に対応していますか？

はい、完全対応しています。日本語、中国語、韓国語の文字は正しくレンダリングされます。最良の結果のためには、CSSでCJKフォントを指定し（例: font-family: "Noto Sans JP", sans-serif）、autoEmbedFontsを有効にしてフォントがインストールされていないマシンでもポータブルなレンダリングを確保してください。

エラーの対処方法は？

ジョブステータスエンドポイントを確認してください。statusが "failed" の場合、errorフィールドに人間が読める説明が含まれます。すべてのAPIエラーはRFC 9457 Problem Details形式に準拠し、type、status、title、detail、instanceフィールドに加え、後方互換のためのerrorとmessageフィールドも返します。一般的な問題: .slide要素の欠落 (400)、期限切れAPIキー (401)、レート制限超過 (429)、コンテンツの超過サイズ (413)。

CSS Gridで複雑なスライドレイアウトは作れますか？

はい。CSS Gridは grid-template-columns、grid-template-rows、gap、グリッド配置プロパティを含め完全に対応しています。マルチカラムレイアウト、ダッシュボードスタイルのカード、複雑なビジュアル配置を簡単に作成でき、PPTXにクリーンに変換されます。

ジョブ完了のWebhookはありますか？

はい。POST /api/export/jobs のリクエストボディに callbackUrl フィールド（HTTPSのみ）を追加してください。ジョブ完了または失敗時に、ワーカーがコールバックURLにジョブ結果全体をPOSTします（x-signature-sha256 HMACヘッダー付き）。あるいは従来通り GET /api/export/jobs/{jobId} を2秒間隔でポーリングすることも可能です。MCPユーザーの場合、html2pptx_wait_for_export_job がポーリングを自動処理します。