youtube-downloader

YouTube 動画ダウンローダー

初めて利用する場合：上記の setup_complete: false の場合は、まず ./SETUP.md を実行し、その後 setup_complete: true に設定してください。

WhatsApp やその他のプラットフォームで共有しやすいよう最適化された、品質を選択できる YouTube 動画ダウンローダーです。

必要条件

このスキルを利用するには、システムに Python がインストールされている必要があります。

• Python 3.9 以降（必須）
• yt-dlp（pip install yt-dlp）
• ffmpeg（音声の抽出用）

初めてセットアップする場合：Windows、macOS、Linux 向けの詳細なインストール手順については、SETUP.md をお読みください。

クイックスタート

cd ~/.claude/skills/youtube-downloader/scripts

# Download for WhatsApp (144p, small file)
python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --quality whatsapp

# Download standard quality (480p)
python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --quality standard

# Download high quality (720p)
python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --quality high

# Download best quality available
python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --quality best

# List available formats
python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --list

品質プリセット

プリセット	解像度	最大サイズ	用途
whatsapp	144p	約10MB	WhatsApp での共有（デフォルト）
standard	480p	約50MB	一般用途
high	720p	約100MB	高画質
best	利用可能な最高画質	変動	最高画質

オプション

オプション	説明
--quality / -q	品質プリセット（whatsapp/standard/high/best）
--output / -o	出力ディレクトリ（デフォルト：現在のディレクトリ）
--list / -l	ダウンロードせずに利用可能な形式を一覧表示
--audio-only / -a	音声のみを抽出（MP3）

使用例

# Download and send to WhatsApp
python download.py "https://youtube.com/watch?v=xxx" -q whatsapp
# Then use WhatsApp skill to send

# Download to specific folder
python download.py "https://youtube.com/watch?v=xxx" -o ~/Downloads

# Audio only (for podcasts/music)
python download.py "https://youtube.com/watch?v=xxx" --audio-only

WhatsApp のサイズ制限

• 16MB：動画を直接共有する場合の上限
• 2GB：画質を維持できるドキュメント共有の上限

16MB を超える動画の場合は、次のいずれかを選択してください。

1. 低い品質プリセットを使用する
2. 動画ではなくドキュメントとして送信する