# コンテンツレシピ

> コンテンツレシピは、アニメーションの解説動画など、Nodaro での一連の流れを AI アシスタントに案内する検証済みのプレイブックです。get_recipe で読み込みます。

Source: https://nodaro.ai/ja/docs/mcp/recipes

**コンテンツレシピ**は、1 つの成果物に向けた Nodaro での一連の流れを、最初から最後まで AI アシスタントに案内する、検証済みのプレイブックです。たとえば `video-explainer` レシピでは、アシスタントはビジュアルスタイルを固定し、ナレーションを書き、無音のクリップをレンダリングし、それに音声を付けて、[`assemble_narrated_video`](https://nodaro.ai/docs/mcp/tools/video-editing#assemble_narrated_video) で仕上げます。アシスタントは [`get_recipe`](https://nodaro.ai/docs/mcp/tools/utility#get_recipe) でレシピを読み込み、ツールの呼び出しを 1 つずつ、レシピどおりに進めます。

## レシピの仕組み
`get_recipe` が返すのは、テキストだけです。`start_workflow_editor` や `start_video_director` と同じように、ほかのツールを呼び出すことも、何かを変更することもありません。`generate_video`、`generate_speech`、`assemble_narrated_video` など、レシピが求める操作は、通常のツール呼び出しです。それぞれに固有の権限が必要で、それぞれにクレジットがかかります。

このツールは、どのエディションでも権限が不要で、料金もかかりません。次の 3 種類の呼び出しに応答します。

| 呼び出し | 返されるもの |
| --- | --- |
| 引数なしの `get_recipe` | カタログです。各レシピの名前、説明、トリガーフレーズが含まれます。 |
| `recipe` を指定した `get_recipe` | そのレシピの完全な指示です。たとえば `recipe: "video-explainer"` と指定します。 |
| `recipe` と `file` を指定した `get_recipe` | レシピに同梱された参照ファイルです。たとえば `file: "references/prompts.md"` と指定します。 |

存在しないレシピやファイルを指定すると、有効なレシピ名の一覧を含むエラーが返されます。

## カタログ
| レシピ | 作れるもの | トリガーの例 |
| --- | --- | --- |
| `camera-coverage` | 1 枚のリファレンスフレームから作る、1 つのシーンの、編集でつなげられる 10 のカメラアングルです。クレジットを使う前に、編集できるショットリストを承認します。1 つの画像ノードが、すべてのショットにファンアウトします。 | 「カメラカバレッジ」「ショットリスト」「同じシーンを別のアングルで」 |
| `image-editing-levers` | 1 枚の高解像度画像の、並列の編集です。正確なテキストの指示、ピッカーで設定するルック、ライティングを合わせた背景の差し替え、任意の講評、コンタクトシートを含みます。 | 「この画像を編集して」「ジャケットの色を変えて」「背景を削除して」 |
| `infinite-zoom` | 複数の生成クリップをまたいで途切れずに続く、1 つのプッシュインです。各クリップは細部の中で終わり、次のクリップはその細部から始まり、フレーム単位でつながります。生成のクレジットを使わない、静止画のズーム版もあります。 | 「無限ズーム」「エンドレスズーム」「細部にズームイン」 |
| `instagram-carousel` | 1 つのアイデアから作る、完成した Instagram のカルーセルです。スライドごとに 1 枚ずつの、テキストを画像内に入れた 9:16 の画像と、導入テキスト、キャプションからなります。 | 「インスタのカルーセル」「カルーセル投稿」「これをカルーセルにして」 |
| `multi-reference-control` | 最大 5 つのリファレンスから構成する、1 枚の画像です。人物、衣服、場所など、リファレンスごとに異なる要素を取り入れます。 | 「複数のリファレンスを組み合わせて」「ジャケットはこの画像から」 |
| `one-character-any-scene` | リファレンストークンを使い、マスクやモデルの学習なしで、同じ人物をあらゆるシーン、衣装、背景に配置します。 | 「同じキャラクターを別のシーンに」「背景はそのままで人物を変えて」 |
| `person-node-basics` | 文章ではなく、年齢、体格、目、髪などの**人物**（Person）ピッカーの属性で作る、デザインされたキャラクターです。 | 「人物を作って」「キャラクターの見た目をデザインして」「特定の顔」 |
| `podcast-editing` | 長い収録を、文字起こしをもとに間を詰めるか、短いクリップのセットに切り分けます。`apply_edl` でレンダリングする前に調整できる、編集リストを使います。 | 「ポッドキャストを編集して」「この収録を整えて」「切り抜きクリップのセット」 |
| `product-photoshoot` | 1 枚の商品画像から作る、9 種類の広告スタイルによる完全な広告キャンペーンです。自分の商品写真から作るか、ルックのリファレンスを自分の商品向けに書き換えて作ります。 | 「商品撮影」「自分の商品の広告」 |
| `scene-chain-reel` | 複数のシーンから作る、シネマティックな縦型のリール動画です。まず、連続性のためにリファレンスをつなげながら静止画を作ります。すべてのフレームに 1 つのモーションプロンプトを使い、1 つの BGM を付けてから、トリミングとフォーマット調整を行います。 | 「シネマティックなリール」「インスタのリール」「複数シーンの動画」 |
| `song-from-reference` | 既存の曲に似た曲です。他人の曲は分析して、オリジナルの曲にします。Suno のカバーは、自分が権利を持つオーディオからだけ作ります。 | 「似た曲」「この曲をカバーして」「このリンクから曲を作って」 |
| `suno-music-basics` | ジャンル、ムード、楽器編成、声など、音楽のピッカーを重ねてスタイルを決めた、曲やインストゥルメンタルです。 | 「曲を作って」「インストゥルメンタルの曲」「動画用の音楽」 |
| `video-explainer` | ナレーション付きの、フォトリアルではないアニメーションの解説動画です。固定した 1 つのビジュアルスタイル、無音のクリップとしてレンダリングした複数のナレーションブロック、1 つの声からなり、`assemble_narrated_video` で組み立てます。 | 「解説動画」「アニメーションの解説動画」「仕組みを説明する動画」 |

Nodaro Cloud では、カタログに UGC の Web サイト動画も含まれます。クリエイターがカメラに向かって Web サイトについて話し、そのサイトのスクリーンショットがカードとして表示される動画です。このレシピは、[UGC ビルダーのツール](https://nodaro.ai/docs/mcp/tools/utility#the-ugc-video-builders)を使います。

## アニメーション映像か、モーショングラフィックスか
Nodaro は、2 つの方法で解説動画を作れます。`video-explainer` レシピは、何よりも先に、どちらにするかを尋ねます。

| | `video-explainer` レシピ | [動画ディレクター](https://nodaro.ai/docs/mcp/video-director) |
| --- | --- | --- |
| **映像** | 生成したアニメーション映像、イラストのシーン | キネティックタイポグラフィ、図形、画像 |
| **進め方** | アシスタントがすべてのステップを実行し、各クリップと音声のテイクを確認できる | `create_explainer` の 1 回の呼び出し、またはショットシーケンスのパイプラインを 1 ステップずつ |
| **コスト** | 10 秒のブロックごとの生成の料金で、長さに応じて増える | 動画 1 本あたり、決まった一連のステップの料金 |

モーショングラフィックスを選ぶと、レシピはそこで止まり、`start_video_director` に引き継ぎます。依頼の中ですでにスタイルが指定されている場合、レシピはこの質問を省略します。

## 自分のインスタンスにレシピを追加する
セルフホスティング環境と、公開リポジトリへのコントリビューションでは、レシピはバックエンドの `skills/recipes` ディレクトリにある、`RECIPE.md` ファイルを含むフォルダーです。レシピが `file` で読み込むファイル用に、`references` フォルダーを置くこともできます。サーバーは、起動時にカタログを読み込みます。

```text
skills/recipes/my-recipe/
RECIPE.md
references/
prompts.md
```

`RECIPE.md` は YAML フロントマターで始まり、その後に、アシスタントが受け取る指示が続きます。指示は、直接的なブリーフとして書きます。まずルール、次にフェーズを書き、ツール名とパラメーターは正確に記載します。

```markdown
---
name: my-recipe
description: One line shown in the catalog
triggers: ["phrase one", "phrase two"]
version: 1
---

# My recipe

You are producing ONE ...
```

| フィールド | 必須 | 説明 |
| --- | --- | --- |
| `name` | はい | フォルダー名と一致させます。`get_recipe` が読み込むのはフォルダー名で、2 つが一致しているかどうかはチェックされません。 |
| `description` | はい | カタログに表示する、1 行の説明です。 |
| `triggers` | はい | ユーザーが言いそうなフレーズです。フレーズの中にカンマを入れないでください。リストは、カンマで分割されます。 |
| `version` | いいえ | 指示を大きく変えたときに上げる数値です。 |

フォルダー名は、ケバブケース（小文字、数字、ハイフン）にする必要があります。フィールドが欠けているレシピはカタログから除外されますが、ほかのレシピには影響しません。参照ファイルは、そのレシピ自身のフォルダー内からしか読み込めません。レシピをテストするには、まず引数なしで `get_recipe` を呼び出します。次にレシピの名前を指定して呼び出し、さらに各参照ファイルを指定して呼び出します。

## Frequently asked questions

### Nodaro のコンテンツレシピとは何ですか？

ナレーション付きのアニメーション解説動画や Instagram のカルーセルなど、1 つの成果物を複数の Nodaro ツールで作る方法を、AI アシスタントに 1 ステップずつ伝える、検証済みのプレイブックです。アシスタントは get_recipe でレシピを読み込み、その手順に従います。

### レシピを読み込むと、クレジットはかかりますか？

いいえ。get_recipe は指示を返すだけです。レシピが求める生成は通常のツール呼び出しで、それぞれに料金と権限があります。

### video-explainer レシピと create_explainer の違いは何ですか？

video-explainer レシピは、生成したアニメーション映像から解説動画を作り、アシスタントがすべてのクリップと音声のテイクを管理します。create_explainer は、テキストと図形によるモーショングラフィックスの解説動画を、1 回の呼び出しで作ります。レシピは最初に、どちらにするかを尋ねます。

### 使うレシピを、アシスタントはどうやって判断しますか？

引数なしで get_recipe を呼び出すと、すべてのレシピが、「解説動画」や「商品撮影」などのトリガーフレーズとともに一覧表示されます。アシスタントは、何かを作り始める前に、あなたの依頼をレシピと照らし合わせます。