Skip to main content
Glama

당신의 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 키는 전제 조건이 아니라 업그레이드입니다.

경로

비용

가장 적합한 용도

작동 방식

로컬 재사용

무료

이전에 가져온 모든 것

recallWorkspace가 저장된 트랜스크립트 또는 미디어를 찾습니다. 다시 가져오지 않습니다.

공개 직접 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)

도구

기능

exploreYouTube

의도 인식 검색, 다중 쿼리 순위, 트랜스크립트 요약, 구조화된 벤치마크 데이터, 백그라운드 인덱싱. 한 번의 호출로 5–8개의 개별 도구 호출을 대체합니다.

핵심 — 영상 및 채널 인텔리전스 (7)

도구

기능

findVideos

쿼리와 메타데이터로 YouTube 검색

inspectVideo

심층 메타데이터 — 태그, 참여도, 언어, 카테고리

inspectChannel

채널 통계, 설명, 최근 업로드

listChannelCatalog

채널의 전체 동영상 라이브러리 탐색

readTranscript

타임스탬프와 챕터가 포함된 전체 자막

readComments

좋아요와 참여도가 포함된 상위 댓글

expandPlaylist

모든 재생목록의 전체 동영상 나열

지식 베이스 — 의미론적 자막 검색 (7)

도구

기능

importPlaylist

전체 재생목록의 자막 인덱싱

importVideos

URL 또는 ID로 특정 동영상 인덱싱

searchTranscripts

인덱싱된 콘텐츠에 대한 자연어 검색

listCollections

인덱싱된 컬렉션 탐색

setActiveCollection

검색 범위를 하나의 컬렉션으로 한정

clearActiveCollection

모든 컬렉션에서 검색

removeCollection

컬렉션과 해당 인덱스 삭제

감성 및 분석 (4)

도구

기능

measureAudienceSentiment

테마와 위험 신호가 포함된 댓글 감성 분석

analyzeVideoSet

여러 동영상 간 성과 비교

analyzePlaylist

재생목록 수준의 참여도 분석

buildVideoDossier

단일 동영상에 대한 완전한 심층 분석

크리에이터 인텔리전스 (4)

도구

기능

scoreHookPatterns

동영상 도입부의 효과 요인 분석

researchTagsAndTitles

태그 및 제목 최적화 인사이트

compareShortsVsLong

숏폼 대 롱폼 성과 비교

recommendUploadWindows

참여도 최적화를 위한 최적 업로드 시간

발견 및 트렌드 (2)

도구

기능

discoverNicheTrends

모든 주제의 모멘텀, 포화도, 콘텐츠 공백 분석

exploreNicheCompetitors

채널 환경 및 상위 성과자 탐색

범용 동영상 소스 (5)

도구

기능

inspectVideoSource

YouTube, X, Instagram, TikTok, 일반 URL, 로컬 파일을 소스 메타데이터와 기능 플래그로 변환

searchVideoSources

네이티브 YouTube 및 로컬 자산 검색, TikTok/Instagram용 ScrapeCreators 지원 및 구성 가능한 Brave/SerpAPI/DuckDuckGo 폴백

searchSocialTrends

ScrapeCreators를 통한 소셜 플랫폼 검색, 참여도 지표와 가져오기 가능한 URL이 포함된 순위 목록 반환

importVideoSources

URL 또는 로컬 파일을 로컬 미디어 저장소로 가져오기, 선택적으로 시각적 인덱스 또는 자막 구축

transcribeVideoSource

네이티브 캡션 또는 구성된 STT를 통해 YouTube, 소셜/일반 URL, 로컬 파일 자막 생성

미디어 자산 (5)

도구

기능

downloadAsset

지원되는 모든 소스에서 동영상, 오디오 또는 썸네일 다운로드/수집

listMediaAssets

저장된 미디어 파일 탐색

removeMediaAsset

다운로드된 자산 정리

extractKeyframes

