mcpField
M
media-downloader

media-downloader

github.com/yizhiyanhua-aiクリエイティブ・メディア403594 回インストール39 週間前に更新
リポジトリ

media-downloader について

Media Downloaderは、画像や動画素材を検索・ダウンロードするスキルです。キーワード検索に加え、YouTube動画のダウンロードや指定区間の切り出しにも対応します。

主な機能

  1. 01画像素材の検索とダウンロード
  2. 02動画クリップの検索とダウンロード
  3. 03YouTube動画または音声の取得
  4. 04指定区間への動画トリミング
  5. 05中国語と英語の指示に対応

活用シーン

  1. 01デザイン向けの画像素材を取得
  2. 02短い背景動画を探す
  3. 03YouTube動画の指定区間を切り出す
  4. 04YouTube動画から音声を抽出

インストール

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

$npx skills add https://github.com/yizhiyanhua-ai/media-downloader --skill media-downloader

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
.gitignore
README_CN.md
media_cli.py

詳細

🎬 メディアダウンローダー / インテリジェントメディアダウンローダー

欲しいものを伝えるだけで、関連する画像や動画を見つけてダウンロードします！

欲しいものを伝えるだけで、関連する画像や動画を見つけてダウンロードします！

🚀 できること / できること

あなたのリクエスト... / あなたのリクエスト...実行すること... / 実行すること...
"Download some cute cat pictures"猫の画像を5枚検索してダウンロードします
"Download sunset photos"夕焼けの画像を検索してダウンロードします
"Find a video of ocean waves, around 15 seconds long"15秒の海の波の動画をダウンロードします
"Get me a 30-second cooking video"料理動画をトリミングしてダウンロードします
"Download this YouTube video's 1:30-2:00"指定した区間をダウンロードして自動で編集します

✨ 特長 / 特長

  • 🖼️ 画像のダウンロード - 専門の画像サイトから高解像度の画像を検索します
  • 🎬 動画素材 - 商用利用可能な無料動画クリップを取得します
  • 📺 YouTube のダウンロード - ダウンロードと編集に対応しています
  • ✂️ スマート編集 - 必要な長さに自動でトリミングします
  • 🌍 中国語と英語に対応 - 中国語と英語の指示に対応しています

📋 スキルの実行ロジック / スキルの実行ロジック

🔑 API Key のオンデマンド設定 / オンデマンドの API Key 設定

重要：ユーザーのインストール時に API Key の設定を求めないでください！以下のロジックに従ってください。

  1. ユーザーが YouTube 動画をダウンロードする場合：そのまま実行します。API Key は不要です
  2. ユーザーが初めて画像をダウンロードする場合：
    • 環境変数 PEXELS_API_KEY が設定されているか確認します
    • 設定されていない場合、ユーザーに設定方法を案内します： 
      画像サイトの API Key がまだ設定されていません。画像のダウンロードには無料の API Key が必要です。

以下の手順で設定してください：
1. https://www.pexels.com を開き、Join をクリックして登録します（Google／Apple を使ったワンクリック登録に対応しています）
2. 登録後、https://www.pexels.com/api/ にアクセスして、Your API Key をクリックします
3. 表示されたキーをコピーして、こちらに貼り付けてください
    • ユーザーから API Key を受け取ったら、システム環境変数に保存します： 
      echo 'export PEXELS_API_KEY="ユーザーのキー"' >> ~/.zshrc && source ~/.zshrc
    • その後、画像のダウンロードを続行します
🎬 YouTube のダウンロードを優先 / YouTube を優先

ユーザーがダウンロード元を指定せずに「動画をダウンロード」と言った場合は、YouTube を優先して案内します：

  • YouTube には API Key が不要です
  • コンテンツがより豊富です
  • 時間範囲を指定したトリミングに対応しています

💬 使用例 / 使用例

画像のダウンロード / 画像のダウンロード
"帮我下载 5 张星空的图片"
"Download 10 coffee shop photos"
"找一些适合做壁纸的风景图"
動画クリップのダウンロード / 動画クリップのダウンロード
"下载一段城市夜景的视频，30秒以内"
"Find me a 15-second ocean wave video"
"找一些适合做背景的自然风光视频"
YouTube のダウンロードとトリミング / YouTube のダウンロードとトリミング
"下载这个视频：https://youtube.com/watch?v=xxx"
"下载这个 YouTube 视频的第 2 分钟到第 3 分钟"
"只下载这个视频的音频"

📁 ダウンロード先 / ダウンロード先

すべてのファイルはデフォルトで以下に保存されます：

~/.claude/skills/media-downloader/downloads/

❓ よくある質問 / よくある質問

Q: 画像を検索しても結果が表示されないのはなぜですか？

A: API Key が設定されていることを確認してください。status コマンドを実行して設定状態を確認します。

Q: YouTube 動画のダウンロードに失敗するのはなぜですか？

A: YouTube のダウンロードに API Key は不要ですが、yt-dlp のインストールが必要です。pip install yt-dlp を実行してインストールしてください。

Q: 動画の編集機能が動作しないのはなぜですか？

A: ffmpeg のインストールが必要です。macOS ユーザーは brew install ffmpeg を実行してください。

Q: これらの画像や動画は商用利用できますか？

A: Pexels、Pixabay、Unsplash の素材は、クレジット表記なしで無料で商用利用できます（クレジットを記載するのが望ましいです）。

🛠️ CLI コマンドリファレンス / CLI リファレンス

上級ユーザーはコマンドラインから直接使用できます：

# 检查配置状态
media_cli.py status

# 下载图片
media_cli.py image "关键词" -n 数量 -o 输出目录

# 下载视频素材
media_cli.py video "关键词" -d 最大时长 -n 数量

# 下载 YouTube 视频
media_cli.py youtube "URL" --start 开始秒数 --end 结束秒数

# 搜索媒体（不下载）
media_cli.py search "关键词" --type image/video/all

# 剪辑本地视频
media_cli.py trim 输入文件 --start 开始 --end 结束

📦 対応する素材の提供元 / 対応する素材の提供元

提供元種類特長
Pexels画像 + 動画高品質で、更新が速い
Pixabay画像 + 動画数が多く、種類も豊富
Unsplash画像芸術性が高く、壁紙に適しています
YouTube動画コンテンツが豊富で、編集に対応しています

🎬 さっそく使ってみましょう！欲しい画像や動画を伝えてください！

🎬 さっそく使ってみましょう！欲しい画像や動画を伝えてください！

コメント

Markdown 対応