/ ディレクトリ / プレイグラウンド / narrator-ai-cli-skill
← 全サーバー ↗ GitHub
● コミュニティ GridLtd-ProductDev ⚡ 即起動

narrator-ai-cli-skill

作者 GridLtd-ProductDev · GridLtd-ProductDev/narrator-ai-cli-skill

Narrator AI 動画ナレーション CLI 向けのエージェントスキル — Claude がコマンドラインからナレーション処理をエンドツーエンドで実行します。

narrator-ai-cli-skill は、Narrator AI 動画ナレーション API の CLI クライアントである narrator-ai-cli の使い方を Claude に教えるスキルです。フラグ、一般的なフロー、出力処理をラップすることで、Claude がナレーション用プロンプトの組み立て、ジョブの投入、完了のポーリング、出力ファイルの適切な配置を行えるようにします。CLI を手動で実行せずに複数の動画を一括ナレーションしたい場合に便利です。

▶ デモを見る 📦 インストール 💡 ユースケース

なぜ使うのか

主な機能

ライブデモ

実際の動作

narrator-ai-cli-skill.replay ▶ 準備完了
0/0

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

実用的な使い方： narrator-ai-cli-skill

ブリーフから単一動画のナレーションを生成する方法

👤 Narrator AI を VO に使用するクリエイターおよびエディター ⏱ ~15 min beginner

使うタイミング： 動画とボイスオーバー台本のドラフトがあり、CLI 経由でナレーションを生成したい場合。

フロー
  1. 入力ファイルを準備する
    動画 scene_01.mp4 と VO 台本 script.md を使って narrator-ai-cli を実行し、出力を ./narrations/ に保存してください。✓ コピーしました
    → 正しいフラグでの CLI 呼び出し
  2. 待機して確認する
    ジョブが完了するまでポーリングし、出力ファイルが存在しオーディオが含まれていることを確認してください。✓ コピーしました
    → ゼロでない再生時間を持つ出力ファイルが存在

結果： エディターにそのまま取り込めるナレーションファイルが完成します。

注意点
  • 長時間のジョブがシェルでタイムアウトする — ブロッキング呼び出しではなく CLI の非同期モード＋ポーリングを使用してください
組み合わせ： filesystem

一連のシーンを一括ナレーションする

👤 マルチシーンプロジェクトを扱うチーム ⏱ ~45 min intermediate

使うタイミング： 10 以上のシーンにシーンごとの台本があり、統一的にナレーションを生成したい場合。

フロー
  1. プロジェクト構造を走査する
    project/ 配下のすべての scene_*.mp4 と scene_*.md のペアを見つけ、それぞれのナレーションをキューに登録してください。✓ コピーしました
    → ペアの一覧とジョブキュー
  2. 直列または並列で実行する
    最大 3 ジョブを並列実行し、API の許容範囲に従ってレートリミットを適用してください。✓ コピーしました
    → 制御された並行処理
  3. 結果を報告する
    シーン名、ステータス、再生時間、出力パスのテーブルを作成してください。✓ コピーしました
    → 明確な完了テーブル

結果： プロジェクト全体が 1 回の実行でナレーションされ、ステータスが明確に示されます。

注意点
  • バッチ処理中に API リミットに到達する — 上流のレートリミットを遵守し、429 レスポンス時にはバックオフしてください
組み合わせ： filesystem

組み合わせ

他のMCPと組み合わせて10倍の力を

narrator-ai-cli-skill + filesystem

入力ファイルを自動検出し、構造化されたフォルダーに出力を配置する

project/ を走査し、すべてのシーンをナレーションして project/narrations/ に出力してください。✓ コピーしました
narrator-ai-cli-skill + claude-shorts-skill

claude-shorts で生成した Short クリップに AI ナレーションを追加する

レンダリング済みの各 Short に対してイントロのナレーションを生成し、ミックスしてください。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
cli-invocation inputs (video+script) + flags ナレーション実行のたびに使用 narrator-ai API usage
job-polling job id ジョブ送信後に使用 minimal
batch-orchestration list of jobs マルチシーンプロジェクトで使用 depends on batch size

コストと制限

運用コスト

APIクォータ
Narrator AI のティアに依存
呼び出しあたりのトークン
LLM トークン消費はわずか。実コストは API の使用時間
金額
Narrator AI による API 課金
ヒント
最終版の台本のみナレーションし、テキストの推敲は先に LLM で行ってください

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： Narrator AI API キーは環境変数で管理。インラインでの記述は厳禁
データ送信先： Narrator AI エンドポイント

トラブルシューティング

よくあるエラーと対処法

CLI command not found

narrator-ai-cli をインストールし、Claude Code の実行環境で PATH が通っていることを確認してください。

確認： which narrator-ai-cli
401 from Narrator API

NARRATOR_API_KEY（または CLI が要求する環境変数）を設定してください。

確認： env | grep NARRATOR

代替案

narrator-ai-cli-skill 他との比較

代替案代わりに使う場面トレードオフ
claude-shorts-skillナレーション単体ではなく、ロング動画からショート動画への完全なパイプラインが必要な場合パイプライン vs 単一機能

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る