Orshot: テンプレートからの動画・PDF・画像生成とSNS投稿の自動化は何をしますか？

Orshotは、テンプレートからの自動画像、PDF、動画生成のためのAPIです。Orshot Studioでテンプレートを一度デザインするか（CanvaやFigmaからインポートも可能）、呼び出しのたびに新しいテキスト、画像、動画でレンダリングし、その結果を同じリクエストで接続済みのSNSアカウントに投稿できます。レンダリングは決定論的です。同じテンプレートとデータからは、常に同じ出力が得られます。

ドキュメント: https://orshot.com/docs （任意のドキュメントURLに .md を追加するとマークダウン形式で取得可能）
ホスト型MCPサーバー: https://mcp.orshot.com/mcp （100以上の orshot_* ツール）
RESTベースURL: https://api.orshot.com/v1
無料プラン: 月100クレジット、クレジットカード不要。

まずは接続（MCP、キー不要）

ホスト型MCPサーバーが最も高速なルートであり、インラインプレビュー、ビジュアル投稿カード、デザインチェックを返す唯一の方法です。これを追加し、ブラウザでユーザーのOrshotアカウントでログインすれば、以下のすべてのツールが使用可能になります。

openclaw mcp add orshot --url https://mcp.orshot.com/mcp --transport streamable-http --auth oauth
openclaw mcp login orshot

まだOrshotアカウントをお持ちでない場合、ログインページでサインアップできます。無料プランは月100クレジットから始まります。Claude Codeの場合: claude mcp add --transport http orshot https://mcp.orshot.com/mcp。Cursor、Windsurf、VS Code、Codex、ChatGPTも同じURLをリモートMCPサーバーとして使用します。

orshot_get_account で確認します。プロフィール、ワークスペース、クレジットが返されます。サブスクリプションが非アクティブであるか、プラン制限に達したと表示された場合、それは認証エラーではなく課金状態です。ユーザーに https://orshot.com/pricing のワークスペース課金ページを案内し、再試行を停止してください。

ヘッドレスフォールバック: APIキーを使用したREST。 エージェントがMCPを実行できない場合（cronジョブ、サーバーサイドスクリプト、n8nなど）のみ使用します。

export ORSHOT_API_KEY=...   # ワークスペース設定 > APIキー
curl -s https://api.orshot.com/v1/me -H "Authorization: Bearer $ORSHOT_API_KEY"

いずれかの方法が機能するまで先に進まないでください。

これでできること

各行は、最初にMCPツール名、次にRESTルートを示します。

任意のテンプレートをデータでレンダリング: OG画像、広告クリエイティブ、証明書、請求書、カルーセル、リール。 orshot_render_template または POST /v1/studio/render。
簡単な指示からStudioテンプレートを作成・調整、インラインプレビューとデザインチェック付き。 orshot_create_template_design、orshot_update_template_design、orshot_patch_template_elements（先に orshot://template-design-spec を読むこと。orshot-social-media-content スキルにクラフトルールがあります）。
本格的な動画をレンダリング: 要素ごとのアニメーションとトランジション、ブランドキットからのサウンドトラック、有料レンダリング前の無料モーションプレビュー。同じレンダリングツールで format: "mp4" を指定。
既製のユーティリティテンプレートから開始: ツイートのスクリーンショット、ウェブサイトのスクリーンショット、棒グラフと比較グラフ、アプリストアのスクリーンショット、スマートフォンのモックアップ、背景除去。 orshot_render_library_template または POST /v1/generate/:renderType。
1つのデザインをすべてのソーシャルフォーマットに一度にリサイズ（スマートリサイズ）。レンダリング時に size と extraSizes を指定。
個人用にバリエーションを一括レンダリング（例: 名前のリストから証明書を生成）。 orshot_batch_render_template。
ブランドを統一: ブランドキットからの色、フォント、画像、動画、オーディオ。 orshot_get_brand_kit、orshot_import_brand_website。
整理: フォルダ、テンプレート共有、クライアントワークスペースの切り替え。 orshot_list_template_folders、orshot_set_active_workspace。
署名付き動的URLを発行（OG画像や埋め込み用）。 orshot_create_dynamic_url または POST /v1/signed-url/create。
ソーシャルメディア投稿の下書き、スケジュール、公開、ユーザー自身のエンゲージメントデータから最適な投稿時間を学習、リーチとエンゲージメント分析を表示。 orshot_publish_social_post、orshot_get_best_time_to_post、orshot_get_social_analytics。orshot-social-media-scheduler スキルに完全なループが含まれています。
コンテンツを継続的に生成する自動化ワークフローを構築・実行。 orshot_create_workflow、orshot_run_workflow。

