Yt Api MCP Server
用于访问 Yt Api API 的 MCP 服务器。
🚀 使用 EMCP 平台快速体验
EMCP 是一个强大的 MCP 服务器管理平台，让您无需手动配置即可快速使用各种 MCP 服务器！
快速开始：
- 🌐 访问 EMCP 平台
- 📝 注册并登录账号
- 🎯 进入 MCP 广场，浏览所有可用的 MCP 服务器
- 🔍 搜索或找到本服务器（
bach-yt_api） - 🎉 点击 "安装 MCP" 按钮
- ✅ 完成！即可在您的应用中使用
EMCP 平台优势：
- ✨ 零配置：无需手动编辑配置文件
- 🎨 可视化管理：图形界面轻松管理所有 MCP 服务器
- 🔐 安全可靠：统一管理 API 密钥和认证信息
- 🚀 一键安装：MCP 广场提供丰富的服务器选择
- 📊 使用统计：实时查看服务调用情况
立即访问 EMCP 平台 开始您的 MCP 之旅！
简介
这是一个 MCP 服务器，用于访问 Yt Api API。
- PyPI 包名:
bach-yt_api - 版本: 1.0.0
- 传输协议: stdio
安装
从 PyPI 安装:
pip install bach-yt_api
从源码安装:
pip install -e .
运行
方式 1: 使用 uvx（推荐，无需安装）
# 运行（uvx 会自动安装并运行）
uvx --from bach-yt_api bach_yt_api
# 或指定版本
uvx --from bach-yt_api@latest bach_yt_api
方式 2: 直接运行（开发模式）
python server.py
方式 3: 安装后作为命令运行
# 安装
pip install bach-yt_api
# 运行（命令名使用下划线）
bach_yt_api
配置
API 认证
此 API 需要认证。请设置环境变量:
export API_KEY="your_api_key_here"
环境变量
| 变量名 | 说明 | 必需 |
|---|---|---|
API_KEY | API 密钥 | 是 |
PORT | 不适用 | 否 |
HOST | 不适用 | 否 |
在 Cursor 中使用
编辑 Cursor MCP 配置文件 ~/.cursor/mcp.json:
{
"mcpServers": {
"bach-yt_api": {
"command": "uvx",
"args": ["--from", "bach-yt_api", "bach_yt_api"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
在 Claude Desktop 中使用
编辑 Claude Desktop 配置文件 claude_desktop_config.json:
{
"mcpServers": {
"bach-yt_api": {
"command": "uvx",
"args": ["--from", "bach-yt_api", "bach_yt_api"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
可用工具
此服务器提供以下工具:
channel_videos_via_post
Get videos listing along with channel details Quota cost is 2 unit.
端点: POST /channel/videos
参数:
-
id(string): Example value: UCMhe8jmac-tWKU0Vj_OXDvA -
forUsername(string): If id not available then provide username. Quota cost +1. -
sort_by(string): Sorts the channel videos. Available options: newest [default] oldest popular -
token(string): Pagination token -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
local(string): Get localized data, the value must be 1. Works with provided value of geo, if not provided then default is US. Quota Cost +1
channel_videos
Get channel video listing and channel details. Quota cost is 1 unit.
端点: GET /channel/videos
参数:
-
id(string): Channel Id -
forUsername(string): If id not available then provide username. Quota cost +1. -
sort_by(string): Sorts the channel videos. Available options: newest [default] popular oldest -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Locale/language for request. Like en, gb, hi, etc -
local(string): Get localized data, the value must be 1. Works with provided value of geo, if not provided then default is US. Quota Cost +1 -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
channel_livestreams_via_post
Get livestreams listing along with channel details Quota cost is 2 unit.
端点: POST /channel/liveStreams
参数:
-
id(string): Example value: UCAuUUnT6oDeKwE6v1NGQxug -
forUsername(string): If id not available then provide username. Quota cost +1. -
sort_by(string): Sorts the channel videos. Available options: newest [default] oldest popular -
token(string): Pagination token -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
local(string): Get localized data, the value must be 1. Works with provided value of geo, if not provided then default is US. Quota Cost +1
channel_livestreams
Get live stream listing and channel details. Quota cost is 1 unit.
端点: GET /channel/liveStreams
参数:
-
id(string): Example value: UCAuUUnT6oDeKwE6v1NGQxug -
forUsername(string): If id not available then provide username. Quota cost +1. -
sort_by(string): Sorts the channel's live streams. Available options: newest [default] popular oldest -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
local(string): Get localized data, the value must be 1. Works with provided value of geo, if not provided then default is US. Quota Cost +1 -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
channel_shorts_via_post
Get shorts listing along with channel details Quota cost is 2 unit.
端点: POST /channel/shorts
参数:
-
id(string): Example value: UCMhe8jmac-tWKU0Vj_OXDvA -
forUsername(string): If id not available then provide username. Quota cost +1. -
sort_by(string): Sorts the channel videos. Available options: newest [default] oldest popular -
token(string): Pagination token -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
local(string): Get localized data, the value must be 1. Works with provided value of geo, if not provided then default is US. Quota Cost +1
channel_shorts
Get shorts listing along with channel details Quota cost is 1 unit.
端点: GET /channel/shorts
参数:
-
id(string): Example value: UCMhe8jmac-tWKU0Vj_OXDvA -
forUsername(string): If id not available then provide username. Quota cost +1. -
sort_by(string): Sorts the channel videos. Available options: newest [default] oldest popular -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
local(string): Get localized data, the value must be 1. Works with provided value of geo, if not provided then default is US. Quota Cost +1 -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
channel_home
Get Channel's Home Tab Listings. Quota cost is 1 unit.
端点: GET /channel/home
参数:
-
id(string): Channel Id -
forUsername(string): If id not available then provide username. Quota cost +1. -
token(string): Pagination token Alternatively, use X-TOKEN in header -
params(string): Example value: -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
screenshot
Get screenshot in JPG format. Quota Cost +4
端点: GET /video/screenshot
参数:
-
id(string) 必需: Youtube video id -
timeStamp(string) 必需: Format must be HH:MM:SS
related_videos_or_playlists
Get related videos or playlists. Quota cost is 1 unit.
端点: GET /related
参数:
-
id(string) 必需: Video id -
token(string): Pagination token -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Locale/language for request. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
metadata_update
Update viewCount, likeCount. Useful for Live videos. Quota Cost +1
端点: GET /updated_metadata
参数:
id(string) 必需: Youtube video id or multiple ids separated by , For mutli id batch request, quota cost is +1 for each extra id. Note: Mutli id batch request is experimental.
transcript
Get Transcript. Quota Cost +1
端点: GET /get_transcript
参数:
-
id(string) 必需: Youtube video id -
params(string): Example value: -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
video_details
Get all the details of the YouTube video. Quota cost is 1 unit.
端点: GET /video/info
参数:
-
id(string) 必需: Youtube video id or multiple ids separated by , For mutli id batch request, quota cost is +1 for each extra id. Note: Mutli id batch request is experimental. -
extend(string): Extend the results to include more details like related videos/playlist, comment count, etc. Available options: 1 = for likeCount, commentCount, subscriberCountText, relatedVideos, channelBadges, chapters, merchandise,extraMeta,videoAttribution (not supported for multi ids) 2 = for likeCount, commentCount, channelHandle Quota cost is +1 -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
converttranslatedownload_subtitle
Convert, translate, download the subtitle. To get the subtitle url, use Video -\u003e Subtitles endpoint or Video -\u003e Details endpoint Quota cost is 1 unit.
端点: GET /subtitle
参数:
-
url(string) 必需: Provide the Subtitle url. Available in the Video -> Subtitles or Video -> Details endpoint response. -
format(string): Subtitle format options: json3 [mime: json] srv1 [mime: xml] [default] srv2 [mime: xml] srv3 [mime: xml] ttml [mime: xml] vtt [mime: text] srt [mime: text] -
targetLang(string): Translate to Language. Valid codes are in the translationLanguages param of the Video -> Subtitles or Video -> Info endpoint response. Or provide ISO-639 code of the language like es, zh-Hans, co, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
subtitles
Get the list of available subtitles for the video. Quota cost is 1 unit.
端点: GET /subtitles
参数:
-
id(string) 必需: Example value: arj7oStGLkU -
format(string): Subtitle format options: json3 [mime: json] srv1 [mime: xml] [default] srv2 [mime: xml] srv3 [mime: xml] ttml [mime: xml] vtt [mime: text] srt [mime: text] -
X-CACHEBYPASS(string): Example value:
downloadstream
Stream or download info. Quota cost is 1 units.
端点: GET /dl
参数:
-
id(string) 必需: Youtube Video Id or Shorts Id. -
cgeo(string) 必需: Country code in ISO 3166 format of the end user. Not providing cgeo param may cost +1 quota. It is important to provide geo of the end user to get the best speed and direct links. If links are used in the server, then cgeo will be the geo of the server. Not providing cgeo param may lead to 403 issue -
lang(string): Language code for audio results based on availability. Like en, ru, hi, etc
channel_store
Get store product listing and channel details. Quota cost is 1 unit.
端点: GET /channel/store
参数:
-
id(string): Channel Id -
forUsername(string): If id not available then provide username. Quota cost +1. -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
query_suggestion__auto_completion
Query Suggestion / Auto-Completion.
端点: GET /suggest_queries
参数:
-
query(string) 必需: Example value: cat -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Locale/language for request. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
about_channel
Get channel details. Quota cost is 2 unit.
端点: GET /channel/about
参数:
-
id(string) 必需: Channel Id -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
forUsername(string): Example value: -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
post_details
Get post details. Quota cost is 1 unit.
端点: GET /post/info
参数:
-
id(string) 必需: Post Id -
channelId(string): Channel Id -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Locale/language for request. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
shorts_sequence
Get Shorts sequence. Quota cost is 2 units.
端点: GET /shorts/sequence
参数:
-
params(string): Sequence param Provide either of these values: sequenceContiuation value from Shorts Info Endpoint's response for WHATTOWATCH continuation value from the previous request's response -
id(string): If the params value is not available then Shorts Video Id may be provided. But it is not recommended. -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
shorts_details
Get Youtube Shorts video info or get Suggested Shorts video info. Quota cost is 1 unit for Shorts Video Info Quota cost is 2 units for suggested Shorts Video Info.
端点: GET /shorts/info
参数:
-
id(string) 必需: Available options: Shorts Video Id to get info or WHATTOWATCH for suggested Shorts along with info. -
params(string): Shorts video param -
extend(string): Extend the results to include more details. The value must be 1 Quota cost is +1 -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
trending
Get trending videos region-wise \u0026 niche-wise. Quota cost is 1 unit.
端点: GET /trending
参数:
-
geo(string) 必需: ISO 3166-2 country code of the region for which you want the trending data. Like US (default), GB, CA, IN, etc. -
type(string): Trending type: now music games movies Default is now -
lang(string): Locale/language for request. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
search
Search videos, playlists, channels, or all of them. Quota cost is 2 units.
端点: GET /search
参数:
-
query(string) 必需: Search term -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Locale/language for request. Like en, gb, hi, etc -
type(string): Search type filter options: video channel playlist movie show shorts Sorting is not available in shorts -
duration(string): Duration filter options: short - less than 4 min medium - 4 to 20 min long - more than 20 min -
features(string): Video Features options: HD subtitles CCommons 3D Live Purchased 4K 360 Location HDR VR180 Multiple features could be joined by ',' For example: HD,subtitles -
upload_date(string): Upload Date filter options: hour today week month year -
sort_by(string): Results Sort options: relevance [default] rating date views -
local(number): Get localized data, the value must be 1. Works with provided value of geo, if not provided then default is US. Quota Cost +1 -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
comments
Get video's or shorts' comments/thread. Quota cost is 1 unit.
端点: GET /comments
参数:
-
id(string) 必需: Video Id or Shorts Video Id -
token(string): Pagination token Alternatively, use X-TOKEN in header -
sort_by(string): Available options: newest top [default] -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Locale/language for request. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
playlist
Get playlist details and video listing. Quota cost is 1 unit.
端点: GET /playlist
参数:
-
id(string) 必需: Playlist Id -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Locale/language for request. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
home_feed
Get home feeds, region-wise \u0026 niche-wise. Quota cost is 1 unit.
端点: GET /home
参数:
-
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Locale/language for request. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
hashtag
Get videos or Shorts listings related to any hashtag. Quota cost is 1 unit.
端点: GET /hashtag
参数:
-
tag(string) 必需: Example value: viral -
type(string): Available options are all for videos and shorts shorts for only shorts -
params(string): Hashtag params -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
post_comments
Get post's comments or thread. Quota cost is 1 unit.
端点: GET /post/comments
参数:
-
id(string) 必需: Post Id -
channelId(string): Channel Id -
sort_by(string): Available options: newest top [default] -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Locale/language for request. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
shorts_sound_attribution
Get the Shorts original sound attribution listing. Quota cost is 1 unit.
端点: GET /shorts/soundAttribution
参数:
-
params(string): Attribution param available in the Shorts info Endpoint: soundAttribution -> params -
id(string): If the params value is not available then Shorts Video Id may be provided. -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
search_channels_videosplaylists
Search channel's videos and playlists, also get channel details. Quota cost is 1 unit.
端点: GET /channel/search
参数:
-
id(string): Channel Id -
forUsername(string): If id not available then provide username. Quota cost +1. -
query(string) 必需: Search query -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
channel_featured_channels
Get featured channel listing and channel details. Quota cost is 1 unit.
端点: GET /channel/channels
参数:
-
id(string): Channel Id -
forUsername(string): If id not available then provide username. Quota cost +1. -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
channel_playlists
Get playlist listing and channel details. Quota cost is 1 unit.
端点: GET /channel/playlists
参数:
-
id(string) 必需: Example value: UCMhe8jmac-tWKU0Vj_OXDvA -
sort_by(string): Sorts the channel playlists. Available options: date_added [default] last_video_added -
token(string): Pagination token Alternatively, use X-TOKEN in header -
geo(string): ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
forUsername(string): Example value: -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-TOKEN(string): Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue.
resolve_url
Resolve URLs like handles, etc. Quota cost is 1 unit.
端点: GET /resolve
参数:
-
url(string) 必需: Example value: https://www.youtube.com/@TED -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
channel_community_posts
Get community post listing and channel details. Quota cost is 1 unit.
端点: GET /channel/community
参数:
-
id(string) 必需: Channel Id -
token(string): Pagination Token -
geo(string): ISO 3166-2 country code of the region. Like US (default), UK, CA, IN, etc. -
lang(string): Language code for localized results. Like en, gb, hi, etc -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1 -
X-CACHEBYPASS(string): Cache bypass, the value must be 1 Quota Cost +1
技术栈
- 传输协议: stdio
- HTTP 客户端: httpx
许可证
MIT License - 详见 LICENSE 文件。
开发
此服务器由 API-to-MCP 工具生成。
版本: 1.0.0