YouTube検索・ダウンロードツール (yt-search-download)

Tool
YouTube検索・ダウンロードツール (yt-search-download)

YouTube検索・ダウンロードツール (yt-search-download)

YouTubeの動画検索からダウンロード、字幕抽出、英語タイトルの自動翻訳までを行う軽量なツール。YouTube Data API v3で高度な検索（キーワード／時間／再生回数／関連度でソート）を行い、yt-dlpと連携して動画・音声（MP3）・字幕（SRT/TXT）を取得します。チャンネル内検索や最新動画の一覧取得、字幕の中英二言語出力、AI要約向けのテキスト抽出など、動画収集と前処理を一貫して自動化できる点が特徴です（インストールは npx を使うスキル形式）。前提として YouTube APIキーや yt-dlp/ffmpeg の導入が必要です。

https://github.com/joeseesun/yt-search-download

概要

yt-search-download は、YouTube の検索からダウンロード、字幕抽出、簡易翻訳までをワークフローとしてまとめたスクリプト群（Claude Code Skill）です。YouTube Data API v3 を用いた柔軟な検索機能（全体検索／チャンネル内検索、時間・再生数・関連度によるソート）で目的の動画を絞り込み、得られた動画IDを yt-dlp に渡して動画や最高画質の映像、音声（MP3）および字幕（SRT/TXT）を取得します。英語タイトルに対して自動で中文訳（中国語）を付与する機能があり、字幕は SRT（時間軸付き）と AI 処理向けの TXT（要約用）を生成可能です。npx を利用したスキル追加形式で手軽に導入でき、スクリプトは Python で実装されています。

GitHub

リポジトリの統計情報

  • スター数: 30
  • フォーク数: 5
  • ウォッチャー数: 30
  • コミット数: 5
  • ファイル数: 4
  • メインの言語: Python

主な特徴

  • YouTube Data API v3 による高度検索（キーワード／時間／再生数／関連度）
  • yt-dlp と連携した動画／音声（MP3）／字幕（SRT/TXT）取得
  • チャンネル内検索や最新動画の一覧取得機能
  • 英語タイトルの自動中文翻訳、二言語対応の字幕出力

技術的なポイント

yt-search-download は「検索（YouTube Data API） → ダウンロード（yt-dlp） → 後処理（字幕整形・翻訳）」という明確なパイプライン設計を採用しています。検索フェーズでは YouTube Data API v3 を用いてクエリベースの全体検索や特定チャンネル内検索を実行し、検索条件に応じて publishTime（時間フィルタ）や viewCount（再生数）などでソートした結果を取得します。取得したレスポンスから動画IDを抽出し、次段のダウンロードフェーズに渡します。

ダウンロードフェーズは yt-dlp に委ねられており、動画の最高画質（最大 4K など）や音声抽出（MP3）を指定可能です。mp3 生成やフォーマット変換には ffmpeg が必要になる点が一般的な運用上の前提となるため、README でも前提環境として明示するのが自然です。字幕取得では yt-dlp の字幕取得機能を活用して SRT（時間軸付き）と TXT（テキストのみ）を生成し、TXT は AI による要約や解析に適した形式で保存する設計になっています。

もう一つの注目点は「自動翻訳」機能です。英語タイトルに対して自動的に中文（中国語）訳を付与しておくことで、検索結果を多言語で扱うワークフローに適合します。README に詳細実装は明示されていませんが、翻訳は内部ライブラリか外部翻訳APIを呼ぶ形で実装されていると推測できます（運用時は翻訳 API の認証やレート制限に注意が必要です）。

運用面では、YouTube Data API のクォータ制限や yt-dlp の更新（YouTube 側の仕様変更への追随）が課題になります。API キーの管理、クォータ消費の最適化（必要なフィールドだけ取得する、検索頻度の制御など）、およびダウンロード失敗時のリトライやログ出力などの堅牢性向上が実用化時の重要ポイントです。また、npx skills add で導入するスキル形式は素早い試用に向きますが、本番用途ではローカル環境依存の依存関係（yt-dlp・ffmpeg・Python バージョン等）をドキュメント化しておくことが推奨されます。

設計面では責務分離が明確で、拡張性も高いです。例えば検索モジュールを別の検索APIに差し替えたり、ダウンロード後のメタデータ抽出や自動タグ付け、字幕の機械翻訳を改良して多言語対応を広げるといった発展が容易です。CI／デプロイを追加して定期的にチャンネル内の新着をチェックするような自動化も実装しやすく、データ収集〜解析〜アーカイブまでのワークフローに統合できます。

プロジェクトの構成

主要なファイルとディレクトリ：

  • LICENSE: file
  • README.md: file
  • SKILL.md: file
  • scripts: dir

まとめ

YouTube の検索からダウンロード、字幕・翻訳までをワンストップで行える実用的なツール。導入は簡単だが API と依存ツールの管理に注意。

リポジトリ情報：

READMEの抜粋：

yt-search-download

YouTube 视频搜索、下载、字幕提取工具 — Claude Code Skill

基于 YouTube Data API v3 进行高级搜索，配合 yt-dlp 下载视频/音频/字幕，自动翻译英文标题为中文。

功能

  • 搜索：全站关键词搜索，支持按时间 / 播放量 / 相关度排序
  • 频道浏览：浏览指定频道最新视频，支持频道内关键词搜索
  • 下载视频：支持多种画质（最高 4K），指定保存目录
  • 提取音频：一键下载 MP3
  • 下载字幕：自动生成 SRT（带时间轴）+ TXT（供 AI 总结），支持中英双语
  • 中文翻译：搜索结果为英文时自动附加中文译名，无需额外操作
  • 视频详情：查询时长、播放量、简介等元数据

安装

npx skills add joeseesun/yt-search-download

前置条件

  1. YouTube API Key：[Google Cloud Console](https://con…