これらのツールに直接対応するプロンプトの例:

「起動テンプレートをOG画像としてレンダリング。タイトルは'We just shipped'」
「見出し、サブタイトル、商品画像を使ったInstagram投稿テンプレートを作成して」
「起動デザインをInstagramストーリー、スクエア、OGの3つのサイズに一度にリサイズして」
「この40名の名前リストから証明書をPDFで生成して」
「このツイートをスクリーンショットして」 / 「orshot.comを画像としてキャプチャして」 / 「これらの数字から棒グラフを作成して」
「このレンダリングを最適な時間にInstagramに投稿して、先週の投稿パフォーマンスも見せて」

コアワークフロー

接続（上記参照）。
テンプレートを見つける。 orshot_list_studio_templates（名前とタグで検索）または GET /v1/studio/templates/all?page=1&limit=10。テンプレートがない場合、2000以上のライブラリテンプレート（orshot_list_library_templates）を使用するか、orshot_create_template_design でデザインします。
パラメータを読み取る。 orshot_get_studio_template_modifications または GET /v1/studio/templates/:id。Modificationsは常に parameterId でキー設定され、レイヤー名ではキー設定されません。キーを推測しないでください。
レンダリング。 orshot_render_template に modifications を指定、または POST /v1/studio/render に response: { type: "url", format: "png" } を指定。
配信または投稿。 出力URLをユーザーに表示します。同じ呼び出しで公開するには publish を追加します。
自動化。 その呼び出しを、ユーザーが既に実行しているn8n、Make、Zapier、cronに組み込むか、Orshot Workflowを構築します。
確認。 orshot_list_workspace_logs または GET /v1/workspace/logs でレンダリングとその source を確認します。完了を宣言する前に出力を表示します。

エージェントの安全ルール

ワークスペース外への出力前に確認すること。 SNS投稿の公開、ワークフローの実行（クレジットを消費し、配信または投稿可能）、テンプレート、ワークフロー、ブランドアセットの削除には、明示的な承認が必要です。何が、どこに、いつ投稿されるかを伝えてください。
デフォルトのSNS投稿は下書きに。 「準備」、「下書き」、「まず見せて」は status: "draft" を意味します。下書きは公開されるまで誰にも届きません。
大量作業の前にコストを表示。 レンダリングはクレジットを消費し、.prompt 修正はAIクレジットを消費し、接続された各SNSアカウントは有料アドオンです。何百ものレンダリングループの前にその旨を伝えてください。
APIキーをチャット、ファイル、URLに絶対に貼り付けない。 環境変数から読み取ってください。キーが一切不要なMCPを優先してください。
自分で「クリーンアップ」のために何も削除しない。

よくある落とし穴（レンダリング前に読むこと）