동영상에서 키 프레임 추출

mediaStoreHealth

저장 공간 사용량 및 진단

시각적 검색 및 증거 (3)

도구

기능

indexVisualContent

프레임 추출, Apple Vision OCR 및 특징점, Gemini 프레임 설명, Gemini 의미론적 임베딩 실행

searchVisualContent

의미와 텍스트로 프레임 검색, 타임스탬프가 포함된 증거 반환 및 외부 브라우저 갤러리 열기 가능

findSimilarFrames

Apple Vision 특징점을 사용한 이미지 간 프레임 유사도 검색

시각적 검색은 자막과 분리된 전용 인덱스입니다. 모든 일치 결과에는 타임스탬프, 소스 동영상, OCR 텍스트, 시각적 설명이 포함됩니다. 로컬 프레임 경로와 file: URL은 MCP 결과에서 제거되며, 브라우저 갤러리는 해당 경로를 클라이언트에 노출하지 않고 이미지를 로컬에서 읽습니다.

댓글 지식 베이스 (6)

도구

기능

importComments

검색을 위해 동영상의 댓글 인덱싱

searchComments

댓글 말뭉치에 대한 자연어 검색

listCommentCollections

댓글 컬렉션 탐색

setActiveCommentCollection

댓글 검색 범위 한정

clearActiveCommentCollection

모든 댓글 컬렉션에서 검색

removeCommentCollection

댓글 컬렉션 삭제

진단 (3)

도구

기능

recallWorkspace

이미 가져온 모든 항목의 세션 시작 요약 — 재가져오기를 피하려면 먼저 호출

checkSystemHealth

전체 시스템 진단 보고서

checkImportReadiness

콘텐츠 가져오기 전 검증


선택적 API 키

VidLens는 키 없이도 작동합니다. 확장성과 안정성을 위해 추가하세요:

키

제공 기능

무료?

위치

YOUTUBE_API_KEY

더 나은 메타데이터, 댓글 API, YouTube API 검색

Google 할당량 적용

Google Cloud Console → YouTube Data API v3 활성화 → API 키 생성

GEMINI_API_KEY

의미론적 및 시각적 검색용 고품질 임베딩, 프레임 설명

제공업체 요금 및 한도 적용

Google AI Studio

OPENAI_API_KEY

자막 생성을 위한 선택적 STT 제공업체

유료

OpenAI Platform

SCRAPECREATORS_API_KEY

TikTok, Instagram, Threads, Pinterest, Reddit 및 지원 엔드포인트에 대한 직접 소셜 검색 및 트렌드

제공업체 요금 적용

ScrapeCreators

BRAVE_API_KEY / SERPAPI_KEY

소셜 및 일반 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 version

doctor는 Node.js 버전, yt-dlp 최신 상태, STT 및 웹 검색 제공업체, API 키 유효성, 데이터 디렉터리 상태, Claude Desktop, Claude Code 및 Codex용 MCP 클라이언트 등록을 확인합니다.


요구 사항

요구 사항

상태

참고

Node.js ≥ 22

필수

node:sqlite 사용 — node --version으로 확인

yt-dlp

자동 설치

npx vidlens-mcp setup 중 다운로드

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 ffmpeg
npx vidlens-mcp doctor --no-live

downloadAsset는 ffmpeg 없이도 비디오를 가져올 수 있는 경우가 많지만, indexVisualContent, extractKeyframes, 미디어 검증 및 STT 오디오 처리는 ffmpeg 또는 ffprobe가 필요합니다.

기타 문제:

npx vidlens-mcp doctor

라이선스

MIT

GitHub · npm · Model Context Protocol

Available Tools

41 tools
analyzePlaylistC

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

    C2.7/5.0

    Scored across 41 tools

    Disambiguation2/5

    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 Consistency2/5

    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.

    Tool Count1/5

    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.

    Completeness3/5

    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

    Related MCP Servers