mcpField
D
download-video

download-video

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

download-video について

download-videoは、yt-dlpでYouTube、Bilibili、Twitter/X、TikTokなどから動画や音声をダウンロードするスキルです。ラッパースクリプトに加え、主なオプションとトラブルシューティング情報を提供します。

主な機能

  1. 011000以上のサイトからダウンロード
  2. 02音声をMP3で保存
  3. 03動画の解像度を制限
  4. 04利用可能な形式を表示
  5. 05字幕をダウンロード
  6. 06ブラウザーのCookieを使用

活用シーン

  1. 01対応サイトの動画を保存
  2. 02動画から音声を抽出
  3. 03字幕付きでダウンロード
  4. 04ログイン要件や年齢制限に対応

インストール

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

$npx skills add https://github.com/feiskyer/video-skills --skill download-video

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

同梱ファイルreferences/platform-tips.mdscripts/download.py

詳細

動画をダウンロード

yt-dlp を使って、YouTube、Bilibili、Twitter/X、TikTok など、1000 以上のサイトから動画をダウンロードします。

ステップ 1：前提条件を確認する

which yt-dlp && yt-dlp --version
which ffmpeg

yt-dlp が見つからない場合は、インストールします。

# macOS
brew install yt-dlp ffmpeg

# Cross-platform
pip install yt-dlp

ステップ 2：ダウンロードする

同梱のスクリプトを使います。yt-dlp を適切なデフォルト設定とわかりやすいエラーメッセージで実行できます。

python3 scripts/download.py "VIDEO_URL"

デフォルトの出力先：~/Downloads/Videos/

よく使うオプション
python3 scripts/download.py "URL" -f 1080            # Max 1080p
python3 scripts/download.py "URL" -a                  # Audio only (MP3)
python3 scripts/download.py "URL" -F                  # List formats
python3 scripts/download.py "URL" --subs              # With subtitles
python3 scripts/download.py "URL" -o ~/Desktop        # Custom output dir
python3 scripts/download.py "URL" --cookies chrome    # Use browser cookies
yt-dlp の直接コマンド

スクリプトで対応できない場合は、yt-dlp を直接使います。

# Download playlist
yt-dlp -P ~/Downloads/Videos "PLAYLIST_URL"

# Custom filename template
yt-dlp -o "%(uploader)s - %(title)s.%(ext)s" "VIDEO_URL"

# Download with subtitles in specific languages
yt-dlp --write-subs --sub-lang zh,en -P ~/Downloads/Videos "VIDEO_URL"

トラブルシューティング

ダウンロードの失敗は、ほとんどの場合、次のカテゴリに分類されます。

症状対処方法
「サインインが必要」または年齢制限付き--cookies chrome を追加して、ブラウザーのセッションを使用します
低画質しか利用できないyt-dlp を更新し（brew upgrade yt-dlp）、その後 --cookies chrome を付けて試します
ダウンロードが遅い--concurrent-fragments 3 または --downloader aria2c を試します
ネットワークエラー（ファイアウォールの背後）--proxy socks5://127.0.0.1:1080 を使うか、ALL_PROXY 環境変数を設定します

プラットフォーム固有の詳細（YouTube PO トークン、Bilibili のシリーズ、TikTok の透かし除去など）については、references/platform-tips.md を参照してください。

コメント

Markdown 対応