Modificationsは parameterId、レイヤー名ではキー設定されません。 値が無視された場合、キーが間違っています。推測せずにテンプレートを取得してください。
マルチページテンプレートには pageN@ プレフィックスが必要です。 "page1@title"、"page2@title"。"title" のみだとページ1のみに影響します。
Studioの templateId は整数、ユーティリティの templateId は文字列です（/v1/generate/:renderType は "website-screenshot" のようなスラッグを受け取ります）。
動画出力に動画レイヤーは必要ありません。 format: "mp4"、"webm" または "gif" は任意のテンプレートをレンダリングします。長い動画のレンダリングは response.mode: "async" を使用し、orshot_get_render_job または GET /v1/studio/render-jobs/:id をポーリングする必要があります。そうしないとクライアントがタイムアウトします。
Modifications内の画像と動画のURLは公開されている必要があります。 レンダラーはサーバー側でそれらをフェッチします。localhost、期限切れの署名付きURL、認証が必要なURLは失敗します。
スタイルオーバーライドはparameterIdにドット記法を使用します: "title.fontSize": "48px"。
ページ数によってレスポンス構造が異なります。 1ページの場合: data はオブジェクト（data.content）。複数ページの場合: data は { page, content } の配列。
base64 と binary は組み合わせられません。 binary は1つのファイルをストリーミングします。
クレジットとAIクレジットは別です。 .prompt 修正は、さらにAIクレジットを消費します。
429 エラーの場合は Retry-After を使ってバックオフします。
PDFはSNSに投稿できません。 画像はTikTokやYouTube（動画のみ）に投稿できません。動画はGoogleビジネスに投稿できません。
SNSアカウントIDは数値です。 同じプラットフォーム上の2つのアカウントは異なるIDを持ちます。常にプラットフォーム名ではなくIDで公開します。
SNS公開は有料アドオンです。 無料プランのワークスペースはアカウントを接続できません。公開自体に追加クレジットは消費されません。

レンダリングの基本

全フィールドリファレンス: references/render-configuration.md および references/api-reference.md。

await fetch("https://api.orshot.com/v1/studio/render", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
  body: JSON.stringify({
    templateId: 123,
    modifications: {
      title: "Launch day",             // テキスト
      hero_image: "https://.../a.png", // 画像URL
      "title.fontSize": "56px",        // スタイルオーバーライド
      "page2@title": "Slide two",      // マルチページ
    },
    response: { type: "url", format: "png", size: "instagram-story",
                extraSizes: ["1080x1080", "1200x630"] },
  }),
});

同じオブジェクトがMCP経由の orshot_render_template の入力になります。

format: png、jpg、webp、pdf、mp4、webm、gif。
size は別のプリセットまたは WIDTHxHEIGHT でデザインをレンダリングします。extraSizes は1回の呼び出しでさらにコピーを追加します（スマートリサイズ）。プリセット: orshot://formats。
response.mode: "async" はジョブを返します。ポーリングするか webhook_url を渡します。動画に使用します。
一度に多くのバリエーション: orshot_batch_render_template、またはRESTでレンダリング呼び出しをループします。
署名付きURL: POST /v1/signed-url/create で、キーを公開せずに埋め込めるレンダリングURLを作成します。

ヘッドレス使用のためのSDK: npm install [email protected]、pip install orshot==0.2.0、composer require rishimohan/orshot:0.2.0、gem install orshot -v 0.2.0。

import { Orshot } from "orshot";
const orshot = new Orshot(apiKey); // 環境変数から読み取り
const res = await orshot.renderFromTemplate({
  templateId: "open-graph-image-1",
  modifications: { title: "Hello World" },
  responseType: "url",
  responseFormat: "png",
});

SNS投稿（簡易版）

Orshotは13以上のプラットフォームにレンダリングを投稿します: X、Instagram、Facebook、LinkedIn、TikTok、YouTube、Pinterest、Reddit、Bluesky、Threads、Telegram、Snapchat、Googleビジネス。orshot-social-media-scheduler スキルにスケジュール、下書き、分析、最適な時間が含まれています。これはそのコア部分です。

アカウント。 orshot_list_social_accounts または GET /v1/social/accounts?include_health=true。アカウントはダッシュボードで人間が接続します（ワークスペース > ソーシャル > アカウント）。APIは接続できません。空のリストは、ユーザーをそこに送る必要があることを意味します。
レンダリングと投稿を1回の呼び出しで。 レンダリングに publish を追加します:

