@pipeworx/mcp-youtube 0.1.2 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -21
- package/bin/cli.js +55 -11
- package/lib/index.js +333 -0
- package/package.json +17 -16
- package/server.json +1 -1
- package/tools.json +178 -0
- package/src/index.ts +0 -1131
- package/src/server.ts +0 -45
- package/tsconfig.json +0 -18
package/tools.json
ADDED
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"name": "yt_search",
|
|
4
|
+
"description": "Search YouTube for videos, channels, or playlists. Returns snippet info including title, description, channel, thumbnails, and publish date.",
|
|
5
|
+
"inputSchema": {
|
|
6
|
+
"type": "object",
|
|
7
|
+
"properties": {
|
|
8
|
+
"_apiKey": {
|
|
9
|
+
"type": "string",
|
|
10
|
+
"description": "YouTube Data API v3 key from Google Cloud Console"
|
|
11
|
+
},
|
|
12
|
+
"query": {
|
|
13
|
+
"type": "string",
|
|
14
|
+
"description": "Search term"
|
|
15
|
+
},
|
|
16
|
+
"type": {
|
|
17
|
+
"type": "string",
|
|
18
|
+
"description": "Resource type to search: \"video\", \"channel\", or \"playlist\" (default: \"video\")"
|
|
19
|
+
},
|
|
20
|
+
"max_results": {
|
|
21
|
+
"type": "number",
|
|
22
|
+
"description": "Number of results to return (default 10, max 50)"
|
|
23
|
+
},
|
|
24
|
+
"channel_id": {
|
|
25
|
+
"type": "string",
|
|
26
|
+
"description": "Filter results to a specific channel ID"
|
|
27
|
+
},
|
|
28
|
+
"order": {
|
|
29
|
+
"type": "string",
|
|
30
|
+
"description": "Sort order: \"date\", \"rating\", \"relevance\", or \"viewCount\" (default: \"relevance\")"
|
|
31
|
+
},
|
|
32
|
+
"published_after": {
|
|
33
|
+
"type": "string",
|
|
34
|
+
"description": "Filter results published after this ISO 8601 date (e.g. \"2024-01-01T00:00:00Z\")"
|
|
35
|
+
}
|
|
36
|
+
},
|
|
37
|
+
"required": [
|
|
38
|
+
"_apiKey",
|
|
39
|
+
"query"
|
|
40
|
+
]
|
|
41
|
+
}
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
"name": "yt_video_details",
|
|
45
|
+
"description": "Get detailed information about one or more YouTube videos including title, description, channel, duration, view/like/comment counts, and tags.",
|
|
46
|
+
"inputSchema": {
|
|
47
|
+
"type": "object",
|
|
48
|
+
"properties": {
|
|
49
|
+
"_apiKey": {
|
|
50
|
+
"type": "string",
|
|
51
|
+
"description": "YouTube Data API v3 key from Google Cloud Console"
|
|
52
|
+
},
|
|
53
|
+
"video_id": {
|
|
54
|
+
"type": "string",
|
|
55
|
+
"description": "Video ID or comma-separated list of video IDs (max 50)"
|
|
56
|
+
}
|
|
57
|
+
},
|
|
58
|
+
"required": [
|
|
59
|
+
"_apiKey",
|
|
60
|
+
"video_id"
|
|
61
|
+
]
|
|
62
|
+
}
|
|
63
|
+
},
|
|
64
|
+
{
|
|
65
|
+
"name": "yt_channel_details",
|
|
66
|
+
"description": "Get YouTube channel information and statistics including subscriber count, video count, view count, description, and custom URL.",
|
|
67
|
+
"inputSchema": {
|
|
68
|
+
"type": "object",
|
|
69
|
+
"properties": {
|
|
70
|
+
"_apiKey": {
|
|
71
|
+
"type": "string",
|
|
72
|
+
"description": "YouTube Data API v3 key from Google Cloud Console"
|
|
73
|
+
},
|
|
74
|
+
"channel_id": {
|
|
75
|
+
"type": "string",
|
|
76
|
+
"description": "Channel ID (starts with UC...)"
|
|
77
|
+
},
|
|
78
|
+
"username": {
|
|
79
|
+
"type": "string",
|
|
80
|
+
"description": "Channel username (alternative to channel_id)"
|
|
81
|
+
}
|
|
82
|
+
},
|
|
83
|
+
"required": [
|
|
84
|
+
"_apiKey"
|
|
85
|
+
]
|
|
86
|
+
}
|
|
87
|
+
},
|
|
88
|
+
{
|
|
89
|
+
"name": "yt_channel_videos",
|
|
90
|
+
"description": "List recent videos from a YouTube channel, ordered by date. Returns video ID, title, description, and publish date.",
|
|
91
|
+
"inputSchema": {
|
|
92
|
+
"type": "object",
|
|
93
|
+
"properties": {
|
|
94
|
+
"_apiKey": {
|
|
95
|
+
"type": "string",
|
|
96
|
+
"description": "YouTube Data API v3 key from Google Cloud Console"
|
|
97
|
+
},
|
|
98
|
+
"channel_id": {
|
|
99
|
+
"type": "string",
|
|
100
|
+
"description": "Channel ID to list videos from"
|
|
101
|
+
},
|
|
102
|
+
"max_results": {
|
|
103
|
+
"type": "number",
|
|
104
|
+
"description": "Number of videos to return (default 10, max 50)"
|
|
105
|
+
},
|
|
106
|
+
"published_after": {
|
|
107
|
+
"type": "string",
|
|
108
|
+
"description": "Filter videos published after this ISO 8601 date"
|
|
109
|
+
},
|
|
110
|
+
"published_before": {
|
|
111
|
+
"type": "string",
|
|
112
|
+
"description": "Filter videos published before this ISO 8601 date"
|
|
113
|
+
}
|
|
114
|
+
},
|
|
115
|
+
"required": [
|
|
116
|
+
"_apiKey",
|
|
117
|
+
"channel_id"
|
|
118
|
+
]
|
|
119
|
+
}
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"name": "yt_video_comments",
|
|
123
|
+
"description": "Get top-level comment threads on a YouTube video. Returns author, text, like count, and publish date.",
|
|
124
|
+
"inputSchema": {
|
|
125
|
+
"type": "object",
|
|
126
|
+
"properties": {
|
|
127
|
+
"_apiKey": {
|
|
128
|
+
"type": "string",
|
|
129
|
+
"description": "YouTube Data API v3 key from Google Cloud Console"
|
|
130
|
+
},
|
|
131
|
+
"video_id": {
|
|
132
|
+
"type": "string",
|
|
133
|
+
"description": "Video ID to fetch comments for"
|
|
134
|
+
},
|
|
135
|
+
"max_results": {
|
|
136
|
+
"type": "number",
|
|
137
|
+
"description": "Number of comment threads to return (default 20, max 100)"
|
|
138
|
+
},
|
|
139
|
+
"order": {
|
|
140
|
+
"type": "string",
|
|
141
|
+
"description": "Sort order: \"time\" or \"relevance\" (default: \"relevance\")"
|
|
142
|
+
}
|
|
143
|
+
},
|
|
144
|
+
"required": [
|
|
145
|
+
"_apiKey",
|
|
146
|
+
"video_id"
|
|
147
|
+
]
|
|
148
|
+
}
|
|
149
|
+
},
|
|
150
|
+
{
|
|
151
|
+
"name": "yt_video_transcript",
|
|
152
|
+
"description": "Get the transcript (captions) of a YouTube video: timestamped segments plus the joined text, the caption language, and whether the track is auto-generated. No API key needed. Use it to summarize, quote or search what is said in a video. Long videos are paged: pass the returned next_start_seconds as start_seconds to continue. A video with no captions returns a captions_unavailable error, never an empty transcript.",
|
|
153
|
+
"inputSchema": {
|
|
154
|
+
"type": "object",
|
|
155
|
+
"properties": {
|
|
156
|
+
"video_id": {
|
|
157
|
+
"type": "string",
|
|
158
|
+
"description": "YouTube video ID (e.g. \"dQw4w9WgXcQ\") or a full youtube.com / youtu.be URL"
|
|
159
|
+
},
|
|
160
|
+
"lang": {
|
|
161
|
+
"type": "string",
|
|
162
|
+
"description": "Caption language code (e.g. \"en\", \"fr\", \"pt-BR\"). \"en\" also matches \"en-US\". Default: the video's default caption track. If the video has no track in this language the error lists the ones it has."
|
|
163
|
+
},
|
|
164
|
+
"start_seconds": {
|
|
165
|
+
"type": "number",
|
|
166
|
+
"description": "Skip segments that start before this many seconds (for paging through long videos). Default 0."
|
|
167
|
+
},
|
|
168
|
+
"max_chars": {
|
|
169
|
+
"type": "number",
|
|
170
|
+
"description": "Stop after this many characters of transcript text (default 50000, max 200000)."
|
|
171
|
+
}
|
|
172
|
+
},
|
|
173
|
+
"required": [
|
|
174
|
+
"video_id"
|
|
175
|
+
]
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
]
|