GhostPeony/clip-finder

これは何？

主な機能

• 01タイムスタンプ付きリンクでYouTubeの字幕を意味検索
• 02チャンネル、プレイリスト、単一動画のインデックス化
• 03すでにインデックス化されている動画はスキップ
• 04認証不要のローカルモード、または複数ユーザーでログインできるSupabaseモード
• 05ブラウザー上でのBYOK、またはサーバー側での暗号化保存
• 06字幕のSRT形式でのダウンロードと最近の検索履歴

ユースケース

• 講義シリーズやチュートリアルチャンネルの長い動画から、特定の解説を探す
• すべての動画を視聴せずに、プレイリスト全体からトピックを検索する
• チームや個人のアーカイブ向けに、非公開の字幕検索環境をセルフホストする

クイックスタート

1. 1

   リポジトリをクローンする

   git clone https://github.com/GhostPeony/SearchTube.git
2. 2

   Pythonの仮想環境を作成し、バックエンドの依存関係をインストールする

   python -m venv venv venv\Scripts\activate pip install -r requirements.txt
3. 3

   フロントエンドの依存関係をインストールし、Gemini APIキーを記載した .env.local を作成する

   npm install
4. 4

   一方のターミナルでバックエンドを起動し、もう一方でフロントエンドを起動して、http://localhost:3001 を開く

   python backend/server.py npm run dev

使う前に知っておきたいこと

• !ローカルモードで埋め込みと検索を利用するには、Gemini APIキーが必要です。
• !セットアップ手順ではWindows固有のvenv有効化コマンドを使用しています。他のプラットフォームでは別の有効化コマンドが必要です。
• !字幕がない動画や、地域制限または年齢制限のある動画では、文字起こしを利用できません。

トピック

よくある質問

clip-finder とは？

YouTubeの字幕をセルフホストで意味検索し、チャンネルやプレイリスト、動画から該当箇所に移動できます。 SearchTubeは、チャンネル、プレイリスト、または単一の動画からYouTubeの字幕をインデックス化し、完全一致のキーワードではなく意味に基づいて検索できます。各検索結果には該当するタイムスタンプへのリンクがあり、関連するクリップにすぐ移動できます。

clip-finder は無料で使えますか？ライセンスは？

clip-finder は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

clip-finder は今もメンテナンスされていますか？

半年以内に更新あり。clip-finder の最終コミットは 2026年7月2日 です。

clip-finder は何に使えますか？

講義シリーズやチュートリアルチャンネルの長い動画から、特定の解説を探す すべての動画を視聴せずに、プレイリスト全体からトピックを検索する チームや個人のアーカイブ向けに、非公開の字幕検索環境をセルフホストする

clip-finder のインストール方法は？

リポジトリをクローンする: git clone https://github.com/GhostPeony/SearchTube.git Pythonの仮想環境を作成し、バックエンドの依存関係をインストールする: python -m venv venv venv\Scripts\activate pip install -r requirements.txt フロントエンドの依存関係をインストールし、Gemini APIキーを記載した .env.local を作成する: npm install 一方のターミナルでバックエンドを起動し、もう一方でフロントエンドを起動して、http://localhost:3001 を開く: python backend/server.py npm run dev

clip-finder はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/GhostPeony/clip-finder