VidLens
あなたのAIはウェブを読めます。
今度は、それを「見る」こともできます。
npx vidlens-mcp setup動画リサーチ: YouTubeや公開ソーシャル動画を検索・文字起こし・比較・引用できます。
ローカルライブラリを構築: 一度インポートすれば、同じ動画を再度取得することなく、文字起こし、コメント、フレーム、OCRを検索できます。
視覚的エビデンスの検査: 正確なフレーム、タイムスタンプ、一致理由、出典を、ビジュアルギャラリーと構造化されたクライアント出力の両方で確認できます。
VidLensは、あなたのAIエージェントに動画を見る目を与えるMCPサーバーです — YouTube、X、TikTok、Instagram、その他の動画ページ、またはディスク上のファイルに対応します。リンクを貼り付けて質問してください。VidLensは文字起こしを読み、フレームを調べ、確認できるタイムスタンプ付きの回答を返します。取り込んだものはすべて自分のマシン上のライブラリに保存されるため、エージェントが同じ動画を二度見る必要はありません。
開始にAPIキーは不要です。Claude Desktop、Claude Code、Codexで動作します。対応クライアントは、VidLensの構造化された結果を、独自のレスポンス画面でネイティブなチャート、カード、テーブル、ビジュアルレポートに変換できます。
VidLensの動作を見る
Related MCP server: @kirbah/mcp-youtube
試してみる
VidLensのセットアップが完了したら、以下のいずれかをAIクライアントに貼り付けてください:
"Search YouTube for M5 Max MacBook Pro reviews. What do reviewers agree on, and where do they disagree?"
VidLensが検索し、各レビュアーの文字起こしを読み、出典とタイムスタンプ付きで一致点と相違点を統合します。
"Transcribe this video and summarize it: https://x.com/username/status/123..."
X、Instagram、TikTokの公開動画URLが1つあれば、通常はAPIキーは一切不要です。VidLensが取得して文字起こしし、その文字起こしを保存するので、後でフォローアップの質問ができます — このセッションでも、将来のセッションでも。
"Find the frame in this video where they show the benchmark chart."
ビジュアル検索は、画面に映っているもの — スライド、チャート、ホワイトボード、製品ショット — を調べ、テキストによる推測だけでなく、実際のフレーム画像をタイムスタンプ付きでローカルブラウザのギャラリーに表示します。
ネイティブクライアントでの表示
VidLensは、移植可能な構造化エビデンスを返します: 出典、タイムスタンプ、スコア、OCR、説明、来歴、制限事項です。Codex、Claude、その他の対応クライアントは、そのエビデンスを独自のネイティブなチャート、比較カード、テーブル、ビジュアルレポートに組み立てられます。
表示は、埋め込まれたVidLens UIではなく、クライアントに属します。抽出したフレームの検査には、searchVisualContent がブラウザギャラリーを開くこともできます。
仕組み
左側から動画ソースが入ります。VidLensは、動作する経路 — キーが設定されている場合はYouTube API、yt-dlp、または直接のページ抽出 — を通じて取り込み、結果をローカルライブラリに保存します: 文字起こし、フレーム、埋め込みベクトルです。あなたのエージェントは、任意のMCPクライアントからそのライブラリをクエリします。
2つの誠実性の保証が組み込まれています:
フォールバックであって、失敗ではない。 すべてのYouTubeデータツールは、諦める前に複数の経路を試すため、キーがなくても、クォータを使い果たしても、壊れるのではなく優雅に劣化します。
レスポンスに来歴を付与。 ツールのレスポンスは、どの経路がデータを提供したか、何かが部分的だったかを報告します。黙って劣化することはありません。
すべてはディスク上の1つのディレクトリに格納されます。外部データベースもDockerも不要です。コピーすればバックアップになり、削除すれば最初からやり直せます。
インストール
セットアップウィザード (推奨)
npx vidlens-mcp setupウィザードはClaude Desktop、Claude Code、Codexを検出し、VidLensが必要とするローカル依存関係をチェックし、1つのシンプルな選択肢を提示します:
無料セットアップ (推奨): APIキー不要。YouTube検索、文字起こし、メタデータ、ローカルライブラリがすぐに動作します。
拡張セットアップ: オプションのAPI、音声認識、ウェブ検索、ブラウザCookieを1つずつ追加できます。不要なものはEnterキーでスキップできます。保存された値は保持され、表示されることはありません。
Enterキーで無料を選択するか、拡張機能が必要なときはいつでも npx vidlens-mcp setup --enhanced を実行してください。Claude Codeの場合、セットアップはユーザーMCPレジストリへのVidLens登録、共有VidLensワークフロースキルのインストールも行い、可能な場合は claude mcp list で結果を確認します。
手動設定
Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json に追加:
{
"mcpServers": {
"vidlens-mcp": {
"command": "npx",
"args": ["-y", "vidlens-mcp", "serve"]
}
}
}Claude Code — ウィザードを推奨:
npx vidlens-mcp setup --client claude_code
claude mcp list手動で設定する場合は、同じ mcpServers.vidlens-mcp エントリを ~/.claude.json に追加してください。
Codex — MCPサーバーと同梱のVidLensスキルが一緒に登録されるよう、セットアップヘルパーを使用:
npx vidlens-mcp setup --client codexクライアントを再起動
Claude Desktopを完全に終了して再度開きます (⌘Q。ウィンドウを閉じるだけでは不十分です) — MCPサーバーは起動時に読み込まれます。Claude Codeの場合は、新しいセッションを開始するか、セットアップ後に /mcp を実行してください。
ローカルチェックアウトから
チェックアウトでの npm install は、バイナリを PATH に配置しません。チェックアウトから npm run setup を使用するか、開発中に素の vidlens-mcp コマンドが必要な場合は npm install -g . / npm link を使用してください。
あなたのライブラリ
Vidlensは、セッションごとのスクラッチパッドではなく、動画作業のための永続的なメモリです。インポートしたものはすべて VIDLENS_DATA_DIR の下のディスクに永続化されます: 文字起こしコレクション、コメントコレクション、ダウンロードしたメディア、ビジュアルインデックスです。アクティブなコレクションも記憶されます。
1回の呼び出しで呼び戻す。 セッションの開始時に、recallWorkspace は保存済みのすべてのコンパクトなダイジェストを返すため、エージェントは再検索や再インポートの前に何を持っているかを把握できます。ツールの説明には同じリマインダーがすべてのクライアントに伝わるため、エージェントは再取得する代わりにまず確認します。
URLまたはアセットキーで再利用。 インポートしたソーシャル動画の文字起こしは、元のURLまたはアセットキーで再度取得できます — 再ダウンロードも再文字起こしも不要です。
エージェント間で共有される1つのライブラリ。 デフォルトのデータディレクトリはすべてのクライアントで同じであるため、Claude Desktop、Claude Code、Codexはすべて1つのライブラリを共有します — あるクライアントで動画をインポートし、別のクライアントから検索できます。
⚠️
VIDLENS_DATA_DIRをDropbox、iCloud、Google Drive、その他のファイル同期フォルダ内に置かないでください。 VidLensはSQLite (WAL使用) を使用しており、ファイル同期ツール配下のライブデータベースは破損したり、競合コピーが生成されたりします。データディレクトリはローカルディスクに置いてください — デフォルトの場所はすでにそうなっています。
YouTubeを超えて
X、Instagram、TikTok、一般的な動画ページでは、VidLensは能力ラダーを使用します: 動作する最も安価な経路を選び、APIキーは前提条件ではなく強化策です。
経路 | コスト | 最適な用途 | 動作 |
ローカル再利用 | 無料 | 以前にインポートしたもの |
|
公開ダイレクトURL | 無料 | Xのステータス、Instagramのリール/投稿、TikTok動画1件 | yt-dlpが正規の投稿URLを匿名で試します。キャプションのないメディアはffmpegとローカルまたは設定済みのSTTが処理します |
ブラウザ支援 | 対応ホストなら無料 | 投稿の検索・確認、または既存のサインイン済みセッションの利用 | クライアントのブラウザ制御が正規のURLと表示メタデータを取得し、URLをVidLensに返します |
ローカルファイル受け渡し | 無料 | 保存が許可されている動画 | 保存したファイルを文字起こしとビジュアルインデックスのためにインポートします |
API強化 | プロバイダー料金 | 大量・無人・反復的な発見 | 設定済みのScrapeCreators、Brave、SerpAPI、YouTube、Gemini、OpenAI機能が自動的に選択されます |
3つの注意点を明確に述べます:
ブラウザ支援はホストレベルです。 MCPサーバー自体はブラウザを制御しません。クライアントが提供するブラウザツールに依存しており、ホストによって異なります。
動画を見られることと、書き出せることは同じではありません。 ブラウザで再生できる投稿が、自動的なメディア書き出しを保証するわけではありません。
具体的なURLのみ。 VidLensは特定の投稿または動画URLのみをインポートします。プロフィール、探索ページ、ハッシュタグ、人気ページは対象外です。
単純なダウンロードを超えたソーシャルおよびローカル動画作業には、ffmpegをインストールしてください (macOSでは brew install ffmpeg) — フレーム抽出、ビジュアルインデックス、STTオーディオチャンク分割に必要です。
ツール — 11モジュールにわたる47個
Explore — YouTubeの発見とリサーチ (1)
ツール | 機能 |
| インテント認識型検索とマルチクエリランキング、文字起こし要約、構造化ベンチマークデータ、バックグラウンドインデックス。1回の呼び出しで5〜8回の個別ツール呼び出しを置き換えます。 |
Core — 動画とチャンネルのインテリジェンス (7)
ツール | 機能 |
| クエリとメタデータでYouTubeを検索 |
| 詳細メタデータ — タグ、エンゲージメント、言語、カテゴリ |
| チャンネル統計、説明、最近のアップロード |
| チャンネルの全動画ライブラリを閲覧 |
| タイムスタンプとチャプター付きの完全な文字起こし |
| いいね数とエンゲージメント付きの上位コメント |
| 任意のプレイリスト内の全動画を一覧表示 |
ナレッジベース — セマンティック文字起こし検索(7)
ツール | 機能 |
| プレイリスト全体の文字起こしをインデックス化 |
| URLまたはIDで特定の動画をインデックス化 |
| インデックス化されたコンテンツを自然言語で検索 |
| インデックス化されたコレクションを閲覧 |
| 検索を1つのコレクションに限定 |
| 全コレクションを横断して検索 |
| コレクションとそのインデックスを削除 |
センチメントと分析(4)
ツール | 機能 |
| テーマとリスクシグナルを含むコメントのセンチメント |
| 複数動画にわたるパフォーマンスを比較 |
| プレイリストレベルのエンゲージメント分析 |
| 単一動画の完全な詳細分析 |
クリエイターインテリジェンス(4)
ツール | 機能 |
| 動画冒頭を効果的にする要素を分析 |
| タグとタイトルの最適化インサイト |
| ショートフォームとロングフォームのパフォーマンス比較 |
| エンゲージメントに最適な公開時間を推奨 |
発見とトレンド(2)
ツール | 機能 |
| 任意のトピックにおける勢い、飽和度、コンテンツギャップ |
| チャンネル環境とトップパフォーマー |
ユニバーサル動画ソース(5)
ツール | 機能 |
| YouTube、X、Instagram、TikTok、汎用URL、ローカルファイルをソースメタデータと機能フラグに解決 |
| ネイティブYouTubeとローカルアセットを検索。TikTok/InstagramはScrapeCreators対応、設定可能なBrave/SerpAPI/DuckDuckGoフォールバック付き |
| ScrapeCreatorsを通じてソーシャルプラットフォームを検索。エンゲージメント指標と利用可能なインポート用URL付きのランキングリストを返す |
| URLまたはローカルファイルをローカルメディアストアにインポート。必要に応じてビジュアルインデックスまたは文字起こしを構築 |
| ネイティブキャプションまたは設定済みSTTを使用して、YouTube、ソーシャル/汎用URL、ローカルファイルを文字起こし |
メディアアセット(5)
ツール | 機能 |
| 対応ソースから動画、音声、サムネイルをダウンロードまたは取り込み |
| 保存済みメディアファイルを閲覧 |
| ダウンロードしたアセットをクリーンアップ |
| 動画からキーフレームを抽出 |
| ストレージ使用量と診断 |
ビジュアル検索と証拠(3)
ツール | 機能 |
| フレームを抽出。Apple VisionのOCRとフィーチャープリント、Geminiのフレーム説明、Geminiのセマンティック埋め込みを実行 |
| 意味とテキストでフレームを検索。タイムスタンプ付きの証拠を返し、外部ブラウザギャラリーを開くことが可能 |
| Apple Visionのフィーチャープリントを使用した画像間フレーム類似性 |
ビジュアル検索は文字起こしとは別の専用インデックスです。すべての一致結果にはタイムスタンプ、ソース動画、OCRテキスト、ビジュアル説明が含まれます。ローカルフレームパスとfile: URLはMCP結果から削除されます。ブラウザギャラリーはそれらのパスをクライアントに公開せずにローカルで画像を読み取ります。
コメントナレッジベース(6)
ツール | 機能 |
| 検索用に動画のコメントをインデックス化 |
| コメントコーパスを自然言語で検索 |
| コメントコレクションを閲覧 |
| コメント検索を限定 |
| 全コメントコレクションを検索 |
| コメントコレクションを削除 |
診断(3)
ツール | 機能 |
| セッション開始時に既にインポート済みの全内容のダイジェスト — 再インポートを避けるため最初に呼び出す |
| 完全なシステム診断レポート |
| コンテンツをインポートする前に検証 |
オプションのAPIキー
VidLensはキーなしでも動作します。スケールと信頼性のために追加してください:
キー | 有効化される機能 | 無料? | 入手先 |
| より良いメタデータ、コメントAPI、YouTube API検索 | Googleの割り当てが適用 | Google Cloud Console → YouTube Data API v3を有効化 → APIキーを作成 |
| セマンティック検索とビジュアル検索のための高品質な埋め込み、フレーム説明 | プロバイダーの料金と制限が適用 | |
| 文字起こし用のオプションのSTTプロバイダー | 有料 | |
| TikTok、Instagram、Threads、Pinterest、Reddit、および対応エンドポイントの直接ソーシャル検索とトレンド | プロバイダーの料金が適用 | |
| ソーシャルおよび汎用URL発見のための構造化ウェブ検索 | 異なる | Brave Search APIまたはSerpAPI |
⚠️ YouTubeキーとGeminiキーは、別々のGoogleサービスからの別々のキーです。 GeminiキーはYouTube API呼び出しには使用できません。その逆も同様です。
# Free setup asks for no keys.
npx vidlens-mcp setup
# Enhanced setup optionally prompts for keys, STT, web search, and cookies.
npx vidlens-mcp setup --enhanced
# Or pass everything non-interactively.
npx vidlens-mcp setup \
--youtube-api-key YOUR_YOUTUBE_KEY \
--gemini-api-key YOUR_GEMINI_KEY \
--stt-provider auto \
--cookies-from-browser chromeクッキーと音声認識
匿名アクセスをレート制限するプラットフォームの場合、ウィザードはブラウザプロファイルまたはファイルパスでクッキーを永続化できます:
npx vidlens-mcp setup --cookies-from-browser chrome --cookies-profile Default
npx vidlens-mcp setup --x-cookies-file /path/to/x-cookies.txtまたは環境変数を使用:VIDLENS_COOKIES_FROM_BROWSER、VIDLENS_X_COOKIES_FILE、VIDLENS_INSTAGRAM_COOKIES_FILE、VIDLENS_TIKTOK_COOKIES_FILE。
STTの選択は自動です:最初にローカルのwhisper.cpp、次にGemini、最後にOpenAI。VIDLENS_STT_PROVIDER=whisper-cpp|gemini|openai|none|autoで上書きできます。ウィザードで尋ねられたとき、ほとんどの人にとってautoでEnterを押すのが正解です。
CLI
npx vidlens-mcp # Start MCP server (stdio)
npx vidlens-mcp serve # Start MCP server (explicit)
npx vidlens-mcp setup # Configure clients, keys, STT, cookies
npx vidlens-mcp doctor # Run diagnostics
npx vidlens-mcp doctor --no-live # Diagnostics without network checks
npx vidlens-mcp update-deps # Refresh managed yt-dlp and Deno helpers
npx vidlens-mcp version # Print versiondoctorはNode.jsのバージョン、yt-dlpの鮮度、STTとウェブ検索プロバイダー、APIキーの有効性、データディレクトリの健全性、Claude Desktop、Claude Code、CodexのMCPクライアント登録をチェックします。
要件
要件 | ステータス | メモ |
Node.js ≥ 22 | 必須 |
|
yt-dlp | 自動インストール |
|
ffmpeg + ffprobe | 推奨 | メディア検証、フレーム抽出、ビジュアルインデックス、STT音声処理に必要 |
YouTube APIキー | オプション | より良いメタデータとコメントアクセス |
Gemini APIキー | オプション | より良い埋め込みとフレーム説明 |
macOS | オプション | Apple VisionがネイティブOCRと画像類似性を提供。他のプラットフォームは設定時にGemini説明を使用可能 |
セキュリティとプライバシー
ライブラリ(トランスクリプト、フレーム、埋め込み、メディア)はローカルに保存され、お使いのマシン上に留まります。ネットワーク呼び出しは、クエリするソースと設定したAPIのみに送信されます。
セットアップは、設定したキーをローカルのMCPクライアント設定に保存します。キー入力をマスクする対話型の拡張セットアップを推奨します。CLIフラグで指定したキーはシェル履歴に残る可能性があります。エラーメッセージはシークレットリダクターを通過するため、キーやクッキーパスがツール出力に表示されることはありません。
チャンネルページと一般的なURLのフェッチは、プライベートアドレス、リンクローカルアドレス、ループバックアドレスを拒否します(SSRFガード)。意図的なローカル使用のためのエスケープハッチ:
VIDLENS_ALLOW_PRIVATE_URLS=1。
トラブルシューティング
Claude Desktopで「Tool not found」が表示される場合。 完全に終了(⌘Q)して再度開いてください。MCPサーバーは起動時にのみ読み込まれます。
「YOUTUBE_API_KEY not configured」という警告。 情報提供であり、エラーではありません。VidLensはこれがなくても動作します。
「API_KEY_SERVICE_BLOCKED」。 キーが要求されたGoogleサービスを呼び出すことを許可されていません。Google Cloud ConsoleでYouTube Data API v3を有効にし、キーのAPI制限でそのAPIを許可してください。VidLensを実行する場所に応じて適切なアプリケーション制限を維持してください。短時間の診断のみで、すぐに再度制限をかける場合を除き、キーを無制限にしないでください。
GeminiキーはYouTubeでは機能しません。 これらは別々のサービスであり、別々のキーが必要です。オプションのAPIキーを参照してください。
ソーシャルビデオはダウンロードできるが、視覚分析が失敗する場合。 ffmpegをインストールしてから、セットアップを再実行してください:
brew install ffmpegnpx vidlens-mcp doctor --no-livedownloadAssetはffmpegなしでもビデオを取得できることがよくありますが、indexVisualContent、extractKeyframes、メディア検証、STT音声処理にはffmpegまたはffprobeが必要です。
その他の問題:
npx vidlens-mcp doctorライセンス
MIT
Available Tools
41 toolsanalyzePlaylistC
Expand and analyze a playlist in one call with partial success and aggregate benchmarks. [~5-20s, scales with playlist size]
Inputs: playlistUrlOrId (required), analyses (required), maxVideos, commentsSampleSize, +2 more.
analyzeVideoSetB
Run multiple analyses across a video set with partial success, item-level errors, and provenance. [~5-20s, scales with video count]
Inputs: videoIdsOrUrls (required), analyses (required), commentsSampleSize, transcriptMode, +1 more.
buildVideoDossierB
Build a one-shot video dossier with core metadata/transcript readiness, optionally extended with comments, sentiment, and provenance. [~3-10s]
Inputs: videoIdOrUrl (required), commentSampleSize, includeComments, includeSentiment, +2 more.
checkImportReadinessA
Diagnose whether a video is importable, including transcript availability, sparse-transcript warnings, and yt-dlp/API issues. [~1-3s]
Inputs: videoIdOrUrl (required), language, dryRun.
checkSystemHealthA
Check setup and provider health: yt-dlp, YouTube API, Gemini embeddings, and local storage. [~3-10s]
Inputs: runLiveChecks, dryRun.
clearActiveCollectionA
Clear the active collection so transcript search fans back out across all collections. [~instant]
Inputs: no named parameters.
clearActiveCommentCollectionA
Clear the active comment collection so comment search fans back out across all comment collections. [~instant]
Inputs: no named parameters.
compareShortsVsLongC
Compare recent Shorts vs long-form performance for a channel and suggest a format mix. [~3-10s]
Inputs: channelIdOrHandleOrUrl (required), lookbackDays, dryRun.
discoverNicheTrendsA
Discover what's trending in a niche right now. Returns top-performing and recent videos, momentum signals (accelerating/steady/decelerating), saturation analysis, content gap opportunities, keyword patterns, and format breakdown. Grounded in YouTube search data with honest limitations disclosed. [~5-15s]
Inputs: niche (required), regionCode, maxResults, lookbackDays, +1 more.
downloadAssetA
Download a YouTube video, audio track, or thumbnail to local storage. Returns asset manifest entry with file path. Does NOT perform visual indexing — this is honest file storage. [~30-120s, downloads media]
Inputs: videoIdOrUrl (required), format (required), maxSizeMb.
expandPlaylistC
Expand a playlist into individual videos for downstream analysis and batch workflows. [~1-3s]
Inputs: playlistUrlOrId (required), maxVideos, includeVideoMeta, dryRun.
exploreNicheCompetitorsA
Discover active channels in a niche by analyzing who ranks in YouTube search results. Returns channel-level stats, top videos, and a landscape summary. Useful for competitive reconnaissance before entering a niche. [~5-20s]
Inputs: niche (required), regionCode, maxChannels, dryRun.
exploreYouTubeA
ALWAYS use this tool FIRST when the user wants to find, discover, or explore YouTube videos. Do NOT use web search for YouTube video discovery — use this tool instead. Searches YouTube directly with intelligent multi-query ranking and parallel enrichment. Returns ranked videos with transcript summaries, key moments, and readiness for follow-up. IMPORTANT: When results contain benchmark scores, statistics, or comparisons, ALWAYS create visual charts and infographics (bar charts, comparison tables) from the data immediately — do not wait for the user to ask. Use 'specific' mode to find one best video. Use 'explore' for topic discovery across creators. Depth: 'quick' for metadata, 'standard' for key moments + transcript summaries, 'deep' for background indexing. [~2s quick, ~5-10s standard, ~15-30s deep]
Inputs: query, searches, mode, creator, +8 more.
extractKeyframesA
Extract keyframe images from a locally downloaded video at regular intervals using ffmpeg. Requires the video to be downloaded first via downloadAsset. Does NOT do visual search or classification — produces raw frame images. [~30-60s, requires ffmpeg]
Inputs: videoIdOrUrl (required), intervalSec, maxFrames, imageFormat, +1 more.
findSimilarFramesA
Find frames that visually look like a reference frame using Apple Vision image feature prints. Accepts a frame assetId or a direct framePath and returns image-backed matches. [~30-60s, vision comparison]
Inputs: assetId, framePath, videoIdOrUrl, maxResults, +2 more.
findVideosB
Search YouTube videos by intent. Returns compact ranked results with provenance and engagement hints. [~1-3s]
Inputs: query (required), maxResults, order, regionCode, +5 more.
importCommentsA
Import a video's comments into the local comment knowledge base for semantic search. Fetches comments via the existing comment pipeline and indexes them for searchComments. [~3-10s]
Inputs: videoIdOrUrl (required), collectionId, maxTopLevel, includeReplies, +5 more.
importPlaylistC
Import a playlist into the local transcript knowledge base for semantic search in Claude Desktop. [~5-30s, ~2s per video]
Inputs: playlistUrlOrId (required), collectionId, maxVideos, chunkStrategy, +10 more.
importVideosB
Import one or more videos into a local transcript collection for later semantic search. [~5-20s, ~2s per video]
Inputs: videoIdsOrUrls (required), collectionId, chunkStrategy, chunkSizeSec, +9 more.
indexVisualContentA
Build a real visual index for a video using extracted frames, Apple Vision OCR, Apple Vision feature prints, and optional Gemini frame descriptions. Returns frame evidence with local image paths. [~30-120s, downloads + OCR + vision]
Inputs: videoIdOrUrl (required), intervalSec, maxFrames, imageFormat, +7 more.
inspectChannelB
Inspect a channel with summary stats and posting cadence heuristics. [~3-10s]
Inputs: channelIdOrHandleOrUrl (required), dryRun.
inspectVideoB
Inspect a single video with compact metadata, normalized ratios, and transcript availability. [~1-3s]
Inputs: videoIdOrUrl (required), includeTranscriptMeta, includeEngagementRatios, dryRun.
listChannelCatalogC
List a channel's recent catalog in compact creator-analysis shape. [~3-10s]
Inputs: channelIdOrHandleOrUrl (required), maxResults, sortBy, includeShorts, +3 more.
listCollectionsB
List local transcript collections, active search focus, and indexed video/chunk counts. [~instant]
Inputs: includeVideoList.
listCommentCollectionsC
List local comment collections, active search focus, and indexed comment counts. [~instant]
Inputs: includeVideoList.
listMediaAssetsB
List locally stored media assets. Filter by video or kind. Shows file paths, sizes, and manifest metadata. [~instant]
Inputs: videoIdOrUrl, kind, limit.
measureAudienceSentimentC
Heuristic audience sentiment analysis from comments with themes, risk signals, and quote samples. [~3-10s]
Inputs: videoIdOrUrl (required), sampleSize, includeThemes, includeRepresentativeQuotes, +1 more.
mediaStoreHealthB
Check health of the local media store: disk usage, asset counts, ffmpeg/yt-dlp availability. [~instant]
Inputs: no named parameters.
readCommentsC
Read top-level comments with optional replies and structured provenance. [~1-3s]
Inputs: videoIdOrUrl (required), maxTopLevel, includeReplies, maxRepliesPerThread, +3 more.
readTranscriptB
Read transcript in summary, key moments, chapters, or paginated full mode with long-video safeguards. [~1-3s]
Inputs: videoIdOrUrl (required), language, mode, includeTimestamps, +4 more.
recommendUploadWindowsB
Recommend upload windows from recent publishing history for a given timezone. [~3-10s]
Inputs: channelIdOrHandleOrUrl (required), timezone (required), lookbackDays, dryRun.
removeCollectionB
Delete a local transcript collection and its search index. [~instant]
Inputs: collectionId (required).
removeCommentCollectionB
Delete a local comment collection and its search index. [~instant]
Inputs: collectionId (required).
removeMediaAssetB
Remove stored media assets. Specify assetId to remove one, or videoIdOrUrl to remove all assets for a video. [~instant]
Inputs: assetId, videoIdOrUrl, deleteFiles.
researchTagsAndTitlesC
Research title structures, keywords, and tag patterns around a seed topic. [~3-10s]
Inputs: seedTopic (required), regionCode, language, maxExamples, +1 more.
scoreHookPatternsC
Heuristically score first-30-second hooks across one or more videos. [~3-10s, ~1s per video]
Inputs: videoIdsOrUrls (required), hookWindowSec, dryRun.
searchCommentsA
Search imported comment collections with ranked results. Returns matching comments with author, like count, and relevance score. Uses active comment collection by default. [~instant]
Inputs: query (required), collectionId, maxResults, minScore, +2 more.
searchTranscriptsC
Search imported transcript-text collections with active-collection focus by default and return ranked timestamped chunks. [~instant]
Inputs: query (required), collectionId, maxResults, minScore, +2 more.
searchVisualContentA
Search the actual visual content of a video or your indexed frame library. Uses Apple Vision OCR, optional Gemini frame descriptions, and optional Gemini semantic embeddings. Always returns frame/image evidence with timestamps. [~1-3s if indexed, ~60-120s if auto-indexing]
Inputs: query (required), videoIdOrUrl, maxResults, minScore, +10 more.
setActiveCollectionA
Set the default collection that transcript search should focus on when collectionId is omitted. [~instant]
Inputs: collectionId (required).
setActiveCommentCollectionA
Set the default comment collection that searchComments should focus on when collectionId is omitted. [~instant]
Inputs: collectionId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 41 tools
Several tools have overlapping purposes, e.g., exploreYouTube vs findVideos both search YouTube; analyzePlaylist vs expandPlaylist vs importPlaylist may be confused; extractKeyframes vs indexVisualContent vs searchVisualContent overlap in visual processing. Search-related tools for transcripts, comments, and visual content are somewhat distinct but the active-collection setters/clearers add confusion.
Naming is inconsistent: mix of camelCase (clearActiveCollection, setActiveCollection, buildVideoDossier) and snake_case (checkImportReadiness, downloadAsset, searchComments). Verbs vary (check, build, list, find, inspect, read, score, measure, analyze) without a clear pattern. Some tools use nouns like 'mediaStoreHealth' which is inconsistent with verb-first conventions.
With 41 tools, the server has a heavy tool surface for what is essentially a YouTube media analysis and knowledge base tool. Many tools are highly specialized and could be consolidated (e.g., multiple playlist and import tools, multiple collection management tools). This will likely overwhelm an agent and increase latency.
The set covers core workflows: video discovery, import, transcript analysis, comment analysis, visual content, playlist handling, and media asset management. However, there are gaps: no tool for updating or deleting imported transcripts/collections beyond removal? Actually removeCollection exists, but there is no tool to update a video's metadata or re-index. Also, no tool to scrape comments for a single video without import? readComments exists but no search without import seems incomplete.
Related MCP Connectors
YouTube transcripts, search, channel/playlist listings and upload tracking for AI agents.
YouTube transcripts, search, channels, playlists and bulk transcript jobs for AI agents. 14 tools.
YouTube for AI agents: transcripts, comments, video stats, channel monitor, Shorts captions.
Transcripts, summaries, chapters and timestamped search for video links, for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to search, watch, summarize, clip, and extract transcripts from YouTube videos, all without needing an API key or leaving the chat.914 npm67Apache 2.0
- AlicenseNot gradedqualityBmaintenanceProvides AI agents with token-optimized access to YouTube data, including video details, transcripts, channel statistics, trending videos, and search.1,477 npmMIT
- AlicenseAqualityBmaintenanceAllows AI agents to fetch, search, and summarize YouTube video transcripts without an API key, including chapter summaries.4MIT
- AlicenseAqualityCmaintenanceEnables AI agents to search YouTube like a database, retrieve transcripts and channel data, and mine videos for claims, numbers, and demand signals — without needing an API key.6146 npmMIT