{"_id":"@ddacunha/yt-dlp-mcp","name":"@ddacunha/yt-dlp-mcp","dist-tags":{"latest":"0.7.0"},"versions":{"0.7.0":{"name":"@ddacunha/yt-dlp-mcp","version":"0.7.0","description":"An MCP server implementation that integrates with yt-dlp, providing video, audio, and comment download capabilities (e.g. YouTube, Facebook, Tiktok, etc.) for LLMs.","keywords":["mcp","youtube","yt-dlp","dive","llm","comments"],"homepage":"https://github.com/ddacunha/yt-dlp-mcp#readme","bugs":{"url":"https://github.com/ddacunha/yt-dlp-mcp/issues"},"repository":{"type":"git","url":"git+https://github.com/ddacunha/yt-dlp-mcp.git"},"bin":{"yt-dlp-mcp":"lib/index.mjs"},"main":"./lib/index.mjs","scripts":{"prepare":"tsc && shx chmod +x ./lib/index.mjs","test":"PYTHONPATH= PYTHONHOME= node --experimental-vm-modules node_modules/jest/bin/jest.js --detectOpenHandles --forceExit"},"author":{"name":"Dewei Yen","email":"k@funmula.com"},"contributors":[{"name":"David Da Cunha"}],"license":"MIT","type":"module","exports":{".":{"import":"./lib/index.mjs"}},"dependencies":{"@modelcontextprotocol/sdk":"0.7.0","rimraf":"^6.0.1","spawn-rx":"^4.0.0"},"devDependencies":{"@jest/globals":"^29.7.0","@types/jest":"^29.5.14","@types/node":"^22.14.0","jest":"^29.7.0","shx":"^0.3.4","ts-jest":"^29.2.5","ts-node":"^10.9.2","typescript":"^5.6.3"},"_id":"@ddacunha/yt-dlp-mcp@0.7.0","gitHead":"db96b07d3c2ee22484b1873631e19e8c7c1c2286","_nodeVersion":"23.10.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-uKcb0l3ylAdlAlsokKilmikbJve1ObxjH6kQgP99yhwlTN9rB8GaZT+JgZ6Fgju603d+OMmXfN41WVdgC+abWQ==","shasum":"362183a10933e9706f9a6d464ab22e8c7b08c82b","tarball":"https://registry.npmjs.org/@ddacunha/yt-dlp-mcp/-/yt-dlp-mcp-0.7.0.tgz","fileCount":39,"unpackedSize":83694,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFzyNTi+Mi5+Zet5PDomtQ3u8toLAKMFpRbxFQ29lMyfAiBEbV4ko50TJOhm15gnI3UUnxlFxV3A7w4R62/w5HSPqg=="}]},"_npmUser":{"name":"ddacunha","email":"daniel@ddc.im"},"directories":{},"maintainers":[{"name":"ddacunha","email":"daniel@ddc.im"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/yt-dlp-mcp_0.7.0_1744028629972_0.8994772884065043"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-07T12:23:49.895Z","0.7.0":"2025-04-07T12:23:50.171Z","modified":"2025-04-07T12:23:50.416Z"},"maintainers":[{"name":"ddacunha","email":"daniel@ddc.im"}],"description":"An MCP server implementation that integrates with yt-dlp, providing video, audio, and comment download capabilities (e.g. YouTube, Facebook, Tiktok, etc.) for LLMs.","homepage":"https://github.com/ddacunha/yt-dlp-mcp#readme","keywords":["mcp","youtube","yt-dlp","dive","llm","comments"],"repository":{"type":"git","url":"git+https://github.com/ddacunha/yt-dlp-mcp.git"},"contributors":[{"name":"David Da Cunha"}],"author":{"name":"Dewei Yen","email":"k@funmula.com"},"bugs":{"url":"https://github.com/ddacunha/yt-dlp-mcp/issues"},"license":"MIT","readme":"# yt-dlp-mcp (Enhanced Fork)\n\n*This is a fork of [@kevinwatt/yt-dlp-mcp](https://github.com/kevinwatt/yt-dlp-mcp) with added comment download functionality.*\n\nAn MCP server implementation that integrates with yt-dlp, providing video, audio, and comment download capabilities (e.g. YouTube, Facebook, Tiktok, etc.) for LLMs.\n\n## Features\n\n* **Subtitles**: Download subtitles in SRT format for LLMs to read\n* **Video Download**: Save videos to your Downloads folder with resolution control\n* **Audio Download**: Save audios to your Downloads folder\n* **Comments**: Download and format video comments with metadata\n* **Privacy-Focused**: Direct download without tracking\n* **MCP Integration**: Works with Dive and other MCP-compatible LLMs\n\n## Installation\n\n### Prerequisites\n\nInstall `yt-dlp` based on your operating system:\n\n```bash\n# Windows\nwinget install yt-dlp\n\n# macOS\nbrew install yt-dlp\n\n# Linux\npip install yt-dlp\n```\n\n### With [Dive Desktop](https://github.com/OpenAgentPlatform/Dive)\n\n1. Click \"+ Add MCP Server\" in Dive Desktop\n2. Copy and paste this configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"yt-dlp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@ddacunha/yt-dlp-mcp\"\n      ]\n    }\n  }\n}\n```\n3. Click \"Save\" to install the MCP server\n\n## Tool Documentation\n\n* **list_subtitle_languages**\n  * List all available subtitle languages and their formats for a video (including auto-generated captions)\n  * Inputs:\n    * `url` (string, required): URL of the video\n\n* **download_video_subtitles**\n  * Download video subtitles in any available format. Supports both regular and auto-generated subtitles\n  * Inputs:\n    * `url` (string, required): URL of the video\n    * `language` (string, optional): Language code (e.g., 'en', 'zh-Hant', 'ja'). Defaults to 'en'\n\n* **download_video**\n  * Download video to user's Downloads folder\n  * Inputs:\n    * `url` (string, required): URL of the video\n    * `resolution` (string, optional): Video resolution ('480p', '720p', '1080p', 'best'). Defaults to '720p'\n\n* **download_audio**\n  * Download audio in best available quality (usually m4a/mp3 format) to user's Downloads folder\n  * Inputs:\n    * `url` (string, required): URL of the video\n\n* **download_comments**\n  * Download comments for a video and return them in JSON format\n  * Inputs:\n    * `url` (string, required): URL of the video\n\n## Usage Examples\n\nAsk your LLM to:\n```\n\"List available subtitles for this video: https://youtube.com/watch?v=...\"\n\"Download a video from facebook: https://facebook.com/...\"\n\"Download Chinese subtitles from this video: https://youtube.com/watch?v=...\"\n\"Download this video in 1080p: https://youtube.com/watch?v=...\"\n\"Download audio from this YouTube video: https://youtube.com/watch?v=...\"\n\"Get the comments from this YouTube video: https://youtube.com/watch?v=...\"\n```\n\n## Manual Start\n\nIf needed, start the server manually:\n```bash\nnpx @ddacunha/yt-dlp-mcp\n```\n\n## Requirements\n\n* Node.js 20+\n* `yt-dlp` in system PATH\n* MCP-compatible LLM service\n\n\n## Documentation\n\n- [API Reference](./docs/api.md)\n- [Configuration](./docs/configuration.md)\n- [Error Handling](./docs/error-handling.md)\n- [Contributing](./docs/contributing.md)\n\n\n## License\n\nMIT\n\n## Author\n\nDewei Yen\n\n\n","readmeFilename":"README.md","_rev":"1-b37de303e2a93ea0c6a7b66140d3eb68"}