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 클라이언트에 붙여넣으세요:
"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, 음성-텍스트, 웹 검색, 또는 브라우저 쿠키를 하나씩 추가합니다. 필요 없는 항목은 Enter를 눌러 건너뛰세요. 저장된 값은 유지되며 절대 표시되지 않습니다.
Enter를 눌러 무료를 선택하거나, 향상된 기능을 원할 때마다 npx vidlens-mcp setup --enhanced를 실행하세요. Claude Code의 경우 설정 시 VidLens를 사용자 MCP 레지스트리에 등록하고, 공유 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 릴/게시물, 또는 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 및 로컬 자산 검색, 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로 재정의할 수 있습니다. 마법사에서 질문이 나오면 대부분의 사용자에게 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 클라이언트 구성에 저장합니다. 키 입력을 마스킹하는 대화형 고급 설정을 권장합니다. CLI 플래그로 제공된 키는 셸 히스토리에 남을 수 있습니다. 오류 메시지는 비밀 정보 마스킹 도구를 통과하므로 키와 쿠키 경로가 도구 출력에 표시되지 않습니다.
채널 페이지 및 일반 URL 가져오기는 비공개, 링크-로컬 및 루프백 주소를 거부합니다(SSRF 가드). 의도적인 로컬 사용을 위한 탈출구:
VIDLENS_ALLOW_PRIVATE_URLS=1.
문제 해결
Claude Desktop에서 "도구를 찾을 수 없음". 완전히 종료(⌘Q)하고 다시 여십시오. MCP 서버는 시작 시에만 로드됩니다.
"YOUTUBE_API_KEY가 구성되지 않음" 경고. 오류가 아닌 정보 제공용입니다. 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