Search YouTube videos. Uses Data API v3 when YOUTUBE_API_KEY is set, falls back to yt-dlp. Filters: date range, channel, duration, order.

Search YouTube channels by name/topic. Returns subscriber counts, video counts, country. Requires YOUTUBE_API_KEY.

Detailed channel metadata: subscribers, views, videos, country, keywords. Requires YOUTUBE_API_KEY.

Detailed metadata for a YouTube video: title, duration, views, channel, description, tags.

List up to limit currently trending YouTube videos. Use this for broad discovery, not keyword search. Read-only; uses Data API v3 when YOUTUBE_API_KEY is set and otherwise a keyless yt-dlp fallback. Returns source metadata and video records; results can change over time and depend on upstream availability.

List up to limit recent uploads from a known YouTube channel URL or @handle. Use this for channel browsing, not keyword search or channel metadata. Read-only and keyless; returns normalized channel metadata plus video records. Empty results include a warning when the channel is missing or has no uploads.

List up to limit videos from a known YouTube playlist URL in upstream order. Use this for playlist contents, not channel uploads or keyword search. Read-only and keyless; returns playlist metadata plus ordered video records. Results are bounded and may fail when the playlist is private, unavailable, or blocked upstream.

Transcript/subtitles of a YouTube video. Uses the original/default language; manual > ASR within that language.

Extract one ephemeral JPEG near an integer-millisecond timestamp. Returns metadata plus MCP ImageContent; accuracy is best-effort at a decoded frame boundary.

Available subtitle languages for a video. Shows manual vs auto-generated.

Retrieve up to max_results top-level comments for a known YouTube video. Use this for audience reactions, not video metadata or transcripts. Read-only and requires YOUTUBE_API_KEY; returns structured comment records. Calls may fail when comments are disabled, the video is unavailable, or Data API quota is exhausted.

Create a named corpus for semantic search over transcripts. Each corpus uses a fixed embedding model.

Fetch a video's transcript, chunk it, and store local embeddings in an existing corpus. Use this after corpus_create; it skips an already-indexed video by default. force_reembed=true deletes and replaces that video's existing local chunks and vectors. This modifies local corpus data and may contact YouTube; returns indexing status and chunk count.

Semantic search within a corpus. Deduplicates overlapping windows, limits source domination, and returns titles plus timestamp URLs.

List all available corpora with chunk and video counts.

Delete a corpus and all its chunks/vectors permanently.

Get tube-bridge documentation: available tools, architecture, known limitations, API key setup.