mcpField
M
moneyprinterturbo-video

moneyprinterturbo-video

github.com/harry0703クリエイティブ・メディア136.1k209 回インストール今日更新
リポジトリ

moneyprinterturbo-video について

MoneyPrinterTurbo Video Generation は、トピックやスクリプトから動画を作成し、セットアップから MP4 の提供までを自動化するスキルです。ナレーション、字幕、音楽付きの中国語縦型動画を標準設定で作りたいユーザー向けです。

主な機能

  1. 01セットアップと生成の自動化
  2. 02既存設定の再利用
  3. 03中国語の 9:16 縦型動画が標準
  4. 04ナレーション、字幕、BGM
  5. 05MP4 ファイルの提供

活用シーン

  1. 01トピックからの動画生成
  2. 02スクリプトの動画化
  3. 03ナレーションと字幕付き縦型動画の作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/harry0703/moneyprinterturbo --skill moneyprinterturbo-video

インストール後、Claude Code で/moneyprinterturbo-videoを入力して読み込まれたか確認します。

同梱ファイルmpt_agent.py

詳細

MoneyPrinterTurbo による動画生成

ユーザーが指定するのは、動画のトピックまたはスクリプトだけです。インストール、設定の再利用、生成、完了待ち、最終的な MP4 の受け渡しまで自動で行います。手順やコマンドを提示するだけで終わらせないでください。

必須の動作

  1. 不足している、拒否された、または使用できない必須の API 認証情報だけをユーザーに尋ねてください。必須の認証情報はすべてまとめて一度に尋ねてください。
  2. インストール、生成、完了待ち、デフォルト設定の使用、結果の返却前に、確認を求めないでください。
  3. 標準的な生成リクエストに対して、詳細な計画を作成したり、繰り返し更新したりしないでください。短い進捗メッセージを一度だけ送り、実行してください。
  4. ヘルパーはタイムアウトを少なくとも 20 分に設定し、フォアグラウンドで単一のコマンドとして実行してください。
  5. sleep、echo、ps、ls の繰り返し、tail の繰り返しによるポーリングは行わないでください。ターミナルから再開可能なセッション ID が返された場合は、同じセッションで待機を続けてください。
  6. 成功後にログ全体を読み込まないでください。失敗した場合のみ、報告された短いエラーまたは関連ログの末尾を読み込んでください。
  7. API キー、トークン、config.toml 全体、認証情報を含む設定の断片は絶対に表示しないでください。

デフォルト設定

ユーザーから別の指定がない限り、Pexels の映像素材、デフォルトの中国語 Edge TTS 音声、字幕、BGM を使用して、中国語の 9:16 縦型動画を 1 本生成します。MoneyPrinterTurbo はユーザーのホームディレクトリにインストールしてください。

実行

1. ヘルパーの場所を特定する

この SKILL.md ファイルを基準に SKILL_DIR を特定してください。ヘルパーは同じディレクトリにある mpt_agent.py です。ターミナルツールの作業ディレクトリを SKILL_DIR に設定し、相対ファイル名でヘルパーを呼び出してください。コマンドにヘルパーの絶対パスを指定したり、追加の ls や dir による確認を行ったりしないでください。

一部のエージェントターミナル検証ツールでは、コマンドに埋め込まれた絶対パスのバックスラッシュが削除される場合があるため、Windows ではこれが必須です。workdir=SKILL_DIR と mpt_agent.py の使用により、この問題を回避でき、macOS と Windows の両方で動作します。

クライアントがリモートの SKILL.md だけを読み込んだ場合は、公式リポジトリからヘルパーを一時ディレクトリにダウンロードし、その一時ディレクトリをコマンドの作業ディレクトリとして使用してください。

https://raw.githubusercontent.com/harry0703/MoneyPrinterTurbo/main/docs/skill/mpt_agent.py
2. ヘルパーを実行する

個別に uv --version で事前確認しないでください。ヘルパーを直接実行してください。シェルに uv がないことが明示的に報告された場合は、uv をインストールしてから、同じヘルパーコマンドを一度だけ再試行してください。

macOS での uv のインストール：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows PowerShell での uv のインストール：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

workdir=SKILL_DIR を指定し、タイムアウトを少なくとも 20 分に設定して、フォアグラウンドで次のコマンドを実行してください。

uv run --no-project --python 3.11 python mpt_agent.py --subject "<video topic>"

Windows では、この相対パスのコマンドを実行する前に、バックスラッシュまたはスラッシュを使った絶対パスや、ワークスペース内のコピーを試さないでください。ターミナルツールから referenced_script_path_missing が報告された場合は、作業ディレクトリが正確に SKILL_DIR であることを確認し、相対パスのコマンドを一度だけ再試行してください。パスの別表記を次々と試さないでください。

Docker、Conda、システム pip、手動で管理する仮想環境は使用しないでください。

終了時の処理

終了コード 0：結果を返す

成功時の出力形式は次のとおりです。

MPT_RESULT
VIDEO_FILE=<absolute path>/final-1.mp4
TASK_DIR=<absolute path>/storage/tasks/<task_id>
LOG_FILE=<absolute path>/run-<task_id>.log
RESULT_FILE=<absolute path>/latest-result.json

mpt_agent.py は、ファイルの存在とサイズが 0 でないことを確認した後にのみ VIDEO_FILE を出力します。別途 ls、stat、ファイル検証コマンドを実行しないでください。

