YouTube Research MCP — MCP-сервер для Claude Code: цитаты из видео
Достаёт из ролика YouTube нужный фрагмент с таймкодом и ссылкой на момент. Пригодится, когда агенту нужна цитата, а не весь транскрипт.
claude mcp add youtube-research -e YOUTUBE_API_KEY=<YOUTUBE_API_KEY> -- npx -y @coyasong/youtube-mcp-serverЧто делает YouTube Research MCP
Сервер принимает ссылку на видео — обычную, короткую, Shorts, embed, live или просто ID — и отдаёт расшифровку с таймкодами и каноническими ссылками, которые открывают ролик ровно на цитируемой секунде. Внутри есть поиск по транскрипту: агент забирает найденный фрагмент с соседним контекстом и не тянет в контекст всю дорожку. Таймкоды и ссылки собираются из сегментов субтитров, модель их не придумывает.
Транскрипты работают без ключа: нужен только Node.js версии 22 или новее. Ключ YOUTUBE_API_KEY от YouTube Data API v3 включает режим full — поиск, комментарии, статистику видео и каналов, тренды и сравнения. Без ключа на инструментах Data API сервер вернёт ошибку о том, что ключ обязателен, поэтому если аналитика нужна с первого запроса, ключ задавайте сразу.
Установка локально идёт по stdio через npx. Есть Streamable HTTP на /mcp и публичный /health. Полный режим не выставляйте в интернет без аутентификации: посторонние израсходуют вашу квоту YouTube API. Для удалённого развёртывания нужен bearer-токен, а браузерные источники по умолчанию отклоняются — их перечисляют в CORS_ORIGIN точными адресами, без звёздочек.
Какие задачи решает
- вытащить из видео цитату с таймкодом и ссылкой
- найти в длинном транскрипте место, где говорят о нужной теме
- собрать статистику роликов, комментарии и данные канала через API
- сравнить несколько видео по метрикам и трендам
- подключить исследование YouTube к агенту без раздувания контекста
Примеры запросов агенту
- Найди в этом видео всё про оценку моделей и процитируй точные моменты:
https://www.youtube.com/watch?v=VIDEO_ID - Собери комментарии и статистику под этим роликом и покажи, о чём спорят чаще всего
- Сравни два канала по последним видео и выпиши различия в цифрах
Как установить YouTube Research MCP
Командой платформы
claude mcp add youtube-research -e YOUTUBE_API_KEY=<YOUTUBE_API_KEY> -- npx -y @coyasong/youtube-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add youtube-research-mcp --env YOUTUBE_API_KEY=<YOUTUBE_API_KEY> -- npx -y @coyasong/youtube-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"youtube-research-mcp": {
"command": "npx",
"args": [
"-y",
"@coyasong/youtube-mcp-server"
],
"env": {
"YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"youtube-research-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@coyasong/youtube-mcp-server"
],
"env": {
"YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e YOUTUBE_API_KEY=<YOUTUBE_API_KEY> youtube-research-mcp npx -y @coyasong/youtube-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о YouTube Research MCP
Как установить YouTube Research MCP в Claude Code?
Выполните claude mcp add youtube-research -e YOUTUBE_API_KEY=<YOUTUBE_API_KEY> -- npx -y @coyasong/youtube-mcp-server. Ключ можно не задавать, если нужны только транскрипты.
Что делает YouTube Research MCP?
Превращает ссылку на ролик в фрагменты расшифровки с таймкодами и ссылками на точный момент. С ключом API добавляет поиск, комментарии и статистику.
Нужен ли ключ YouTube API?
Для транскриптов нет. Ключ YOUTUBE_API_KEY включает режим full с поиском и аналитикой; без него эти инструменты вернут ошибку.
