VidLens
你的 AI 能读网页。
现在它也能看视频了。
npx vidlens-mcp setup研究视频: 搜索、转写、对比并引用 YouTube 和公开社交媒体视频。
构建本地资料库: 一次导入,之后搜索转写文本、评论、画面和 OCR,无需重复抓取同一视频。
检查视觉证据: 在可视化图库以及结构化的客户端输出中,找到精确的画面、时间戳、匹配原因和来源。
VidLens 是一个 MCP 服务器,让你的 AI 代理拥有视频之眼——YouTube、X、TikTok、Instagram、其他视频页面,或你磁盘上的文件。粘贴链接,提出问题。VidLens 读取转写文本、查看画面,并给出你可核对的时间戳来作答。它摄取的所有内容都会存入你自己机器上的资料库,因此你的代理永远不必重复观看同一段视频。
无需 API 密钥即可开始。适用于 Claude Desktop、Claude Code 和 Codex。能力足够的客户端可以将 VidLens 的结构化结果转化为原生图表、卡片、表格和可视化报告,呈现在它们自己的响应界面中。
观看 VidLens 的实际演示
Related MCP server: @kirbah/mcp-youtube
试试看
VidLens 设置完成后,将以下任意内容粘贴到你的 AI 客户端:
"在 YouTube 上搜索 M5 Max MacBook Pro 评测。评测者们有哪些共识,又有哪些分歧?"
VidLens 会搜索、阅读各评测者的转写文本,并综合出共识与分歧,附上来源和时间戳。
"转写这段视频并总结:https://x.com/username/status/123..."
单个公开的 X、Instagram 或 TikTok 视频 URL 通常完全不需要 API 密钥。VidLens 会抓取它、转写它,并保留转写文本,这样你之后可以提出后续问题——无论是本次会话还是将来的任何一次。
"在这段视频里找到他们展示基准测试图表的那一帧。"
视觉搜索会查看屏幕上的内容——幻灯片、图表、白板、产品特写——并显示实际帧图像及其时间戳,呈现在本地浏览器图库中,而不仅仅是文字猜测。
原生客户端呈现
VidLens 返回可移植的结构化证据:来源、时间戳、评分、OCR、描述、出处和局限性。Codex、Claude 和其他能力足够的客户端可以将这些证据组合成它们自己的原生图表、对比卡片、表格和可视化报告。
呈现方式属于客户端,而不是 VidLens 内嵌的 UI。对于提取帧的检查,searchVisualContent 也可以打开浏览器图库。
工作原理
视频源从左侧进入。VidLens 通过任何可行的途径摄取它们——配置了密钥时使用 YouTube API、yt-dlp,或直接页面提取——并将结果存入本地资料库:转写文本、画面和嵌入向量。你的代理可以从任何 MCP 客户端查询该资料库。
内置两项诚实性保证:
降级而非失败。 每个 YouTube 数据工具在放弃之前都会尝试多条路径,因此缺少密钥或配额耗尽时会优雅降级,而不是直接崩溃。
响应附带出处。 工具响应会报告数据由哪条路径提供,以及是否有任何部分是残缺的。绝不静默降级。
所有内容都存放在你磁盘上的一个目录中。无需外部数据库,无需 Docker。复制该目录即可备份;删除它即可重新开始。
安装
设置向导(推荐)
npx vidlens-mcp setup向导会检测 Claude Desktop、Claude Code 和 Codex,检查 VidLens 所需的本地依赖,并提供一个简单的选择:
免费设置(推荐): 无需 API 密钥。YouTube 搜索、转写文本、元数据和本地资料库立即可用。
增强设置: 逐个添加可选的 API、语音转文字、网页搜索或浏览器 Cookie。按 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 下的磁盘上:转写文本集合、评论集合、下载的媒体和视觉索引。甚至当前活动的集合也会被记住。
一次调用即可回忆。 在会话开始时,recallWorkspace 会返回所有已存储内容的紧凑摘要,因此代理在再次搜索或导入之前就知道自己已有什么。工具描述会将同样的提醒带入每个客户端,让代理先检查而不是重新抓取。
按 URL 或资源键复用。 已导入的社交媒体视频的转写文本可以通过其原始 URL 或资源键再次调出——无需重新下载、无需重新转写。
跨代理共享一个资料库。 默认数据目录对所有客户端都是相同的,因此 Claude Desktop、Claude Code 和 Codex 共享一个资料库——在一个客户端中导入视频,在另一个客户端中搜索它。
⚠️ 不要将
VIDLENS_DATA_DIR放在 Dropbox、iCloud、Google Drive 或任何文件同步文件夹中。 VidLens 使用 SQLite(带 WAL),而文件同步器下的活动数据库会被损坏或产生冲突副本。请将数据目录放在本地磁盘上——默认位置已经做到了。
超越 YouTube
对于 X、Instagram、TikTok 和通用视频页面,VidLens 使用能力阶梯:它采用可行的最廉价路径,API 密钥是增强项,而非前提条件。
路径 | 成本 | 最适合 | 具体行为 |
本地复用 | 免费 | 任何之前导入过的内容 |
|
公开直接 URL | 免费 | 单条 X 状态、Instagram Reel/帖子或 TikTok 视频 | yt-dlp 匿名尝试规范帖子 URL;ffmpeg 和本地或已配置的 STT 处理没有字幕的媒体 |
浏览器辅助 | 在受支持的主机上免费 | 查找或验证帖子,或使用已有的登录会话 | 你客户端的浏览器控制捕获规范 URL 和可见元数据,然后将 URL 交回给 VidLens |
本地文件交接 | 免费 | 你有权保存的视频 | 导入已保存的文件以进行转写和视觉索引 |
API 增强 | 提供商定价 | 批量、无人值守或可重复的发现 | 已配置的 ScrapeCreators、Brave、SerpAPI、YouTube、Gemini 或 OpenAI 能力会被自动选择 |
三个注意事项,直说无妨:
浏览器辅助是主机级别的。 MCP 服务器本身不控制浏览器;它依赖你的客户端提供的任何浏览器工具,而这因主机而异。
看到视频不等于导出视频。 能在浏览器中播放的帖子并不保证能自动导出媒体。
只接受具体 URL。 VidLens 导入特定的帖子或视频 URL,绝不导入个人主页、探索页、话题标签或热门页面。
对于超出简单下载的社交媒体和本地视频工作,请安装 ffmpeg(macOS 上执行 brew install ffmpeg)——帧提取、视觉索引和 STT 音频分块都需要它。
工具——11 个模块共 47 个
探索——YouTube 发现与研究(1)
工具 | 功能 |
| 意图感知搜索,带多查询排序、转写摘要、结构化基准数据和后台索引。一次调用即可替代 5–8 次单独的工具调用。 |
核心——视频与频道情报(7)
工具 | 功能说明 |
| 按查询条件搜索 YouTube 并返回元数据 |
| 深度元数据 — 标签、互动数据、语言、分类 |
| 频道统计、描述、最近上传 |
| 浏览频道的完整视频库 |
| 带时间戳和章节的完整字幕 |
| 带点赞和互动数据的热门评论 |
| 列出任意播放列表中的所有视频 |
知识库 — 语义字幕搜索(7)
工具 | 功能说明 |
| 为整个播放列表的字幕建立索引 |
| 按 URL 或 ID 为特定视频建立索引 |
| 跨已索引内容的自然语言搜索 |
| 浏览已索引的集合 |
| 将搜索范围限定到单个集合 |
| 跨所有集合搜索 |
| 删除集合及其索引 |
情感与分析(4)
工具 | 功能说明 |
| 带主题和风险信号的评论情感分析 |
| 比较多个视频的表现 |
| 播放列表级别的互动分析 |
| 单个视频的完整深度分析 |
创作者智能(4)
工具 | 功能说明 |
| 分析视频开场有效的因素 |
| 标签和标题优化洞察 |
| 短视频与长视频表现对比 |
| 最佳发布时段以提升互动 |
发现与趋势(2)
工具 | 功能说明 |
| 任意主题的势头、饱和度和内容空白 |
| 频道格局和头部创作者 |
通用视频源(5)
工具 | 功能说明 |
| 将 YouTube、X、Instagram、TikTok、通用 URL 和本地文件解析为源元数据和能力标志 |
| 搜索原生 YouTube 和本地资源,支持通过 ScrapeCreators 搜索 TikTok/Instagram,并可配置 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 chromeCookies 与语音转文字
对于对匿名访问进行限流的平台,向导可以按浏览器配置文件或文件路径持久化 cookies:
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 覆盖。当向导询问时,大多数用户按 Enter 选择 auto 即可。
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 客户端配置中。建议使用交互式 Enhanced 设置,它会遮蔽密钥输入;通过 CLI 标志提供的密钥可能会保留在 shell 历史记录中。错误消息会经过密钥脱敏器处理,因此密钥和 cookie 路径不会在工具输出中回显。
对频道页面和通用 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.
Maintenance
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.681 npmMIT