ターミナルから exitCode=0 と報告されたものの、出力が途中で切れているか、MPT_RESULT を含まない履歴ファイルへの参照が返された場合でも、失敗と推測したり、古いログを調べたりしないでください。次のファイルを一度だけ読み込んでください。

~/MoneyPrinterTurbo/.agent-logs/moneyprinterturbo-video/latest-result.json

status=completed は成功として扱ってください。絶対動画パスと簡潔な説明だけを返してください。例：

The video is ready.
Topic: ...
Video file: /absolute/path/to/final-1.mp4
Summary: Chinese portrait video with voice-over, subtitles, and background music.
終了コード 10：認証情報を一度だけ要求する

MPT_NEEDS_INPUT には、必須項目、推奨する LLM プロバイダーと登録リンク、OpenAI 互換のカスタム設定要件、および素材プロバイダーの登録リンクのみが含まれます。記載された値のみを尋ね、config.toml にすでにある認証情報は要求しないでください。

ユーザーの回答後、必要な環境変数のみを指定して、同じコマンドをフォアグラウンドで再実行します。

MPT_LLM_PROVIDER
MPT_LLM_API_KEY
MPT_LLM_BASE_URL
MPT_LLM_MODEL_NAME
MPT_PEXELS_API_KEY
MPT_VOLCENGINE_ARK_API_KEY
MPT_OFOX_API_KEY
MPT_METASO_MINIMAX_API_KEY
MPT_MUAPI_API_KEY
MPT_INFISTAR_VIDEO_API_KEY
MPT_JALAPENO_VIDEO_API_KEY

SEEDANCE_CHARGE_CONFIRMATION_REQUIRED が存在する場合、生成される Seedance のクリップごとに有料の Ark タスクが作成されることを説明します。ユーザーが明示的に確認した後にのみ、--confirm-seedance-charge を付けて再実行します。このフラグを黙って追加してはいけません。

WAVESPEED_CHARGE_CONFIRMATION_REQUIRED が存在する場合、生成される WaveSpeed のクリップごとに、WaveSpeed によってリクエスト単位で課金されることを説明します。ユーザーが明示的に確認した後にのみ、--confirm-wavespeed-charge を付けて再実行します。このフラグを黙って追加してはいけません。

OFOX_CHARGE_CONFIRMATION_REQUIRED が存在する場合、生成される OFox のクリップごとに有料タスクが作成されることを説明します。ユーザーが明示的に確認した後にのみ、--confirm-ofox-charge を付けて再実行します。このフラグを黙って追加してはいけません。

METASO_MINIMAX_CHARGE_CONFIRMATION_REQUIRED が存在する場合、生成される MiniMax H3 のクリップごとに有料の Metaso タスクが作成されることを説明します。ユーザーが明示的に確認した後にのみ、--confirm-metaso-minimax-charge を付けて再実行します。このフラグを黙って追加してはいけません。

MUAPI_CHARGE_CONFIRMATION_REQUIRED が存在する場合、生成される MuAPI のクリップごとに有料タスクが作成されることを説明します。ユーザーが明示的に確認した後にのみ、--confirm-muapi-charge を付けて再実行します。このフラグを黙って追加してはいけません。

INFISTAR_CHARGE_CONFIRMATION_REQUIRED が存在する場合、生成される Infistar のクリップごとに有料タスクが作成されることを説明します。ユーザーが明示的に確認した後にのみ、--confirm-infistar-charge を付けて再実行します。このフラグを黙って追加してはいけません。Infistar LLM キーとは別の専用動画キーを使用してください。

JALAPENO_CHARGE_CONFIRMATION_REQUIRED が存在する場合、生成される Jalapeno Cloud のクリップごとに有料タスクが作成されることを説明します。ユーザーが確認した後、--confirm-jalapeno-charge を付けて再実行します。動画キーが空の場合は、設定済みの Jalapeno Cloud LLM キーが再利用されます。専用動画キーがある場合は、そちらが優先されます。

終了コード 1：修復または報告

復旧可能な問題を修復して一度だけ再試行するには、MPT_ERROR と LOG_FILE を使用します。修復に新しい API キーが必要な場合に限り、ユーザーに尋ねます。再試行が失敗した場合は、失敗した段階、簡潔なエラー、およびログのパスを報告します。

ターミナルツールのパス検証エラーは、ヘルパーが起動していないため、動画生成の失敗ではありません。作業ディレクトリを修正し、相対コマンドを一度だけ再試行します。ユーザーに mpt_agent.py のコピーやコマンドの手動実行を求めたり、エージェントを続行するか確認したりしてはいけません。

設定とバックグラウンドへのフォールバック

ヘルパーは既存の設定を再利用するため、ローカルの config.toml 全体を読み取ることがありますが、その内容を表示してはいけません。動作する LLM プロバイダーを自動的に再利用し、生成前に認証済みの My Collections エンドポイントを通じて設定済みの Pexels キーを検証します。

エージェントプラットフォームがフォアグラウンドプロセスを待機できない場合に限り、バックグラウンドモードを使用します。ポーリングせずにプラットフォームからのプロセス完了通知を待ってから、latest-result.json を一度だけ読み取ります。

対象範囲

  • macOS と Windows のみをサポートします。
  • uv と MoneyPrinterTurbo CLI のみを使用します。
  • Docker、WebUI、API サービスを起動してはいけません。
  • 複数の動画ジョブを同時に実行してはいけません。
  • 追加の動画要件は -- の後に渡します。見慣れないオプションの確認が必要な場合に限り、cli.py --help を一度だけ実行します。

コメント

Markdown 対応