mcpField
R
ra-video-download

ra-video-download

github.com/pluviobyteクリエイティブ・メディア1.7k172 回インストール5 週間前に更新
リポジトリ

ra-video-download について

ra-video-downloadは、コンテンツ制作で参照用の動画素材を取得するスキルです。付属のダウンローダーを実行し、再生可能か確認したうえで、出典情報の保存とファイルの上書き防止を行います。

主な機能

  1. 01動画または音声のみをダウンロード
  2. 02対応サイトに応じて方式を選択
  3. 03再生可能なストリームと長さを確認
  4. 04出典情報を保存し上書きを防止

活用シーン

  1. 01制作参考用のショート動画を取得
  2. 02プロジェクトで承認された素材をダウンロード
  3. 03取得ファイルを検証して媒体情報を記録

インストール

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

$npx skills add https://github.com/pluviobyte/rnskill --skill ra-video-download

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

同梱ファイルagents/openai.yamlscripts/download_media.py

詳細

動画のダウンロード

ソースメディアのみをダウンロードしてください。文字起こし、書き換え、編集、公開はしないでください。

保存ルール

  • ソース URL、ソースタイトル、ソースメタデータ、ダウンロードした参照メディアは、デフォルトで 01-内容生产/视频工作台/.internal/ に保存してください。
  • 呼び出し元が制作プロジェクトを明示し、メディアが承認済みの制作素材である場合に限り、01-内容生产/视频工作台/制作中/<日期-主题>/原始素材/ を使用してください。
  • 引き継ぎ資料、完成した台本、最終アーカイブ、公開文書には、ソース情報を記載しないでください。
  • 既存ファイルを上書きしないでください。ダウンローダーに一意のサフィックスを追加させるか、処理を中止してください。

ワークフロー

  1. URL がソースメディアであること、およびダウンロードがユーザーの依頼範囲内であることを確認します。
  2. 同梱のダウンローダーを実行します。次の順序で使用します。
    • Douyin：TikHub のメディア URL、次にブラウザー Cookie を使った yt-dlp、最後に通常の yt-dlp。
    • その他の対応サイト：通常の yt-dlp。必要に応じてブラウザー Cookie を使用できます。
  3. 返されたローカルパスとメディアのプローブ結果を確認します。HTTP レスポンスが成功しただけでは、ダウンロード完了とはみなせません。
  4. 再生可能な音声または動画ストリームがあり、再生時間がゼロでないことを確認します。ローカルパス、再生時間、解像度、選択したダウンロード方法を報告してください。
  5. すべての方法が失敗した場合は、簡潔な失敗ログを保持し、不足している前提条件を明示してください。動画をダウンロードしたと報告してはいけません。

コマンド

Douyin の最適なダウンロード方法を使うため、tikhub をインポートできる Python インタープリターを使用してください。このワークスペースでは、利用可能な場合は /opt/homebrew/bin/python3 を優先してください。

/opt/homebrew/bin/python3 scripts/download_media.py '<url>'

便利なオプション：

# Explicit production input directory
/opt/homebrew/bin/python3 scripts/download_media.py '<url>' --output-dir '01-内容生产/视频工作台/制作中/<日期-主题>/原始素材/<项目>'

# Extract audio only
/opt/homebrew/bin/python3 scripts/download_media.py '<url>' --audio-only

# Use an authenticated browser profile for a protected public page
/opt/homebrew/bin/python3 scripts/download_media.py '<url>' --cookies-from-browser chrome

現在のディレクトリがスキルのディレクトリだと仮定せず、SKILL.md を基準に scripts/download_media.py の場所を解決してください。

安全性と失敗時の対応

  • ブラウザー Cookie は、依頼された公開メディアにのみ使用してください。Cookie の生データを表示、コピー、保存してはいけません。
  • 環境変数またはワークスペースのルートにある .env から TIKHUB_API_KEY を読み取ってください。表示してはいけません。
  • 非公開アカウントのアクセス制御、有料コンテンツ、DRM、削除済みまたは非公開のメディアを回避してはいけません。
  • TikHub とブラウザー Cookie は取得時の代替手段として扱い、再利用権の証明とはみなさないでください。
  • ダウンロード後も、元のソースファイルには手を加えないでください。
  • ffprobe が失敗した場合は、拡張子が .mp4 であってもファイルを拒否してください。

引き継ぎ

次の内容を含む簡潔な結果を返してください。

  • ローカルメディアのパス
  • ソースメタデータのパス
  • 使用した方法（tikhub、yt-dlp-cookie、または yt-dlp）
  • 再生時間、解像度、コーデック
  • 透かし、音声の欠落、認証失敗などの制約

その後の処理は、依頼された場合に限り、ソース音声の抽出には ra-逐字稿提取skill、編集には video-use、制作には ra-video-production-director に引き継いでください。

コメント

Markdown 対応