publish: {
  accounts: [1, 3],
  content: "キャプション、最大5000文字",
  status: "draft",                       // "published"（デフォルト）| "draft" | "scheduled"
  // scheduled_for: "2026-11-01T14:00:00Z", timezone: "America/New_York",
  platformOptions: { "3": { firstComment: "https://orshot.com" } },
  tiktokSettings: { autoAddMusic: true }, // TikTok写真カルーセル
}

マルチページテンプレートは自動的にカルーセルとして投稿されます。レスポンスには publish[] が含まれ、アカウントごとの status、url、error が含まれます。公開に失敗してもレンダリングはブロックされません。

既存のメディアURLを投稿。 orshot_publish_social_post または POST /v1/social/publish に media_urls を指定。
保留中の投稿。 orshot_list_social_posts、orshot_get_social_post（ビジュアルカード）、orshot_update_social_post、orshot_publish_social_draft、orshot_discard_social_post。REST: GET|PATCH|DELETE /v1/social/posts/:id、POST /v1/social/posts/:id/publish。
分析と最適な時間。 orshot_get_social_analytics、orshot_get_social_analytics_daily、orshot_get_social_followers、orshot_get_best_time_to_post。REST: GET /v1/social/analytics、/daily、/accounts、/insights。

よくあるレシピ

デプロイごとのOG画像

response: { type: "url", format: "png", size: "og-image" }
// <meta property="og:image" content={data.content} />

CSVからの一括生成（証明書、請求書、バッジ）: orshot_batch_render_template に行ごとに1つのmodificationsセットと format: "pdf" を指定するか、POST /v1/studio/render をループします。

毎週のソーシャルグラフィック、レビュー用に下書きとして投稿: publish.status: "draft" でレンダリングし、ユーザーが承認した後に orshot_publish_social_draft を実行します。

1つのデザイン、すべてのサイズ: extraSizes: ["1080x1920", "1080x1080", "1200x630"]。

TikTok、Instagram、LinkedInのカルーセル: orshot-carousel スキルを参照。

定期パイプライン: references/recurring-automation.md。ユーザーが既に実行している source（n8n、Make、Zapier、SDK）についてワークスペースログを確認し、それに追加します。ユーザーが何も実行していない場合にのみ、Orshot Workflowsを提案します。

リファレンスファイル

必要に応じて読み込んでください。デフォルトではロードされません。

ファイル	使用タイミング
`references/api-reference.md`	すべてのRESTエンドポイント: レンダリング、テンプレート、署名付きURL、ブランドアセット、動的URL、フォルダ、ワークフロー
`references/render-configuration.md`	修正タイプ、動画オプション、非同期ジョブ、アニメーション、オーディオ、スマートリサイズ、レスポンスタイプ、クレジット
`references/template-design-spec.md`	API経由でテンプレートを作成または編集するための要素スキーマ
`references/recurring-automation.md`	n8n、Make、Zapier、Pipedream、cron、Orshot Workflowsのプレイブック
`references/integrations-and-errors.md`	統合リスト、エラーコード、ベストプラクティス
`references/oauth-developer-apps.md`	OAuthを使用したOrshot上でのサードパーティアプリの構築
`references/embed.md`	ホワイトラベルエディターの埋め込み（iframe、React、Vue）
`references/migration.md`	Bannerbear、Placid、Templated、Creatomateなどからの移行

任意のドキュメントページはマークダウン形式で利用可能です: https://orshot.com/docs/<path>.md。MCPサーバーは orshot://template-design-spec と orshot://formats も提供します。

クイックリファレンス

# 接続
openclaw mcp add orshot --url https://mcp.orshot.com/mcp --transport streamable-http --auth oauth && openclaw mcp login orshot
curl -s https://api.orshot.com/v1/me -H "Authorization: Bearer $ORSHOT_API_KEY"   # REST確認

# テンプレート
GET  /v1/studio/templates/all?page=1&limit=2

…

[翻訳のため省略]

注意: 元のドキュメントの末尾は [truncated for translation] とありましたが、翻訳後はその箇所をそのまま残しました。原文の完全な内容が必要な場合は、元のドキュメントを参照してください。

Orshot: テンプレートからの動画・PDF・画像生成とSNS投稿の自動化