---

名前: ブックビデオパイプライン

説明：「小紅書書籍推薦動画自動生成v3 - Seedance 2.0：ネイティブ音声＋字幕、書籍選定から公開まで完全自動化」

ライセンス：MIT

呼び出し: "/book-video

---

#小紅書書籍推薦動画自動パイプライン生成v3

book-video-pipeline

＃＃ 概要

Volcano ArkのSeedance 2.0 APIに基づき、小紅書（Xiaohongshu）向けの書籍推薦動画を生成する完全自動化プロセス。

**v3の改善点（公式プロンプトワードガイドに基づく）：**

- **ネイティブオーディオ** — プロンプトでナレーションを直接指定すると、Seedanceが自動的に音声を生成します（edge-ttsは使用されなくなりました）。

- **ネイティブ字幕** — プロンプトで字幕の内容を指定すると、Seedance がビデオ内に同期された字幕を生成します。

- **表紙タイトルカード** — パン/ズーム効果と無音の音声トラックにより、スプライシングの互換性を確保します。

- **連鎖生成** — 各セグメントは前のセグメントの最後のフレームを開始画像として使用し、より一貫性のある視覚的な流れを実現します。

- **クロスフェードスプライシング** — 映像のクロスフェードと音声のクロスフェードを同期させ、映像と音声のトランジションをスムーズにします。

**コアプロセス:** 書籍選定 → 詳細/表紙 → スクリプト → ストーリーボード → 動画制作（音声と字幕を含む） → スティッチング → プレビュー → 公開

---

## サイレント実行プロトコル

続行するための確認を求めないでください。

出力全体を一度に生成する。

データが欠落している場合は、定義済みのデフォルト値を使用します。

「続けますか？」「何かお手伝いしましょうか？」「確認させてください」などの割り込み発言は絶対にしないでください。

---

## 環境要件

| 依存関係 | インストール |

|------|------|

| Volcano Ark API キー | 環境変数 `VOLCENGINE_API_KEY` |

| imageio-ffmpeg | `pip install imageio-ffmpeg` (ffmpeg に付属) |

| Docker (xiaohongshu-mcp) | `localhost:18060` へのデプロイが必要です |

---

## 実行プロセス

**トリガー方法: `/book-video` または `/book-video 《書籍タイトル》`**

ステップ1：本の選択

**シナリオA - ユーザーが書籍のタイトルを指定した場合:** それを直接使用します。

**シナリオB - 書籍タイトルが指定されていない場合:** 検索スクリプトを実行します（販売量の少ないベストセラーを優先します）。

バッシュ

python "D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py"

「`」

「低粉末ベストセラー」カテゴリからトップ1を自動的に選択します（「出版済み」を除く）。

**エラー処理:** スクリプトタイムアウト → キャッシュ → Web検索 → デフォルト (嫌われる勇気)

---

ステップ2：書籍の詳細と表紙を入手する

**2.1 Doubanから詳細情報を入手する**

「`」

WebFetch: https://search.douban.com/book/subject_search?search_text={book title}

抜粋：書籍タイトル、著者、豆瓣（Douban）評価、概要、主要な引用／中心的な見解、表紙のURL

「`」

**2.2 カバー画像をダウンロードしてください（英語のファイル名！）**

バッシュ

curl -o "D:\xiaohongshu_data\cover_{english_name}.jpg" -H "Referer: https://book.douban.com/" "表紙URL"

「`」

curlが失敗した場合は、以下を使用してください。

バッシュ

python "D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py" "{book title}"

「`」

---

ステップ3：書籍推薦スクリプトとストーリーボードを作成する

書籍の詳細に基づいて、会話形式のビデオスクリプトを作成します。

**Callergyフォーミュラ（Seedance 2.0公式ガイドに基づく）：**

各ストーリーボードのプロンプトは、次の3つの部分から構成されます。

1. **音声コマンド** — 音声付きのビデオを生成します。`{voice_type}` は「ナレーションテキスト」と読み上げます。

2. **視覚的描写** — `被写体 + 動作 + 環境 + カメラワーク + 雰囲気`

3. **字幕に関する指示** — 字幕は画面下部に表示されます。字幕は「ナレーションテキスト」であり、音声のリズムと完全に同期している必要があります。

**スクリプトテンプレート（6～7シーン、約35秒）：**

```マークダウン

## 書籍推薦動画スクリプト

**書籍タイトル**: 《{書籍タイトル}》

**スタイル:** ヒーリング（温かみのあるゴールドトーン）

### シーン1 - オープニングサスペンス（5秒）

