TubeLens
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PYTHONUTF8 | No | Set to 1 to enable Python UTF-8 mode, as shown in the Claude Code and Claude Desktop/Cursor configuration examples. | |
| TUBELENS_EXTRA_HOSTS | No | Comma-separated list of additional allowed hosts beyond YouTube, e.g. "vimeo.com,www.vimeo.com". |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| video_infoC | Get YouTube video metadata: title, channel, stats, upload date, tags, chapters, description. |
| video_commentsA | Read YouTube comments. sort: 'top' or 'new'. replies=True adds replies (3 per thread).
query: comma-separated terms; scans up to |
| video_transcriptA | Get video transcript (manual subs first, then auto-captions). lang='auto' (default) uses the video's spoken language; or force e.g. 'en', 'tr'. Lines merge into ~chunk_seconds blocks (0 = raw) to save tokens. Use start/end ('1:30') to read one part of a long video. No captions? use transcribe_video. |
| batch_transcriptsB | Transcripts of several videos in one call (max 8), each merged into 30s blocks and capped. |
| find_in_videoB | Find WHERE a topic is said in a video. query: comma-separated terms (any match). Returns timestamped caption lines (with a little context). frames=True also returns the video frame at each hit. |
| youtube_searchB | Search YouTube. sort: 'relevance' or 'date' (newest first). Optional filters: min_views, min_minutes, max_minutes (0 = off). Returns title, channel, duration, views, URL. |
| youtube_researchA | Research a topic on YouTube in one call. Runs several searches (your |
| channel_videosB | List recent videos of a channel or playlist URL (e.g. https://www.youtube.com/@name/videos). |
| channel_statsA | Quick channel analysis over its latest n videos (max 50): average/median views, best videos, typical length and upload cadence. url like https://www.youtube.com/@name/videos |
| watch_videoA | 'Watch' a video: returns frames (images, each labelled with timestamp) plus the transcript for the same range. mode='even' spaces frames evenly; mode='scenes' samples twice as many moments and keeps the ones that differ most (best for slides, demos, edited videos). Use start/end ('90', '1:30') to zoom in and call again for detail. n_frames max 24 (default 6); width 512 saves tokens, raise to ~768 only to read small on-screen text (or use ocr_frames). |
| ocr_framesA | Read the TEXT shown in a video (slides, code, UI, burned-in subtitles) without returning images, so it is cheap in tokens. Frames come from scene changes (default) or even spacing. Output: timestamp and recognised text per frame. Runs locally (rapidocr), no cloud. |
| transcribe_videoA | Transcribe the SPEECH of a video locally with Whisper (faster-whisper, CPU) when it has no usable captions. model: tiny | base | small (bigger = slower, more accurate). lang: 'en', 'tr'... or empty to auto-detect. Max 30 min per call, so use start/end for long videos. First run downloads the model once. |
| doctorA | Self-check: versions, which optional features are installed, and whether YouTube is reachable. Run this first if any tool misbehaves. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Each tool targets a distinct capability (metadata, comments, transcript, search, channel listing, frames, OCR, local ASR), and the descriptions explicitly state fallback relationships (e.g. video_transcript -> transcribe_video when captions are missing). The only mild overlaps are the frame-producing tools (watch_video, ocr_frames, find_in_video with frames=True) and transcript variants (video_transcript vs batch_transcripts), but the descriptions make the intended split clear.
All names are lowercase snake_case and readable, with no camelCase or style mixing. The pattern is slightly heterogeneous: some are verb-led (find_in_video, watch_video, transcribe_video, ocr_frames) and others noun-led (video_info, channel_stats, youtube_search), plus a bare 'doctor', but this is a minor deviation rather than confusion.
13 tools sit comfortably in the well-scoped range, and each one earns its place: core reads, search/research aggregation, channel analysis, frame/OCR inspection, and a local ASR fallback. Nothing feels redundant or padded, and there are no missing bulk/utility helpers.
For a YouTube analysis/research domain the surface is thorough: metadata, comments, transcripts (single and batch), in-video search, search and multi-query research, channel/playlist listing and stats, visual frames, OCR, and a Whisper fallback for uncaptioned videos, plus a doctor self-check. Read-only by design, so the absence of write operations is not a gap.