yt-dlp-downloader

yt-dlp 動画ダウンローダー

yt-dlp を使って、数千ものウェブサイトから動画をダウンロードします。

前提条件

ダウンロードする前に、依存関係がインストールされていることを確認してください。

# Check yt-dlp
which yt-dlp || echo "yt-dlp not installed. Install with: pip install yt-dlp"

# Check ffmpeg (required for audio extraction and format merging)
which ffmpeg || echo "ffmpeg not installed. Install with: brew install ffmpeg"

インストールされていない場合は、先にインストールしてください。

pip install yt-dlp
brew install ffmpeg  # macOS

クイックスタート

基本的なダウンロード（最高画質）

yt-dlp -P "~/Downloads/yt-dlp" "VIDEO_URL"

YouTube のダウンロード（推奨：Cookie を使用）

YouTube では、403 エラーが発生して直接ダウンロードがブロックされることがよくあります。YouTube では必ずブラウザーの Cookie を使用してください。

yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "YOUTUBE_URL"

対応ブラウザー：chrome、firefox、safari、edge、brave、opera

出力先を指定してダウンロード

yt-dlp -P "/path/to/save" -o "%(title)s.%(ext)s" "VIDEO_URL"

よくあるタスク

1. 動画をダウンロード（デフォルト：最高画質）

yt-dlp -P "~/Downloads/yt-dlp" "VIDEO_URL"

2. 音声のみを抽出（MP3）

yt-dlp -P "~/Downloads/yt-dlp" -x --audio-format mp3 "VIDEO_URL"

3. 字幕付きでダウンロード

yt-dlp -P "~/Downloads/yt-dlp" --write-subs --sub-langs all "VIDEO_URL"

4. 画質を指定してダウンロード

720p：

yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" "VIDEO_URL"

1080p：

yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" "VIDEO_URL"

利用可能な最高画質：

yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo+bestaudio/best" "VIDEO_URL"

5. 利用可能な形式を一覧表示（ダウンロード前）

yt-dlp -F "VIDEO_URL"

その後、ID を指定して形式をダウンロードします。

yt-dlp -P "~/Downloads/yt-dlp" -f FORMAT_ID "VIDEO_URL"

6. プレイリストをダウンロード

# Download entire playlist
yt-dlp -P "~/Downloads/yt-dlp" -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" "PLAYLIST_URL"

# Download specific range (e.g., items 1-5)
yt-dlp -P "~/Downloads/yt-dlp" -I 1:5 "PLAYLIST_URL"

7. サムネイル付きでダウンロード

yt-dlp -P "~/Downloads/yt-dlp" --write-thumbnail "VIDEO_URL"

ワークフロー

ユーザーから動画の URL が提供された場合：

1. プラットフォームを特定します：

   • YouTube／YouTube Music → 必ず --cookies-from-browser chrome を使用します
   • その他のサイト → まず Cookie なしで試します

2. 希望する内容を確認します（指定されていない場合）：

   • 動画をダウンロードするだけですか？
   • 音声のみを抽出しますか？
   • 字幕が必要ですか？
   • 画質の指定はありますか？

3. 要件に基づいてコマンドを組み立てます

4. required_permissions: ["all", "network"] を指定し、Shell ツールを使用してダウンロードを実行します

5. エラーに対処します：

   • 403 Forbidden → --cookies-from-browser を付けて再試行します
   • 接続の問題 → yt-dlp は自動で再開するため、そのまま再試行します
   • 形式が利用できない → -F で形式を一覧表示してから選択します

6. 結果を報告します - ファイルの保存場所と、エラーがあればその内容を伝えます

やり取りの例

ユーザー：「帮我下载这个视频 https://www.youtube.com/watch?v=xxx」

応答：

# YouTube - use cookies to avoid 403 errors
yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "https://www.youtube.com/watch?v=xxx"

ユーザー：「下载这个视频的音频 https://www.bilibili.com/video/xxx」

応答：

# Bilibili - extracting audio as MP3
yt-dlp -P "~/Downloads/yt-dlp" -x --audio-format mp3 "https://www.bilibili.com/video/xxx"

ユーザー：「下载这个 Twitter 视频 https://twitter.com/xxx/status/123」

応答：

# Twitter/X - direct download usually works
yt-dlp -P "~/Downloads/yt-dlp" "https://twitter.com/xxx/status/123"

対応サイト

yt-dlp は、以下を含む数千ものサイトに対応しています。

• YouTube、YouTube Music
• Bilibili（B站）
• Twitter/X
• TikTok、Douyin（抖音）
• Vimeo
• Twitch
• その他多数…

全リスト：https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md

トラブルシューティング

よくあるエラーと解決方法

エラー	原因	解決方法
HTTP 403 Forbidden	YouTube が認証されていないリクエストをブロックしています	--cookies-from-browser chrome を使用します
動画を利用できません	地域制限または非公開です	Cookie または VPN を使用します
ダウンロードが中断されました	ネットワークの問題です	再試行します。yt-dlp が自動で再開します
形式を利用できません	指定した形式が存在しません	-F で形式を一覧表示します

エラー：「yt-dlp: command not found」

pip install yt-dlp

エラー：「ffmpeg not found」（音声抽出の場合）

brew install ffmpeg  # macOS

エラー：HTTP 403 Forbidden（YouTube）

これは YouTube で最もよく発生するエラーです。YouTube では必ず Cookie を使用してください：

# Recommended approach for YouTube
yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "YOUTUBE_URL"

対応ブラウザー：chrome、firefox、safari、edge、brave、opera

エラー：動画を利用できない、または地域制限がある

# Try with cookies from browser
yt-dlp --cookies-from-browser chrome "VIDEO_URL"

# Or use a specific format
yt-dlp -F "VIDEO_URL"  # List formats first
yt-dlp -f FORMAT_ID "VIDEO_URL"

エラー：ダウンロードが繰り返し失敗する

# Update yt-dlp to latest version
pip install -U yt-dlp

# Force IPv4 (sometimes helps with connection issues)
yt-dlp -4 "VIDEO_URL"

ベストプラクティス

1. YouTube のダウンロード：必ず --cookies-from-browser chrome を使用します
2. 大きなファイル：yt-dlp は自動で再開するため、中断された場合は再試行します
3. yt-dlp を最新の状態に保つ：pip install -U yt-dlp
4. 先に形式を確認する：不明な場合は、ダウンロード前に -F を使用します