**ナレーション:** {目を引く冒頭の一文}

**視覚的描写:** {英語で50～80語：被写体 + 動作 + 環境 + カメラアングル + 雰囲気}

### シーン2 - 本が現れる（5秒）

**ナレーター:** {本書の簡単な紹介}

**ビジュアル:** {英語で、本に関連したシーン}

### ストーリーボード 3 - 作者/背景 (5秒)

**ナレーション:** {著者の経歴または創作ストーリー}

**場面**: {英語、執筆現場、勉強など}

### ストーリーボード 4 - コアビューポイント 1 (5 秒)

**ナレーション:** {感動的な視点または印象的な引用}

**ビジュアル:** {英語では、視点に合った視覚的な比喩表現}

### シーン5 - コアビューポイント2（5秒）

**ナレーション:** {別の説得力のある視点または印象的な引用}

**ビジュアル:** {英語では、視点に合った視覚的な比喩表現}

### ストーリーボード6 - 個人的な考察（5秒）

**ナレーター**: {私の本当の気持ち、それを読んだ後に私が経験した変化}

**映像:** {英語、感動的なシーン}

### シーン7 - 行動喚起（5秒）

**ナレーター:** {行動喚起}

**映像:** {英語、心温まるエンディングシーン}

「`」

**画面説明のルール:**

- **英語で記述してください**、50～80語

- 次の公式によると: 被写体 + どのような動作が行われているか + どのような環境か + どのような照明/雰囲気か + カメラはどのように動いているか?

- **表紙画像／書籍タイトルテキスト（字幕から生成されたテキスト）は記載しないでください**

できる限り具体的な状況を描写し、抽象的な概念は避けてください。

**オプションのサウンドタイプ:**

- ヒーリング：「優しく穏やかな女性の声」

- サスペンス／ミステリー：低く響く男性の声

- フレッシュで清潔感のあるスタイル：軽やかで生き生きとした女性の声。

---

ステップ4：パイプラインを使用してビデオを生成します。

**4.1 ストーリーボードJSONの保存**

JSON

[

{"scene_id": 1, "prompt": "英語の視覚的描写...", "narration": "中国語のナレーション"},

{"scene_id": 2, "prompt": "英語の視覚的描写...", "narration": "中国語のナレーション"},

...

]

「`」

`D:\xiaohongshu_data\storyboard_{english_name}.json`に保存してください。

**4.2 完全なパイプラインの呼び出し v3**

Python

import sys, json

sys.path.insert(0, r"D:\skills\book-video-pipeline\scripts")

seedance_client から SeedanceClient をインポート

client = SeedanceClient(api_key="YOUR_API_KEY")

with open(r"D:\xiaohongshu_data\storyboard_xxx.json", encoding="utf-8") as f:

ストーリーボード = json.load(f)

