mcpField
V
video-downloader

video-downloader

github.com/davepoonクリエイティブ・メディア3.7k48 回インストール1 日前に更新
リポジトリ

video-downloader について

video-downloaderは、YouTubeの単一動画を画質や形式を選んでダウンロードし、音声のみをMP3で取得できるコマンドラインスキルです。yt-dlpを使い、指定されたYouTubeホストのHTTPS URLのみを受け付けます。

主な機能

  1. 01動画画質の選択
  2. 02MP4、WebM、MKV形式
  3. 03MP3音声のみのダウンロード
  4. 04出力先ディレクトリの指定
  5. 05HTTPSとYouTubeホストの検証

活用シーン

  1. 01指定した解像度でYouTube動画を保存
  2. 02YouTube動画から音声を抽出
  3. 03動画ダウンロード形式の選択
  4. 04指定ディレクトリへのダウンロード保存

インストール

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

$npx skills add https://github.com/davepoon/buildwithclaude --skill video-downloader

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

同梱ファイル.gitignorescripts/download_video.py

詳細

YouTube 動画ダウンローダー

品質や形式の設定を細かく指定して、YouTube 動画をダウンロードできます。

クイックスタート

動画をダウンロードする最も簡単な方法：

python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"

利用可能な最高品質の動画を MP4 形式で /mnt/user-data/outputs/ にダウンロードします。

オプション

品質設定

-q または --quality を使用して、動画の品質を指定します：

  • best（デフォルト）：利用可能な最高品質
  • 1080p：フル HD
  • 720p：HD
  • 480p：標準画質
  • 360p：低画質
  • worst：利用可能な最低品質

例：

python scripts/download_video.py "URL" -q 720p
形式オプション

-f または --format を使用して、出力形式を指定します（動画のダウンロードのみ）：

  • mp4（デフォルト）：最も互換性の高い形式
  • webm：新しい形式
  • mkv：Matroska コンテナー

例：

python scripts/download_video.py "URL" -f webm
音声のみ

-a または --audio-only を使用して、音声のみを MP3 形式でダウンロードします：

python scripts/download_video.py "URL" -a
出力ディレクトリの指定

-o または --output を使用して、別の出力ディレクトリを指定します：

python scripts/download_video.py "URL" -o /path/to/directory

使用例

  1. 動画を 1080p の MP4 形式でダウンロード：
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
  1. 音声のみを MP3 形式でダウンロード：
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
  1. 動画を 720p の WebM 形式でカスタムディレクトリにダウンロード：
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path

対応 URL

  • HTTPS のみ — http:// リンクは拒否されます。
  • YouTube のホストのみ — 許可されるホスト名は、youtube.com（www、m、music などのサブドメインを含む）、youtu.be、youtube-nocookie.com（www を含む）です。それ以外のサイトは拒否されます。

yt-dlp のインストール

このスクリプトは、システムの Python にパッケージをインストールしません（--break-system-packages は使用しません）。

  1. yt-dlp が PATH 上にある場合は、それを使用します。
  2. それ以外の場合は、video-downloader/.venv にローカルの仮想環境を作成し、pip でそこに yt-dlp をインストールして、そのバイナリを実行します。
  3. 仮想環境の作成またはインストールに失敗した場合は、表示されたメッセージに従うか、たとえば pipx install yt-dlp、brew install yt-dlp、またはお使いの OS のパッケージマネージャーを使って、グローバルにインストールしてください。

.venv ディレクトリは Git の追跡対象外で、スキルのフォルダー内に保持されます。

動作の仕組み

このスキルは、堅牢な YouTube ダウンローダーである yt-dlp を使用します。次の処理を行います。

  • 前述のとおり、PATH またはスキル内の .venv を使って yt-dlp を見つけます
  • ダウンロード前に動画情報を取得します
  • 条件に合う利用可能な最適なストリームを選択します
  • 必要に応じて動画ストリームと音声ストリームを結合します
  • 幅広い YouTube 動画形式に対応します

重要な注意事項

  • ダウンロードしたファイルは、デフォルトで /mnt/user-data/outputs/ に保存されます
  • 動画のファイル名は、動画タイトルをもとに自動生成されます
  • ダウンロードされるのは単一の動画のみです（デフォルトでは再生リストはスキップされます）
  • 高画質の動画はダウンロードに時間がかかり、より多くのディスク容量を使用する場合があります

コメント

Markdown 対応