# コンテンツレシピ

> SNS 投稿がうまくいった理由を、フック、フォーマット、ビート、行動喚起、音、テンポに分けて、再利用できるレシピにします。構造化データと読みやすいテキストで返します。

Source: https://nodaro.ai/ja/docs/nodes/video/content-recipe

**コンテンツレシピ**（Content Recipe）ノードは、SNS の投稿がうまくいった理由を、再利用できるレシピとして説明します。投稿の素材を言語モデルで読み取り、フック、フォーマット、ビート、投稿が効果的な理由、行動喚起、音、テンポを返します。レシピは構造化データと読みやすいテキストの両方で得られ、そのまま[**コンテンツのアイデア**（Content Ideas）](https://nodaro.ai/docs/nodes/video/content-ideas)に渡せます。

- Found in: Video › Analyze
- API type: `content-recipe`

コンテンツレシピは、Nodaro Cloud でのみ動作します。セルフホスティング環境では使えません。

## 使いどころ
- 競合の動画、話題になった投稿、広告が、なぜ視聴者を引きつけるのかを知りたいとき。
- うまくいった投稿の構成を、[コンテンツのアイデア](https://nodaro.ai/docs/nodes/video/content-ideas)で自分のブランドに再利用したいとき。
- 投稿ごとに、フォーマットやフックの種類などの固定ラベルを付けて、ワークフローの中で投稿を並べ替えたり振り分けたりしたいとき。
- 複数の投稿を比べたいとき。投稿ごとにレシピを 1 つずつ作り、すべてをコンテンツのアイデアに渡します。

## クイックスタート
### ノードを追加する
キャンバス上で Tab を押し、**動画 › 分析 › コンテンツレシピ**を選びます。

### 投稿を渡す
投稿を[**動画分析**（Video Analysis）](https://nodaro.ai/docs/nodes/video/video-analysis)で分析し、その**シーン JSON** 出力を**元の素材**入力に接続します。スクレイプした投稿や、[**テキスト**（Text）](https://nodaro.ai/docs/nodes/automate/text)ノードに入れたキャプションや文字起こしも使えます。

### 投稿のリンクを残す
投稿を入れた[**動画 URL**（Video URL）](https://nodaro.ai/docs/nodes/automate/video-url)ノードを、**元の投稿**入力に接続します。こうすると、レシピに投稿のリンクが記載され、そのレシピから作ったアイデアはすべて元の投稿にリンクします。

### 実行する
**実行**をクリックします。実行が終わると、アプリに「コンテンツレシピができました。」と表示されます。ノードには、トピック、フォーマットとその確信度、長さ、テンポ、**フック**、**構成**（ビート）、**効果の理由**が表示されます。レシピにポインターを合わせると、全文を開いたり、コピーしたりできます。

Workflow: 動画分析が投稿を読み取り、コンテンツレシピがその分析を、投稿のリンク付きのレシピにします。コンテンツのアイデアがブランド向けのアイデアを書き、脚本生成がアイデアごとに脚本を 1 本ずつ書きます。

- 動画 URL → 動画分析 (動画)
- 動画 URL → コンテンツレシピ (元の投稿)
- 動画分析 → コンテンツレシピ (元の素材)
- コンテンツレシピ → コンテンツのアイデア (レシピ)
- テキスト → コンテンツのアイデア (ブランド)
- コンテンツのアイデア → 脚本生成 (プロンプト)

## 入力
| 入力 | 接続できるノード | 説明 |
| --- | --- | --- |
| **元の素材** | 動画分析の結果、またはテキスト、JSON、リストを出力する任意のノード。たとえば、キャプションや文字起こしを入れたテキストノード | レシピの読み取り元になる素材です。必須です。 |
| **元の投稿** | [動画 URL](https://nodaro.ai/docs/nodes/automate/video-url)ノード、またはリンクを入れた任意のテキストノード | 投稿そのもののリンクです。レシピに記載されます。接続したリンクは、**投稿のリンク（任意）**より優先されます。 |

**ファイルではなく、ページのリンク**：動画 URL に接続したノードの多くは、ダウンロードされた動画を受け取ります。**元の投稿**は、その代わりに投稿のページのリンクを受け取ります。そのため、レシピから元の投稿を参照できます。

**1 回の実行で 1 つの投稿**：**元の素材**に複数の投稿のリストが届くと、ノードは最初の投稿だけを読み、そのことをノードに表示します。投稿ごとにレシピを 1 つずつ作るには、接続を**個別**に設定します。[接続モード](https://nodaro.ai/docs/concepts/nodes-and-connections#connection-modes)を参照してください。

### 最良のレシピになる素材
[動画分析](https://nodaro.ai/docs/nodes/video/video-analysis)の結果を使うと、最良のレシピになります。動画分析の結果には、タイミング、話された言葉、画面上のテキスト、音が含まれます。そのため、フックとビートが、投稿で実際に起きていることから読み取られます。スクレイプした投稿や、キャプションや文字起こしなどのプレーンテキストも使えます。タイミングがない場合、ノードは自然な話す速さからビートを推定します。

## 出力
| 出力 | 渡す内容 |
| --- | --- |
| **レシピ JSON** | 構造化データとしてのレシピです。[レシピの内容](#what-the-recipe-contains)を参照してください。 |
| **レシピのテキスト** | 同じレシピを、読みやすいテキストにしたものです。人が読むためのもので、レシピがテキストとして届いたときには、コンテンツのアイデアもこれを読みます。 |

[コンテンツのアイデア](https://nodaro.ai/docs/nodes/video/content-ideas)は、どちらの出力も受け付けます。

## 設定
| 設定 | 説明 |
| --- | --- |
| **AI モデル** | レシピを書く言語モデルです。デフォルトは Gemini 3.6 Flash です。一覧には、構造化データを返せるモデルが表示されます。モデルのティアで料金が決まります。[クレジット](#credits)を参照してください。 |
| **注目点（任意）** | レシピで特に注目すべき点です。たとえば「フックと編集のリズム」です。最大 2,000 文字です。 |
| **投稿のリンク（任意）** | **元の投稿**に何も接続されていないときに使う、投稿のリンクです。レシピにはこのリンクが記載されますが、ノードがリンク先を開くことはありません。**元の投稿**にノードが接続されている間は、この欄の代わりに「接続されたノードから取得」と、そのノードの名前が表示されます。 |

## レシピの内容
| フィールド | 内容 |
| --- | --- |
| `version` | `1` |
| `source` | レシピの出どころです。`kind`（`video-analysis`、`post`、`text` のいずれか）と、わかる場合は投稿の `url`、`platform`、アカウントの `handle`、`title`、`language` です。これらは入力から読み取られ、作り出されることはありません。 |
| `hook` | 最初の約 3 秒です。`spoken`（元の言語のまま一字一句そのまま）、`onScreenText`（一字一句そのまま）、`visual`、`types`（フックの仕掛けを 1〜2 個。主なものが先）、`whyItStops` です。 |
| `format` | `label`（下の一覧のフォーマットのうち 1 つ）と、`confidence`（0〜1）です。 |
| `beats` | 投稿の構成を、順番どおりに並べたものです。各ビートには、`start` と `end`（秒）、`purpose`、1 行の `description` があります。 |
| `whyItWorks` | 2〜4 個の理由です。それぞれに、`reason` と、投稿のある瞬間に結びついた `detail` があります。 |
| `cta` | 行動喚起です。`kind` と、一字一句そのままの `text` です。`kind` が `none` の場合、`text` は空です。 |
| `sound` | 音の `kind` と、短い `detail` です。 |
| `durationSec`、`pace`、`aspect` | 長さ（秒）です。分析がある場合は、分析から測った値です。テンポは `fast`、`medium`、`slow` のいずれかです。アスペクト比は、わかる場合に入ります。 |
| `topic`、`summary` | 数語で表した主題と、2〜3 文で表した再利用できるパターンです。 |

ラベルと説明は英語です。話されたフックなどの引用は、投稿の言語のままです。

### ラベルの一覧
すべてのラベルは、英語の ID の固定リストから選ばれます。フィルター、ルーター、後続のノードは、これらのラベルを頼りにできます。音の種類以外のリストには、ほかのどの値にも当てはまらない投稿のための `other` があります。

- **フォーマット**：`talking-head`、`pov`、`skit`、`storytime`、`tutorial`、`listicle`、`before-after`、`transformation`、`demo`、`unboxing`、`reaction`、`comparison`、`myth-vs-fact`、`day-in-the-life`、`challenge`、`hot-take`、`trend-remix`、`testimonial`、`behind-the-scenes`、`other`。
- **フックの種類**（フックの仕掛け）：`question`、`bold-claim`、`result-first`、`problem-callout`、`tease`、`story-open`、`direct-address`、`relatable-moment`、`pattern-interrupt`、`visual-shock`、`text-overlay`、`sound-hook`、`other`。
- **ビートの目的**：`hook`、`setup`、`problem`、`build`、`demo`、`proof`、`reveal`、`payoff`、`twist`、`cta`、`other`。
- **効果の理由**（それぞれの理由の原動力）：`curiosity`、`emotion`、`humor`、`relatability`、`social-proof`、`novelty`、`utility`、`aspiration`、`controversy`、`satisfaction`、`urgency`、`authority`、`other`。
- **行動喚起の種類**：`none`、`follow`、`comment`、`share`、`save`、`link-in-bio`、`buy`、`sign-up`、`watch-next`、`dm`、`other`。
- **音の種類**：`voiceover`、`on-camera-speech`、`trending-sound`、`music`、`ambient`、`silent`、`mixed`。

## クレジット
1 回の実行は、AI モデルのティアで決まる固定料金です。

| モデルのティア | 1 回の実行のクレジット |
| --- | --- |
| エコノミー（デフォルトの Gemini 3.6 Flash など） | 6 |
| スタンダード（Claude Sonnet 4.6 など） | 22 |
| プレミアム（Claude Opus 5 など） | 39 |

- **推論の強度**：API で `reasoningEffort` に `xhigh` または `max` を指定すると、1 段階上のティアの料金になります（上限はプレミアムです）。このノードの設定パネルには、推論の強度の設定はありません。
- **失敗した実行**：失敗した実行のクレジットは返還されます。[クレジット](https://nodaro.ai/docs/concepts/credits)を参照してください。
- **分析の料金は別**：通常このノードに素材を渡す[動画分析](https://nodaro.ai/docs/nodes/video/video-analysis)は、動画の長さで料金が決まります。**Pro** では、60 秒までの投稿で 238 クレジットです。

投稿から脚本までのフロー全体の料金は、[コンテンツのアイデア](https://nodaro.ai/docs/nodes/video/content-ideas#credits)を参照してください。

## ヒント
- **先に投稿を分析する**：フックとビートの質は、素材の質で決まります。最も充実した素材を渡せるのは、動画分析です。
- **リンクを残す**：動画 URL ノードを**元の投稿**に接続すると、レシピから作ったアイデアがすべて元の投稿にリンクします。
- **注目点を使う**：フックや編集のリズムなど、特に重要な部分がある場合は、**注目点（任意）**に書きます。
- **複数の投稿を組み合わせる**：投稿ごとにレシピを作り、すべてをコンテンツのアイデアに接続します。アイデアは、それらの投稿に分散します。

## トラブルシューティング
**実行が「先に動画分析、投稿、またはテキストを接続してください。」で止まる**：**元の素材**に、使える素材が接続されていません。動画分析、投稿、またはテキストノードを接続して、もう一度実行してください。実行は開始前に止まるため、料金はかかりません。

**実行が「コンテンツレシピの作成に失敗しました。」で終わる**：モデルがレシピを完成できませんでした。クレジットは返還されます。ノードをもう一度実行してください。

**最初の投稿だけを読んだと、ノードに表示される**：**元の素材**に、複数の投稿のリストが届いています。投稿ごとにレシピを 1 つずつ作るには、接続を**個別**に設定します。

**レシピに投稿のリンクがない**：**元の投稿**に何も接続されておらず、**投稿のリンク（任意）**も空でした。動画 URL ノードを**元の投稿**に接続するか、**投稿のリンク（任意）**にリンクを貼り付けてください。

## API から
`POST /v1/content-recipe` は、Nodaro Cloud でレシピを作ります。本文には、投稿の素材をテキストにした `source` と、任意の `sourceUrl`、`focus`、`llmModel`、`reasoningEffort` を指定します。素材には、JSON 文字列にした動画分析の結果、投稿、キャプション、文字起こしを使えます。

```bash
curl -s https://app.nodaro.ai/v1/content-recipe \
  -H "Authorization: Bearer $NODARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
"source": "Caption: three mornings, one mug. Which one is you?",
"sourceUrl": "https://www.tiktok.com/@example/video/7300000000000000000",
"focus": "the hook and the editing rhythm"
}'
```

応答は `{ "jobId": "…" }` です。ステータスが `completed` になるまで、`GET /v1/jobs/:id/status` でジョブをポーリングします。ジョブの `output_data` には、レシピが `json` と `text` の両方で入っています。[ジョブ](https://nodaro.ai/docs/developers/api/jobs)を参照してください。

実行できないリクエストは、ジョブが作られる前に `400` で拒否されるため、料金はかかりません。`source` が空か 300,000 文字を超える場合、`focus` が 2,000 文字を超える場合、構造化データを返せないモデルを指定した場合、`sourceUrl` が http または https のリンクでない場合が、これにあたります。

専用の MCP ツールや SDK メソッドはありません。ワークフローでは、このノードのタイプは `content-recipe` です。AI アシスタントやコードは、[ワークフローツール](https://nodaro.ai/docs/mcp/tools/projects-and-workflows)や[ワークフロー API](https://nodaro.ai/docs/developers/api/workflows)で、このノードを追加できます。

## Frequently asked questions

### コンテンツレシピノードは何を返しますか？

1 つの投稿のレシピです。最初の 3 秒のフックとスクロールを止める理由、確信度付きのフォーマット、タイミング付きのビート、投稿が効果的な 2〜4 個の理由、行動喚起、音、長さ、テンポが含まれます。レシピは、構造化された JSON と読みやすいテキストの両方で得られます。

### コンテンツレシピには何を接続すればよいですか？

投稿の動画分析を使うと、最良のレシピになります。動画分析には、タイミング、話された言葉、画面上のテキスト、音が含まれるためです。スクレイプした投稿、キャプション、文字起こしも使えます。投稿のリンクをレシピに残すには、動画 URL ノードを「元の投稿」に接続します。

### コンテンツレシピには何クレジットかかりますか？

デフォルトの Gemini 3.6 Flash などのエコノミーモデルでは、1 回の実行につき 6 クレジットです。スタンダードモデルは 22 クレジット、プレミアムモデルは 39 クレジットです。失敗した実行のクレジットは返還されます。通常このノードに素材を渡す動画分析は、動画の長さに応じて別に料金がかかります。

### 元の投稿をコピーせずに、レシピを再利用できますか？

はい。レシピをコンテンツのアイデアに接続します。アイデアが借りるのは、投稿の構成、つまりフォーマット、フックの仕掛け、ビートの順番、テンポだけです。アイデアを書くモデルは、投稿で話された言葉、画面上のテキスト、行動喚起の文言を見ることがありません。

### セルフホスティング環境でコンテンツレシピを使えますか？

いいえ。コンテンツレシピは Nodaro Cloud でのみ動作し、セルフホスティング環境では提供されていません。