result = client.generate_full_video(

ストーリーボード = ストーリーボード、

cover_path=r"D:\xiaohongshu_data\cover_xxx.jpg",

book_title="書籍タイトル",

output_dir=r"D:\xiaohongshu_data",

voice_type="穏やかで落ち着いた女性の声",

with_subtitles=True、

）

print(f"動画: {result['video_path']} ({result['size_kb']}KB、~{result['duration']}秒、音声: {result['has_audio']})")

「`」

**パイプラインv3は自動的に実行されます:**

1. 表紙 → タイトルカード（3秒間のパン/ズーム＋音声トラックのミュート）

2. ビデオクリップを順番に生成します（各クリップにはネイティブオーディオと字幕が含まれます）。

3. クロスフェード合成（ビデオのクロスフェード＋オーディオのクロスフェード）

4. 最終的なビデオを出力する。

**APIキーの設定:**

バッシュ

VOLCENGINE_API_KEY=ark-xxx を設定します

「`」

---

### ステップ 5: プレビュー

HTMLプレビューページ`D:\preview_video_{name}_{date}.html`を生成し、以下の内容を含めます。

- ビデオプレーヤー

- 書籍タイトル、著者、評価

- ナレーションテキスト版

- 小紅書のピンクをテーマにしたスタイル

バッシュ

開始 "" "D:\preview_video_xxx.html"

「`」

**ユーザーからの確認をお待ちください。** ご満足いただけない場合は、以下の手順に従ってください。

- ストーリーボードのプロンプトを調整 → 再生成

- サウンドタイプの変更 → 再生成

- 視覚的な説明を調整する → プロンプトのみを変更する

---

ステップ6：小紅書に投稿する

**6.1 ログインステータスの確認** → MCP `check_login_status`

**6.2 ビデオノートのテキストを生成する**（ビデオスクリプトではありません！）

タイトルは20文字以内、一人称視点で感情を込める。

本文は200～300語、絵文字は20個以上。

- # が付いたタグを 10～15 個

**MCP 6.3 リリース**

Python

MCP_URL = 'http://localhost:18060'

# 初期化 → publish_content(タイトル、コンテンツ、ビデオ、タグ)

# コンテナのパスを使用したビデオパス: /app/data/xxx.mp4

「`」

**6.4 レコードが公開されました** → `published_books.json` に `"type": "video"` を追加してください

---

## 出力形式

```マークダウン

## 書籍推薦動画が正常に生成されました

**書籍タイトル**: 《{書籍タイトル}》

**著者**: {著者} | **豆瓣**: {評価}

### 動画情報

- 所要時間：約{N}秒（3秒のタイトルカード＋{M}シーン×5秒）

- アスペクト比：9:16（縦向き）

解像度：720p

ファイルサイズ: {N} MB

- 音声：あり／なし

字幕：埋め込み／なし

- パス: `D:\xiaohongshu_data\{name}_final.mp4`

### 情報公開

- タイトル: {title}

- タグ: {tags}

- ステータス: {成功/失敗}

「`」

---

## 重要なルール

1. **ネイティブオーディオ推奨** — Seedance 2.0はネイティブで音声生成をサポートしています。プロンプトでナレーションを指定するだけです。

2. **ネイティブ字幕** — プロンプトで字幕の内容を指定すると、Seedance が自動的に同期字幕を生成します。

3. **最終フレーム継続** — 各セグメントは前のセグメントの最終フレームを開始画像として使用し、より一貫性のある視覚的な流れを実現します。

4. **ストーリーボードのショットは英語であるべきです** — Seedance は、より良い視覚品質のために英語のショットを使用しています。

5. **統一されたサウンドタイプ** — 映画全体で同じサウンドタイプが使用されています。

6. **動画のアスペクト比 9:16** — 小紅書縦画面

7. **公開前にユーザーの確認が必要です** — 公開する前にプレビューが完了するまでお待ちください。

8. **画像ファイル名は英語でなければなりません** — 中国語の文字を使用するとアップロードがタイムアウトします。

9. **ビデオスクリプト ≠ テキストと画像のメモ** — スクリプトは記事ではなく、会話的な言葉で書かれています。

10. **音声保持の切り替え** — xfadeビデオトランジション + acrossfadeオーディオトランジション

## キューワードリファレンス（Seedance 2.0 ガイド）

### 音声コマンドテンプレート

「`」

ナレーション付きの動画を生成します。`{voice_type}`オプションには「{ナレーション内容}」と表示されます。

「`」

### 字幕作成手順テンプレート

「`」

画面下部に「{字幕コンテンツ}」という内容の字幕が表示されます。字幕は音声のリズムと完全に同期している必要があります。

「`」

### 完全なシーンプロンプトの例

「`」

ナレーション付きの動画を作成します。穏やかで落ち着いた女性の声で、「なぜ私たちはいつも他人の期待に応えようとするのか、考えたことはありますか？」と語ります。霧のかかった森の小道の交差点に一人の人物が立っています。高い木々の間から太陽の光が差し込み、温かみのある夕暮れの光が差し込み、ゆっくりとしたドリーイン、浅い被写界深度です。画面下部に「なぜ私たちはいつも他人の期待に応えようとするのか、考えたことはありますか？」という字幕が表示されます。字幕は音声と完全に同期している必要があります。

「`」

## ファイル参照

| ファイル | 目的 |

|------|------|

| `D:\skills\book-video-pipeline\scripts\seedance_client.py` | Seedance API + ネイティブオーディオ/字幕 + 連結 (v3) |

| `D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py` | 人気の書籍検索 |

| `D:\skills\xiaohongshu-book-publisher\scripts\published_books.json` | 出版されたレコード |

| `D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py` | 表紙画像の取得（バックアップ） |

| `D:\xiaohongshu_data\` | ビデオとカバーの出力ディレクトリ |

## API設定

| パラメータ | 値 |

|------|-----|

|ビデオモデル | `doubao-seedance-2-0-fast-260128` |

| 音声タイプ | 穏やかで落ち着いた女性の声（デフォルト） |

| 比率 | `9:16` |

| セグメントの長さ | 5秒 |

| タイトルカード | 3秒間のパン/ズーム + 音声ミュート |

| クロスフェード | 0.5秒のトランジション（ビデオ＋オーディオ） |