Skip to content
Back to search

yt-dlp-mcp

A Model Context Protocol (MCP) server that bridges Video & Audio content with Large Language Models using yt-dlp.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kevinwatt--yt-dlp-mcp/badge.svg)](/listings/kevinwatt--yt-dlp-mcp)

HTML

<a href="/listings/kevinwatt--yt-dlp-mcp"><img src="/api/listings/kevinwatt--yt-dlp-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

**Install yt-dlp** on your system:

<table> <tr> <th>Platform</th> <th>Command</th> </tr> <tr> <td>πŸͺŸ <strong>Windows</strong></td> <td><code>winget install yt-dlp</code></td> </tr> <tr> <td>🍎 <strong>macOS</strong></td> <td><code>brew install yt-dlp</code></td> </tr> <tr> <td>🐧 <strong>Linux</strong></td> <td><code>pip install yt-dlp</code></td> </tr> </table>

Getting Started

Add the following config to your MCP client:

{
  "mcpServers": {
    "yt-dlp": {
      "command": "npx",
      "args": ["-y", "@kevinwatt/yt-dlp-mcp@latest"]
    }
  }
}

MCP Client Configuration

<details open> <summary><strong>Dive</strong></summary>

1. Open [Dive Desktop](https://github.com/OpenAgentPlatform/Dive) 2. Click **"+ Add MCP Server"** 3. Paste the config provided above 4. Click **"Save"** and you're ready!

</details>

<details> <summary><strong>Claude Code</strong></summary>

Use the Claude Code CLI to add the yt-dlp MCP server ([guide](https://docs.anthropic.com/en/docs/claude-code/mcp)):

claude mcp add yt-dlp npx @kevinwatt/yt-dlp-mcp@latest

</details>

<details> <summary><strong>Claude Desktop</strong></summary>

Add to your `claude_desktop_config.json`:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` - Linux: `~/.config/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "yt-dlp": {
      "command": "npx",
      "args": ["-y", "@kevinwatt/yt-dlp-mcp@latest"]
    }
  }
}

</details>

<details> <summary><strong>Cursor</strong></summary>

Go to `Cursor Settings` -> `MCP` -> `New MCP Server`. Use the config provided above.

</details>

<details> <summary><strong>VS Code / Copilot</strong></summary>

Install via the VS Code CLI:

code --add-mcp '{"name":"yt-dlp","command":"npx","args":["-y","@kevinwatt/yt-dlp-mcp@latest"]}'

Or follow the [MCP install guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server) with the standard config from above.

</details>

<details> <summary><strong>Windsurf</strong></summary>

Follow the [configure MCP guide](https://docs.windsurf.com/windsurf/cascade/mcp#mcp-config-json) using the standard config from above.

</details>

<details> <summary><strong>Cline</strong></summary>

Follow [Cline MCP configuration guide](https://docs.cline.bot/mcp/configuring-mcp-servers) and use the config provided above.

</details>

<details> <summary><strong>Warp</strong></summary>

Go to `Settings | AI | Manage MCP Servers` -> `+ Add` to [add an MCP Server](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server). Use the config provided above.

</details>

<details> <summary><strong>JetBrains AI Assistant</strong></summary>

Go to `Settings | Tools | AI Assistant | Model Context Protocol (MCP)` -> `Add`. Use the config provided above.

</details>

Manual Installation

npm install -g @kevinwatt/yt-dlp-mcp

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 684 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # 🎬 yt-dlp-mcp
  2. <div align="center">
  3. **A powerful MCP server that brings video platform capabilities to your AI agents**
  4. [![npm version](https://img.shields.io/npm/v/@kevinwatt/yt-dlp-mcp.svg)](https://www.npmjs.com/package/@kevinwatt/yt-dlp-mcp)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  6. [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/)
  7. [![TypeScript](https://img.shields.io/badge/TypeScript-5.6-blue)](https://www.typescriptlang.org/)
  8. Integrate yt-dlp with Claude, Dive, and other MCP-compatible AI systems. Download videos, extract metadata, get transcripts, and more β€” all through natural language.
  9. [Features](#-features) β€’ [Installation](#-installation) β€’ [Tools](#-available-tools) β€’ [Usage](#-usage-examples) β€’ [Documentation](#-documentation)
  10. </div>
  11. ---
  12. ## ✨ Features
  13. <table>
  14. <tr>
  15. <td width="50%">
  16. ### πŸ” **Search & Discovery**
  17. - Search YouTube with pagination
  18. - JSON or Markdown output formats
  19. - Filter by relevance and quality
  20. ### πŸ“Š **Metadata Extraction**
  21. - Comprehensive video information
  22. - Channel details and statistics
  23. - Upload dates, tags, categories
  24. - No content download required
  25. ### πŸ“ **Transcript & Subtitles**
  26. - Download subtitles in VTT format
  27. - Generate clean text transcripts
  28. - Multi-language support
  29. - Auto-generated captions
  30. </td>
  31. <td width="50%">
  32. ### πŸŽ₯ **Video Downloads**
  33. - Resolution control (480p-1080p)
  34. - Video trimming support
  35. - Platform-agnostic (YouTube, Facebook, etc.)
  36. - Saved to Downloads folder
  37. ### 🎡 **Audio Extraction**
  38. - Best quality audio (M4A/MP3)
  39. - Direct audio-only downloads
  40. - Perfect for podcasts & music
  41. ### πŸ›‘οΈ **Privacy & Safety**
  42. - No tracking or analytics
  43. - Direct downloads via yt-dlp
  44. - Zod schema validation
  45. - Character limits for LLM safety
  46. </td>
  47. </tr>
  48. </table>
  49. ---
  50. ## πŸš€ Installation
  51. ### Prerequisites
  52. **Install yt-dlp** on your system:
  53. <table>
  54. <tr>
  55. <th>Platform</th>
  56. <th>Command</th>
  57. </tr>
  58. <tr>
  59. <td>πŸͺŸ <strong>Windows</strong></td>
  60. <td><code>winget install yt-dlp</code></td>
  61. </tr>
  62. <tr>
  63. <td>🍎 <strong>macOS</strong></td>
  64. <td><code>brew install yt-dlp</code></td>
  65. </tr>
  66. <tr>
  67. <td>🐧 <strong>Linux</strong></td>
  68. <td><code>pip install yt-dlp</code></td>
  69. </tr>
  70. </table>
  71. ### Getting Started
  72. Add the following config to your MCP client:
  73. ```json
  74. {
  75. "mcpServers": {
  76. "yt-dlp": {
  77. "command": "npx",
  78. "args": ["-y", "@kevinwatt/yt-dlp-mcp@latest"]
  79. }
  80. }
  81. }
  82. ```
  83. ### MCP Client Configuration
  84. <details open>
  85. <summary><strong>Dive</strong></summary>
  86. 1. Open [Dive Desktop](https://github.com/OpenAgentPlatform/Dive)
  87. 2. Click **"+ Add MCP Server"**
  88. 3. Paste the config provided above
  89. 4. Click **"Save"** and you're ready!
  90. </details>
  91. <details>
  92. <summary><strong>Claude Code</strong></summary>
  93. Use the Claude Code CLI to add the yt-dlp MCP server ([guide](https://docs.anthropic.com/en/docs/claude-code/mcp)):
  94. ```bash
  95. claude mcp add yt-dlp npx @kevinwatt/yt-dlp-mcp@latest
  96. ```
  97. </details>
  98. <details>
  99. <summary><strong>Claude Desktop</strong></summary>
  100. Add to your `claude_desktop_config.json`:
  101. - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  102. - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
  103. - Linux: `~/.config/Claude/claude_desktop_config.json`
  104. ```json
  105. {
  106. "mcpServers": {
  107. "yt-dlp": {
  108. "command": "npx",
  109. "args": ["-y", "@kevinwatt/yt-dlp-mcp@latest"]
  110. }
  111. }
  112. }
  113. ```
  114. </details>
  115. <details>
  116. <summary><strong>Cursor</strong></summary>
  117. Go to `Cursor Settings` -> `MCP` -> `New MCP Server`. Use the config provided above.
  118. </details>
  119. <details>
  120. <summary><strong>VS Code / Copilot</strong></summary>
  121. Install via the VS Code CLI:
  122. ```bash
  123. code --add-mcp '{"name":"yt-dlp","command":"npx","args":["-y","@kevinwatt/yt-dlp-mcp@latest"]}'
  124. ```
  125. Or follow the [MCP install guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server) with the standard config from above.
  126. </details>
  127. <details>
  128. <summary><strong>Windsurf</strong></summary>
  129. Follow the [configure MCP guide](https://docs.windsurf.com/windsurf/cascade/mcp#mcp-config-json) using the standard config from above.
  130. </details>
  131. <details>
  132. <summary><strong>Cline</strong></summary>
  133. Follow [Cline MCP configuration guide](https://docs.cline.bot/mcp/configuring-mcp-servers) and use the config provided above.
  134. </details>
  135. <details>
  136. <summary><strong>Warp</strong></summary>
  137. Go to `Settings | AI | Manage MCP Servers` -> `+ Add` to [add an MCP Server](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server). Use the config provided above.
  138. </details>
  139. <details>
  140. <summary><strong>JetBrains AI Assistant</strong></summary>
  141. Go to `Settings | Tools | AI Assistant | Model Context Protocol (MCP)` -> `Add`. Use the config provided above.
  142. </details>
  143. ### Manual Installation
  144. ```bash
  145. npm install -g @kevinwatt/yt-dlp-mcp
  146. ```
  147. ---
  148. ## πŸ› οΈ Available Tools
  149. All tools are prefixed with `ytdlp_` to avoid naming conflicts with other MCP servers.
  150. ### πŸ” Search & Discovery
  151. <table>
  152. <tr>
  153. <th width="30%">Tool</th>
  154. <th width="70%">Description</th>
  155. </tr>
  156. <tr>
  157. <td><code>ytdlp_search_videos</code></td>
  158. <td>
  159. Search YouTube with pagination and date filtering support
  160. - **Parameters**: `query`, `maxResults`, `offset`, `response_format`, `uploadDateFilter`
  161. - **Date Filter**: `hour`, `today`, `week`, `month`, `year` (optional)
  162. - **Returns**: Video list with titles, channels, durations, URLs
  163. - **Supports**: JSON and Markdown formats
  164. </td>
  165. </tr>
  166. </table>
  167. ### πŸ“ Subtitles & Transcripts
  168. <table>
  169. <tr>
  170. <th width="30%">Tool</th>
  171. <th width="70%">Description</th>
  172. </tr>
  173. <tr>
  174. <td><code>ytdlp_list_subtitle_languages</code></td>
  175. <td>
  176. List all available subtitle languages for a video
  177. - **Parameters**: `url`
  178. - **Returns**: Available languages, formats, auto-generated status
  179. </td>
  180. </tr>
  181. <tr>
  182. <td><code>ytdlp_download_video_subtitles</code></td>
  183. <td>
  184. Download subtitles in VTT format with timestamps
  185. - **Parameters**: `url`, `language` (optional)
  186. - **Returns**: Raw VTT subtitle content
  187. </td>
  188. </tr>
  189. <tr>
  190. <td><code>ytdlp_download_transcript</code></td>
  191. <td>
  192. Generate clean plain text transcript
  193. - **Parameters**: `url`, `language` (optional)
  194. - **Returns**: Cleaned text without timestamps or formatting
  195. </td>
  196. </tr>
  197. </table>
  198. ### πŸŽ₯ Video & Audio Downloads
  199. <table>
  200. <tr>
  201. <th width="30%">Tool</th>
  202. <th width="70%">Description</th>
  203. </tr>
  204. <tr>
  205. <td><code>ytdlp_download_video</code></td>
  206. <td>
  207. Download video to Downloads folder
  208. - **Parameters**: `url`, `resolution`, `startTime`, `endTime`
  209. - **Resolutions**: 480p, 720p, 1080p, best
  210. - **Supports**: Video trimming
  211. </td>
  212. </tr>
  213. <tr>
  214. <td><code>ytdlp_download_audio</code></td>
  215. <td>
  216. Extract and download audio only
  217. - **Parameters**: `url`
  218. - **Format**: Best quality M4A/MP3
  219. </td>
  220. </tr>
  221. </table>
  222. ### πŸ“Š Metadata
  223. <table>
  224. <tr>
  225. <th width="30%">Tool</th>
  226. <th width="70%">Description</th>
  227. </tr>
  228. <tr>
  229. <td><code>ytdlp_get_video_metadata</code></td>
  230. <td>
  231. Extract comprehensive video metadata in JSON
  232. - **Parameters**: `url`, `fields` (optional array)
  233. - **Returns**: Complete metadata or filtered fields
  234. - **Includes**: Views, likes, upload date, tags, formats, etc.
  235. </td>
  236. </tr>
  237. <tr>
  238. <td><code>ytdlp_get_video_metadata_summary</code></td>
  239. <td>
  240. Get human-readable metadata summary
  241. - **Parameters**: `url`
  242. - **Returns**: Formatted text with key information
  243. </td>
  244. </tr>
  245. </table>
  246. ### πŸ’¬ Comments
  247. <table>
  248. <tr>
  249. <th width="30%">Tool</th>
  250. <th width="70%">Description</th>
  251. </tr>
  252. <tr>
  253. <td><code>ytdlp_get_video_comments</code></td>
  254. <td>
  255. Extract comments in flat JSON, threaded JSON, or AI-friendly Markdown
  256. - **Parameters**: `url`, `maxComments`, `sortOrder`, `view`, `responseFormat`, `maxParents`, `maxReplies`, `maxRepliesPerThread`, `maxDepth`
  257. - **Views**: `flat` (default) or `threaded`
  258. - **Formats**: `json` (default) or `markdown_tree` (`markdown_tree` requires threaded view)
  259. - **Returns**: Comment objects with `depth`, `reply_count`, `root_threads`, `reply_comments`, `orphan_comments`
  260. - **Graceful Degradation**: On platforms without parent metadata, threaded mode falls back to root-only comments
  261. </td>
  262. </tr>
  263. <tr>
  264. <td><code>ytdlp_get_video_comments_summary</code></td>
  265. <td>
  266. Get a human-readable summary of comments
  267. - **Parameters**: `url`, `maxComments`, `view`
  268. - **Views**: `flat` (linear summary) or `threaded` (grouped reply trees)
  269. - **Returns**: Readable comment digest with author badges, time, likes, and grouped replies
  270. </td>
  271. </tr>
  272. </table>
  273. ---
  274. ## πŸ’‘ Usage Examples
  275. ### Search Videos
  276. ```
  277. "Search for Python programming tutorials"
  278. "Find the top 20 machine learning videos"
  279. "Search for 'react hooks tutorial' and show results 10-20"
  280. "Search for JavaScript courses in JSON format"
  281. ```
  282. ### Get Metadata
  283. ```
  284. "Get metadata for https://youtube.com/watch?v=..."
  285. "Show me the title, channel, and view count for this video"
  286. "Extract just the duration and upload date"
  287. "Give me a quick summary of this video's info"
  288. ```
  289. ### Get Comments
  290. ```
  291. "Get the top 20 comments for https://youtube.com/watch?v=..."
  292. "Get comments as threaded JSON for this video"
  293. "Extract comments as markdown_tree so the reply branches stay intact"
  294. "Get newest comments with maxDepth 1 and maxRepliesPerThread 0"
  295. "Summarize comments in threaded view"
  296. ```
  297. ### Download Subtitles & Transcripts
  298. ```
  299. "List available subtitles for https://youtube.com/watch?v=..."
  300. "Download English subtitles from this video"
  301. "Get a clean transcript of this video in Spanish"
  302. "Download Chinese (zh-Hant) transcript"
  303. ```
  304. ### Download Content
  305. ```
  306. "Download this video in 1080p: https://youtube.com/watch?v=..."
  307. "Download audio from this YouTube video"
  308. "Download this video from 1:30 to 2:45"
  309. "Save this Facebook video to my Downloads"
  310. ```
  311. ---
  312. ## πŸ“– Documentation
  313. - **[API Reference](./docs/api.md)** - Detailed tool documentation
  314. - **[Configuration](./docs/configuration.md)** - Environment variables and settings
  315. - **[Cookie Configuration](./docs/cookies.md)** - Authentication and private video access
  316. - **[Error Handling](./docs/error-handling.md)** - Common errors and solutions
  317. - **[Contributing](./docs/contributing.md)** - How to contribute
  318. ---
  319. ## πŸ”§ Configuration
  320. ### Environment Variables
  321. ```bash
  322. # Downloads directory (default: ~/Downloads)
  323. YTDLP_DOWNLOADS_DIR=/path/to/downloads
  324. # Default resolution (default: 720p)
  325. YTDLP_DEFAULT_RESOLUTION=1080p
  326. # Default subtitle language (default: en)
  327. YTDLP_DEFAULT_SUBTITLE_LANG=en
  328. # Allow URLs that resolve to localhost/private/link-local addresses (default: false)
  329. YTDLP_ALLOW_PRIVATE_URLS=false
  330. ```
  331. Only `http`/`https` URLs are accepted, and URLs whose host resolves to a loopback, private, or link-local address (e.g. `localhost`, `192.168.x.x`, `169.254.169.254`) are rejected. Set `YTDLP_ALLOW_PRIVATE_URLS=true` if you need to fetch media from your local network.
  332. > **Limitation:** this check runs once on the URL you pass in, before yt-dlp starts. yt-dlp then makes its own connections, so it does **not** cover HTTP redirects to internal addresses or DNS rebinding. If you run this server where reaching internal services matters (e.g. a shared or cloud-hosted deployment), restrict outbound traffic at the network layer (container network policy, firewall, or blocking `169.254.169.254`).
  333. See the [Configuration Guide](./docs/configuration.md) for the full list.
  334. ### Proxy and yt-dlp Config File
  335. All tools read your yt-dlp config file (`~/.config/yt-dlp/config`), so any
  336. `--proxy`, `--cookies` or other options set there apply automatically. This is
  337. the only channel available to MCP clients that cannot pass environment
  338. variables to the server process.
  339. These are alternatives β€” set only the one you need:
  340. | Setting | Effect |
  341. |---------|--------|
  342. | `YTDLP_PROXY=socks5://127.0.0.1:1080` | Route all requests through this proxy |
  343. | `YTDLP_PROXY=` (empty) | Force a direct connection, overriding a proxy in the yt-dlp config file |
  344. | `YTDLP_IGNORE_CONFIG=1` | Skip all yt-dlp config files |
  345. Supported proxy schemes: `http`, `https`, `socks4`, `socks5`, `socks5h`.
  346. > `YTDLP_IGNORE_CONFIG=1` is not a straight revert to 0.9.x. The search,
  347. > metadata and comments tools always read the config file, so this setting
  348. > stops them from doing so as well.
  349. **MCP Configuration with a proxy:**
  350. ```json
  351. {
  352. "mcpServers": {
  353. "yt-dlp": {
  354. "command": "npx",
  355. "args": ["-y", "@kevinwatt/yt-dlp-mcp@latest"],
  356. "env": {
  357. "YTDLP_PROXY": "socks5://127.0.0.1:1080"
  358. }
  359. }
  360. }
  361. }
  362. ```
  363. If your MCP client cannot pass environment variables to the server, put the
  364. options in `~/.config/yt-dlp/config` instead β€” every tool reads that file:
  365. ```
  366. --proxy socks5://127.0.0.1:1080
  367. --cookies /path/to/cookies.txt
  368. ```
  369. > **Note**: Your config file applies to downloads as well. Options that change
  370. > the output format (`-x`, `--remux-video`, `--recode-video`) change what the
  371. > download tools produce; the tools report the file yt-dlp actually wrote, so
  372. > the reported name stays correct. Output-location options (`-o`, `-P`) have no
  373. > effect, because the tools always pass an absolute `--output` on the command
  374. > line, which takes precedence.
  375. >
  376. > **Note**: yt-dlp config files can contain options that execute commands
  377. > (`--exec`, `--postprocessor-args`, `--ffmpeg-location`). These now run on
  378. > tool invocations too, including ones triggered by an AI assistant. Set
  379. > `YTDLP_IGNORE_CONFIG=1` if you would rather the server ignore your config
  380. > file entirely.
  381. ### Cookie Configuration
  382. To access private videos, age-restricted content, or avoid rate limits, configure cookies:
  383. > ⚠️ **Important**: Cookie authentication requires a JavaScript runtime (deno) to be installed. When using cookies, YouTube uses authenticated API endpoints that require JavaScript challenge solving. Without deno, downloads will fail with "n challenge solving failed" error.
  384. >
  385. > Install deno: https://docs.deno.com/runtime/getting_started/installation/
  386. ```bash
  387. # Extract cookies from browser (recommended)
  388. YTDLP_COOKIES_FROM_BROWSER=chrome
  389. # Or use a cookie file
  390. YTDLP_COOKIES_FILE=/path/to/cookies.txt
  391. ```
  392. **MCP Configuration with cookies:**
  393. ```json
  394. {
  395. "mcpServers": {
  396. "yt-dlp": {
  397. "command": "npx",
  398. "args": ["-y", "@kevinwatt/yt-dlp-mcp@latest"],
  399. "env": {
  400. "YTDLP_COOKIES_FROM_BROWSER": "chrome"
  401. }
  402. }
  403. }
  404. }
  405. ```
  406. Supported browsers: `brave`, `chrome`, `chromium`, `edge`, `firefox`, `opera`, `safari`, `vivaldi`, `whale`
  407. See [Cookie Configuration Guide](./docs/cookies.md) for detailed setup instructions.
  408. ---
  409. ## πŸ—οΈ Architecture
  410. ### Built With
  411. - **[yt-dlp](https://github.com/yt-dlp/yt-dlp)** - Video extraction engine
  412. - **[MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk)** - Model Context Protocol
  413. - **[Zod](https://github.com/colinhacks/zod)** - TypeScript-first schema validation
  414. - **TypeScript** - Type safety and developer experience
  415. ### Key Features
  416. - βœ… **Type-Safe**: Full TypeScript with strict mode
  417. - βœ… **Validated Inputs**: Zod schemas for runtime validation
  418. - βœ… **Character Limits**: Automatic truncation to prevent context overflow
  419. - βœ… **Tool Annotations**: readOnly, destructive, idempotent hints
  420. - βœ… **Error Guidance**: Actionable error messages for LLMs
  421. - βœ… **Modular Design**: Clean separation of concerns
  422. ---
  423. ## πŸ“Š Response Formats
  424. ### JSON Format
  425. Perfect for programmatic processing:
  426. ```json
  427. {
  428. "total": 50,
  429. "count": 10,
  430. "offset": 0,
  431. "videos": [...],
  432. "has_more": true,
  433. "next_offset": 10
  434. }
  435. ```
  436. ### Markdown Format
  437. Human-readable display:
  438. ```markdown
  439. Found 50 videos (showing 10):
  440. 1. **Video Title**
  441. πŸ“Ί Channel: Creator Name
  442. ⏱️ Duration: 10:30
  443. πŸ”— URL: https://...
  444. ```
  445. ### Comment Markdown Tree
  446. Useful for LLM analysis when reply context matters:
  447. ```markdown
  448. # AI-Ready Comment Threads
  449. source_title: "Sample Video"
  450. comments_detected: 20
  451. root_threads: 6
  452. reply_comments: 14
  453. ## Threads
  454. ### Thread 1
  455. - comment_id: "abc123"
  456. parent_id: "root"
  457. depth: 0
  458. reply_count: 2
  459. text:
  460. | Root comment text
  461. - comment_id: "reply456"
  462. parent_id: "abc123"
  463. depth: 1
  464. reply_count: 0
  465. text:
  466. | Reply text
  467. ```
  468. ### Comment Limits
  469. YouTube comment extraction supports the full extractor tuple:
  470. ```text
  471. youtube:comment_sort=<sort>;max_comments=<total>,<parents>,<replies>,<repliesPerThread>,<depth>
  472. ```
  473. Examples:
  474. - Default behavior: `maxComments=20` yields `max_comments=20,20,20,20,2`
  475. - Root-only comments: `maxDepth=1`, `maxRepliesPerThread=0`
  476. - Limited branching: `maxReplies=40`, `maxRepliesPerThread=5`, `maxDepth=2`
  477. ---
  478. ## πŸ”’ Privacy & Security
  479. - **No Tracking**: Direct downloads, no analytics
  480. - **Input Validation**: Zod schemas prevent injection
  481. - **URL Validation**: Strict URL format checking
  482. - **Character Limits**: Prevents context overflow attacks
  483. - **Read-Only by Default**: Most tools don't modify system state
  484. ---
  485. ## 🀝 Contributing
  486. Contributions are welcome! Please check out our [Contributing Guide](./docs/contributing.md).
  487. 1. Fork the repository
  488. 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
  489. 3. Commit your changes (`git commit -m 'Add amazing feature'`)
  490. 4. Push to the branch (`git push origin feature/amazing-feature`)
  491. 5. Open a Pull Request
  492. ---
  493. ## πŸ“ License
  494. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  495. ---
  496. ## πŸ™ Acknowledgments
  497. - [yt-dlp](https://github.com/yt-dlp/yt-dlp) - The amazing video extraction tool
  498. - [Anthropic](https://www.anthropic.com/) - For the Model Context Protocol
  499. - [Dive](https://github.com/OpenAgentPlatform/Dive) - MCP-compatible AI platform
  500. ---
  501. ## πŸ“š Related Projects
  502. - [MCP Servers](https://github.com/modelcontextprotocol/servers) - Official MCP server implementations
  503. - [yt-dlp](https://github.com/yt-dlp/yt-dlp) - Command-line video downloader
  504. - [Dive Desktop](https://github.com/OpenAgentPlatform/Dive) - AI agent platform
  505. ---
  506. <div align="center">
  507. [⬆ Back to Top](#-yt-dlp-mcp)
  508. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.