MCP-сервер YouTube
Один удалённый URL даёт Claude, ChatGPT, Cursor и любому другому MCP-совместимому клиенту настоящий доступ к YouTube - транскрипты, поиск, каналы и плейлисты - прямо в разговоре.
- ✓100 бесплатных кредитов для старта, банковская карта не нужна
- ✓Один API-ключ работает и для MCP-сервера, и для REST API
- ✓Неудачные вызовы и вызовы, отклонённые лимитом запросов, никогда не тарифицируются
- ✓Работает с Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline и Codex
Что такое MCP?
Model Context Protocol позволяет ИИ-ассистенту вызывать инструменты прямо посреди разговора, вместо того чтобы вы вручную копировали и вставляли данные. Этот сервер размещён у нас - достаточно указать клиенту один URL, и он сам обнаружит доступные инструменты. Ничего устанавливать или запускать локально не нужно.
Подключение примерно за минуту
Streamable HTTP. Каждый клиент ниже указывает на один и тот же URL:
https://getyoutubetranscript.com/api/mcpClaude (веб и десктоп)
Customize -> Connectors -> + Add -> Add custom connector, затем вставьте URL ниже. Claude попросит вас войти и подключиться - копировать ключ не нужно.
https://getyoutubetranscript.com/api/mcpChatGPT
Plugins -> + -> Add custom MCP server, введите URL ниже, выберите OAuth и войдите. Доступно в рабочих пространствах Business, Enterprise и Edu (администраторам), в веб-версии.
https://getyoutubetranscript.com/api/mcpClaude Code
Всего одна команда, с API-ключом из вашего дашборда:
claude mcp add --transport http getyoutubetranscript https://getyoutubetranscript.com/api/mcp \
--header "Authorization: Bearer sk_live_..."Cursor
Добавьте в ~/.cursor/mcp.json (все проекты) или .cursor/mcp.json (только этот проект):
{
"mcpServers": {
"getyoutubetranscript": {
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}VS Code (Copilot)
Добавьте в .vscode/mcp.json. VS Code один раз запросит ключ через поле ввода ниже и сохранит его безопасно, а не запишет в файл:
{
"inputs": [
{
"type": "promptString",
"id": "gyt-api-key",
"description": "GetYouTubeTranscript API key",
"password": true
}
],
"servers": {
"getyoutubetranscript": {
"type": "http",
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer ${input:gyt-api-key}"
}
}
}
}Codex CLI
Добавьте в ~/.codex/config.toml, затем экспортируйте переменную окружения, на которую идёт ссылка:
[mcp_servers.getyoutubetranscript]
url = "https://getyoutubetranscript.com/api/mcp"
bearer_token_env_var = "GYT_API_KEY"export GYT_API_KEY="sk_live_..."Windsurf и Cline
Вставьте это в настройки MCP в Cline (MCP Servers, затем Configure). Оставьте "type": "streamableHttp", иначе Cline использует старый транспорт SSE. Windsurf принимает тот же блок в собственном файле конфигурации MCP.
{
"mcpServers": {
"getyoutubetranscript": {
"type": "streamableHttp",
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}Доступные инструменты
| Инструмент | Что делает | Стоимость |
|---|---|---|
get_youtube_transcript | Полный транскрипт плюс название, автор, миниатюра | 1 кредит |
get_transcript_languages | Языки субтитров видео, ручные и автоматические | 1 кредит |
search_youtube | Поиск видео или каналов с постраничной навигацией | 1 кредит |
get_channel_latest_videos | Метаданные канала и последние загрузки | 1 кредит |
search_channel_videos | Поиск внутри одного канала | 1 кредит |
list_channel_videos | Все видео, загруженные каналом | 1 кредит |
list_channel_playlists | Плейлисты канала, постранично | 1 кредит |
list_channel_posts | Публикации сообщества канала, постранично | 1 кредит |
get_related_videos | Видео, которые YouTube рекомендует рядом с видео | 1 кредит |
get_channel_banner | Баннер и аватар канала | 1 кредит |
get_video_dislikes | Оценка лайков и дизлайков видео | 1 кредит |
list_playlist_videos | Все видео в плейлисте | 1 кредит |
get_credits | Остаток кредитов по ключу | Бесплатно |
Те же инструменты и та же стоимость в кредитах, что и в REST API - соответствующие эндпоинты смотрите в документации API.
Как это выглядит в разговоре
Проверю канал на предмет последней загрузки, а затем получу её транскрипт.
get_channel_latest_videos(channel: "@3blue1brown")
get_youtube_transcript(video_url: "...")
Цены
100 бесплатных кредитов для старта. Далее 5 $/мес за 1 000 кредитов (4,50 $/мес при годовой оплате). Один кредит - один успешный вызов инструмента; неудачные или ограниченные по скорости вызовы никогда не тарифицируются. Полная разбивка, включая лимиты скорости по тарифам, - в документации API.
Примечание
Частые вопросы об MCP-сервере
С какими MCP-клиентами это работает?
С любым клиентом, поддерживающим MCP по Streamable HTTP: Claude (веб, десктоп, Code), ChatGPT, Cursor, VS Code, Windsurf, Cline и Codex CLI описаны выше. Если клиент поддерживает удалённый HTTP MCP-сервер, здесь он тоже будет работать.
Нужно ли что-то устанавливать или запускать?
Нет. Сервер размещён на getyoutubetranscript.com - клиенту нужен только URL (а для клиентов без OAuth - ещё и API-ключ). Никакого локального процесса, yt-dlp или прокси, которым нужно управлять.
Чем это отличается от опенсорсного MCP-сервера, который я запускаю сам?
Сервер с самостоятельным хостингом работает на вашей машине или вашем собственном сервере и обычно требует, чтобы вы сами управляли доступом к YouTube (куки, прокси, лимиты скорости). Этот сервер размещён у нас: регистрация в режиме самообслуживания, запросы идут через нашу инфраструктуру, а оплата - в кредитах, а не в управлении инфраструктурой скрапинга.
Я получил ошибку 401 - что делать?
Для OAuth-клиентов (Claude, ChatGPT) переподключите коннектор на его странице настроек - вероятно, подключение истекло или было отозвано. Для клиентов с API-ключом (Cursor, VS Code, Claude Code, Codex) проверьте, что ключ вставлен верно, без лишних пробелов, и не был отозван в дашборде.
Мой ассистент ответил по памяти, не вызвав инструмент
Модели иногда считают, что уже знают содержание видео. Попросите явно: "сначала используй MCP-инструмент YouTube, чтобы получить транскрипт" - обычно этого достаточно, чтобы вызвать инструмент.
Что произойдёт, если у видео нет субтитров на нужном языке?
get_youtube_transcript возвращает ошибку TRANSCRIPT_NOT_FOUND вместо догадки на неверном языке. Попробуйте без параметра language (по умолчанию английский) или сначала проверьте на YouTube, действительно ли у видео есть субтитры на этом языке.
Расходует ли это мою квоту YouTube Data API?
Нет. Сервис не проксирует captions.download через ваш собственный ключ, поэтому нет суточного лимита в 10 000 единиц, которым нужно управлять - только лимит скорости запросов по вашему тарифу.
Могу ли я использовать один и тот же API-ключ для MCP и REST API?
Да - один ключ, один баланс кредитов, общий для обоих. Подключение через OAuth (коннекторы Claude/ChatGPT) вместо ключа тоже расходует тот же баланс аккаунта; мы незаметно создаём отдельный ключ, который появляется в списке ключей вашего дашборда, так что вы можете просматривать или отзывать это подключение, как любой другой ключ.
