YouTube Media Downloader

# Youtube Media Downloader MCP Server English | [简体中文](./README.md) | [繁體中文](./README_ZH-TW.md) An MCP server for accessing Youtube Media Downloader API. ## 🚀 Quick Start with EMCP Platform **[EMCP](https://sit-emcp.kaleido.guru)** is a powerful MCP server management platform that allows you to quickly use various MCP servers without manual configuration! ### Quick Start: 1. 🌐 Visit **[EMCP Platform](https://sit-emcp.kaleido.guru)** 2. 📝 Register and login 3. 🎯 Go to **MCP Marketplace** to browse all available MCP servers 4. 🔍 Search or find this server (`bach-youtube_media_downloader`) 5. 🎉 Click the **"Install MCP"** button 6. ✅ Done! You can now use it in your applications ### EMCP Platform Advantages: - ✨ **Zero Configuration**: No need to manually edit config files - 🎨 **Visual Management**: Easy-to-use GUI for managing all MCP servers - 🔐 **Secure & Reliable**: Centralized API key and authentication management - 🚀 **One-Click Install**: Rich selection of servers in MCP Marketplace - 📊 **Usage Statistics**: Real-time service call monitoring Visit **[EMCP Platform](https://sit-emcp.kaleido.guru)** now to start your MCP journey! --- ## Introduction This is an MCP server for accessing the Youtube Media Downloader API. - **PyPI Package**: `bach-youtube_media_downloader` - **Version**: 1.0.0 - **Transport Protocol**: stdio ## 安装 ### 从 PyPI 安装: ```bash pip install bach-youtube_media_downloader ``` ### 从源码安装: ```bash pip install -e . ``` ## 运行 ### 方式 1: 使用 uvx（推荐，无需安装） ```bash # 运行（uvx 会自动安装并运行） uvx --from bach-youtube_media_downloader bach_youtube_media_downloader # 或指定版本 uvx --from bach-youtube_media_downloader@latest bach_youtube_media_downloader ``` ### 方式 2: 直接运行（开发模式） ```bash python server.py ``` ### 方式 3: 安装后作为命令运行 ```bash # 安装 pip install bach-youtube_media_downloader # 运行（命令名使用下划线） bach_youtube_media_downloader ``` ## Configuration ### API Authentication This API requires authentication. Please set environment variable: ```bash export API_KEY="your_api_key_here" ``` ### Environment Variables | Variable | Description | Required | |----------|-------------|----------| | `API_KEY` | API Key | Yes | | `PORT` | N/A | No | | `HOST` | N/A | No | ### Using with Cursor Edit Cursor MCP config file `~/.cursor/mcp.json`: ```json { "mcpServers": { "bach-youtube_media_downloader": { "command": "uvx", "args": ["--from", "bach-youtube_media_downloader", "bach_youtube_media_downloader"], "env": { "API_KEY": "your_api_key_here" } } } } ``` ### Using with Claude Desktop Edit Claude Desktop config file `claude_desktop_config.json`: ```json { "mcpServers": { "bach-youtube_media_downloader": { "command": "uvx", "args": ["--from", "bach-youtube_media_downloader", "bach_youtube_media_downloader"], "env": { "API_KEY": "your_api_key_here" } } } } ``` ## 可用工具 此服务器提供以下工具: ### `get_video_details_price_1_3` This endpoint fetches full details of a YouTube video, including URLs of videos, audios, thumbnails and subtitles as well as related videos and playlists. **端点**: `GET /v2/video/details` **参数**: - `videoId` (string) *必需*: YouTube video id. The value of v in YouTube player URL query parameters. - `urlAccess` (string): Accessibility to video/audio URLs. Defaults to normal. normal: Includes video/audio file URLs – 3 quota units blocked: Excludes video/audio file URLs – 1 quota unit - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `videos` (string): Whether to get video objects. Defaults to auto. true: Includes simplified objects. raw: Includes original format objects. false: Excludes objects. auto: If urlAccess=normal, sets videos=true. If urlAccess=blocked, sets videos=false. - `audios` (string): Whether to get audio objects. Defaults to auto. true: Includes simplified objects. raw: Includes original format objects. false: Excludes objects. auto: If urlAccess=normal, sets audios=true. If urlAccess=blocked, sets audios=false. - `subtitles` (string): Example value: - `related` (string): Example value: --- ### `list_playlist_videos` This endpoint lists **available** videos of a YouTube playlist (unavailable ones won't be listed by YouTube). Pagination scraping is supported. Thumbnails won't be blurred by age safety. **端点**: `GET /v2/playlist/videos` **参数**: - `playlistId` (string): Example value: PLeCdlPO-XhWFzEVynMsmosfdRsIZXhZi0 - `lang` (string): Language code (IETF language tag) for localized results. Default to be en-US. Unsupported code will fallback to en-US. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, playlistId will be ignored. --- ### `get_playlist_details` This endpoint fetches details of a YouTube playlist (user created playlist, album or radio playlist). **端点**: `GET /v2/playlist/details` **参数**: - `playlistId` (string) *必需*: Example value: PLeCdlPO-XhWFzEVynMsmosfdRsIZXhZi0 - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `videos` (string): Example value: --- ### `list_items_with_next_token` An endpoint to list items with any type of `nextToken`. This allows longer `nextToken` (\u003e4KB) by putting it in the request body instead of the URL/header, bypassing the usual size limit of the URL/header. **端点**: `POST /v2/misc/list-items` **参数**: - `nextToken` (string) *必需*: A string for getting the next page of data. You can only get this string from the response of listing endpoints in this API, like Video > List Video Comments, Search > Search for Channels, and Misc > List Items with Next Token. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. --- ### `list_hashtag_videos` This endpoint lists YouTube videos related to the hashtag. Pagination scraping is supported. **端点**: `GET /v2/hashtag/videos` **参数**: - `tag` (string): A hashtag without #. Try lowercase (e.g., howtocook, not HowToCook) if no results. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `type` (string): Video type. Defaults to all. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, tag and type will be ignored. --- ### `list_channel_playlistsreleasespodcasts` This endpoint lists playlists, releases or podcasts of a YouTube channel. Pagination scraping is supported. **端点**: `GET /v2/channel/playlists` **参数**: - `channelId` (string): Channel ID, custom URL name or handle. @ is required as a prefix for a channel handle. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `type` (string): playlists - Playlists (default value) releases - Releases (sortBy will be omitted) podcasts - Podcasts (sortBy will be omitted) - `sortBy` (string): Sorting metrics. Defaults to dateAdded. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, channelId, type and sortBy will be ignored. --- ### `list_channel_videosshortslive` This endpoint lists videos, shorts or live streams of a YouTube channel. Pagination scraping is supported. **端点**: `GET /v2/channel/videos` **参数**: - `channelId` (string): Channel ID, custom URL name or handle. @ is required as a prefix for a channel handle. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `type` (string): Video type. Defaults to videos. - `sortBy` (string): Sorting metrics. Defaults to newest. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, channelId, type and sortBy will be ignored. --- ### `search_for_channels` This endpoint searches for YouTube channels. Pagination scraping is supported. **端点**: `GET /v2/search/channels` **参数**: - `keyword` (string): Search term. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `sortBy` (string): Sorting metrics. Defaults to relevance. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, keyword and sortBy will be ignored. --- ### `search_for_videos_movies` This endpoint searches for YouTube videos (movies) with optional filters. Pagination scraping is supported. Thumbnails will not be blurred by age safety. **端点**: `GET /v2/search/videos` **参数**: - `keyword` (string): Search term. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `movie` (string): Example value: - `uploadDate` (string): Upload date. Defaults to all. - `duration` (string): all - No duration limit (default value) short - Under 4 minutes medium - 4 - 20 minutes long - Over 20 minutes - `sortBy` (string): Sorting metrics. Defaults to relevance. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, keyword, movie, uploadDate, duration and sortBy will be ignored. --- ### `list_video_comments` This endpoint lists comments of a YouTube video. Pagination scraping is supported. **端点**: `GET /v2/video/comments` **参数**: - `videoId` (string): YouTube video id. The value of v in YouTube player URL query parameters. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `sortBy` (string): Sorting metrics. Defaults to top. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, videoId and sortBy will be ignored. --- ### `list_related_videos_and_playlists` This endpoint lists related videos and playlists of a YouTube video. Pagination scraping is supported. It's recommended to get the first page by calling `Video \u003e Get Video Details`, and then get subsequent pages here. **端点**: `GET /v2/video/related` **参数**: - `videoId` (string): YouTube video id. The value of v in YouTube player URL query parameters. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, videoId will be ignored. --- ### `search_for_playlists` This endpoint searches for YouTube playlists. Pagination scraping is supported. Thumbnails will not be blurred by age safety. **端点**: `GET /v2/search/playlists` **参数**: - `keyword` (string): Search term. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `sortBy` (string): Sorting metrics. Defaults to relevance. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, keyword and sortBy will be ignored. --- ### `list_autocomplete_suggestions` This endpoint lists autocomplete predictions depending on the keyword. **端点**: `GET /v2/search/suggestions` **参数**: - `keyword` (string) *必需*: Search term. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. - `region` (string): Region code (ISO 3166 alpha-2) for localized results. Defaults to US. --- ### `list_post_comments` This endpoint lists comments of a YouTube community post. Pagination scraping is supported. **端点**: `GET /v2/post/comments` **参数**: - `postId` (string): Example value: Ugkx-rW0UIVSt9Aw-ux-w16DlRW-wwKwfwnp - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `sortBy` (string): Sorting metrics. Defaults to top. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, postId and sortBy will be ignored. --- ### `get_post_details` This endpoint fetches details of a YouTube community post. **端点**: `GET /v2/post/details` **参数**: - `postId` (string) *必需*: Example value: Ugkx-rW0UIVSt9Aw-ux-w16DlRW-wwKwfwnp - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. --- ### `search_for_channel_videos_and_playlists` This endpoint searches for videos and playlists in a YouTube Channel. Pagination scraping is supported. **端点**: `GET /v2/channel/search` **参数**: - `channelId` (string): Channel ID, custom URL name or handle. @ is required as a prefix for a channel handle. - `keyword` (string): Search term. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, channelId and keyword will be ignored. --- ### `list_channel_posts_pollvideoimage` This endpoint lists poll, video, or image posts of a YouTube channel. Pagination scraping is supported. **端点**: `GET /v2/channel/posts` **参数**: - `channelId` (string): Channel ID, custom URL name or handle. @ is required as a prefix for a channel handle. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. - `nextToken` (string): A string for getting the next page of data. If not specified, the first page of data will be returned. If specified, channelId will be ignored. --- ### `get_channel_details` This endpoint fetches details of a YouTube channel. **端点**: `GET /v2/channel/details` **参数**: - `channelId` (string) *必需*: Channel ID, custom URL name or handle. @ is required as a prefix for a channel handle. - `lang` (string): Language code (IETF language tag) for localized results. Defaults to en-US. Unsupported code will fallback to en-US. --- ### `translate_convert_download_subtitle` This endpoint lets you translate, convert and download a subtitle of a YouTube video. Before doing this, please call endpoint `Video \u003e Get Video Details` to obtain subtitle URLs. **端点**: `GET /v2/video/subtitles` **参数**: - `subtitleUrl` (string) *必需*: Subtitle URL of a YouTube video. To get this, please call Video > Get Video Details first. - `format` (string): Subtitle format. Defaults to srt. - `fixOverlap` (string): Example value: - `targetLang` (string): Target language (IETF language tag) into which the subtitle will be translated. Leave blank to preserve the original language. Unsupported code will fallback to the original language. --- ## Tech Stack - **Transport Protocol**: stdio - **HTTP Client**: httpx ## License MIT License - See [LICENSE](./LICENSE) file for details. ## Development This server is generated by [API-to-MCP](https://github.com/BACH-AI-Tools/api-to-mcp) tool. Version: 1.0.0