YouTube MCP Server

Размещённый сервер Model Context Protocol (MCP), который даёт Claude, Cursor, Windsurf и любому другому MCP-клиенту четыре инструмента YouTube только для чтения. Поиск по YouTube, чтение данных видео и каналов, получение транскриптов — без проекта Google Cloud и без ключа YouTube Data API.

https://mcp.hasdata.com/api/mcp?apis=youtube

Содержание

• Что вам нужно

• Быстрый старт

• Примеры запросов

• Инструменты

• Ошибки и пути отказа

• Цены, бесплатный тариф и лимиты

• Выбор инструмента

• Сравнение

• FAQ

• Ссылки HasData

• Разработка

• Участие

• Лицензия

Related MCP server: YouTube MCP Server

Что вам нужно

MCP-клиент, который поддерживает streamable HTTP с пользовательскими заголовками. Ключ API HasData из панели управления — создаётся бесплатно. Больше ничего. Это удалённый сервер. Не нужно устанавливать пакет, запускать контейнер или иметь учётную запись Google.

Быстрый старт

URL сервера одинаков для всех клиентов. Мы используем его напрямую в Claude Code и Claude Desktop. Остальные блоки следуют собственному документированному формату каждого клиента для удалённого сервера.

Клиенты с поддержкой OAuth могут добавить тот же URL как коннектор и войти, не помещая ключ в файл конфигурации.

claude mcp add --transport http youtube "https://mcp.hasdata.com/api/mcp?apis=youtube" \
  --header "x-api-key: HASDATA_API_KEY"

Настройки, затем Connectors, затем Add custom connector, затем вставьте https://mcp.hasdata.com/api/mcp?apis=youtube и войдите.

Для пути через файл конфигурации: Claude Desktop загружает только локальные (stdio) серверы, поэтому удалённый сервер доступен через мост mcp-remote, для которого нужен Node. Добавьте это в claude_desktop_config.json:

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.hasdata.com/api/mcp?apis=youtube",
        "--header",
        "x-api-key:HASDATA_API_KEY"
      ]
    }
  }
}

Значение x-api-key: не содержит пробела после двоеточия. Claude Desktop передаёт аргумент без оболочки, и пробел разделяет заголовок.

~/.cursor/mcp.json для всех проектов или .cursor/mcp.json для одного:

{
  "mcpServers": {
    "youtube": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=youtube",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json. Windsurf называет поле serverUrl, а не url:

{
  "mcpServers": {
    "youtube": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=youtube",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "youtube": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=youtube",
      "type": "streamableHttp",
      "headers": { "x-api-key": "HASDATA_API_KEY" },
      "disabled": false
    }
  }
}

.vscode/mcp.json в рабочей области:

{
  "servers": {
    "youtube": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=youtube",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codex/config.toml:

[mcp_servers.youtube]
url = "https://mcp.hasdata.com/api/mcp?apis=youtube"

[mcp_servers.youtube.headers]
"x-api-key" = "HASDATA_API_KEY"

~/.gemini/settings.json:

{
  "mcpServers": {
    "youtube": {
      "httpUrl": "https://mcp.hasdata.com/api/mcp?apis=youtube",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Примеры запросов

Запросы, а не код. Вставьте один — и агент сам выберет инструмент. Каждый помечен количеством вызовов, потому что в MCP модель решает, сколько вызовов делать, и каждый успешный вызов стоит 10 кредитов.

Найдите десять самых просматриваемых видео о Model Context Protocol за последний месяц, затем получите транскрипт самого популярного и приведите три утверждения, которые в нём делаются о вызове инструментов.

Два вызова, 20 кредитов.

Возьмите канал @GoogleDevelopers. Перечислите вкладки, которые он публикует, затем обобщите последние пять загрузок и скажите, какие темы повторяются.

Два вызова, 20 кредитов. Чтение вкладки, которую вы ещё не видели, требует второго вызова, потому что список вкладок приходит в первом ответе.

Возьмите этот id видео: dQw4w9WgXcQ. Получите его статистику, затем проверьте, какие из связанных видео с того же канала.

Один вызов, 10 кредитов. Связанные видео приходят в том же ответе.

Найдите на YouTube «web scraping tutorial», отсортированные по дате загрузки, только видео короче четырёх минут, и дайте названия глав каждого результата, где они есть.

Один вызов, 10 кредитов.

Получите немецкий транскрипт этого видео, если он существует, и скажите, на каких языках оно доступно.

Один вызов, 10 кредитов.

Поиск принимает собственные токены фильтров YouTube, и агент сужает выбор по длительности, дате загрузки и типу контента без постобработки. Транскрипты приходят вместе со списком доступных языковых дорожек, что позволяет агенту выбрать нужный без угадывания.

Пагинация стоит один вызов за каждый шаг. Исследовательский запрос, который ищет, листает дважды, а затем получает три транскрипта, — это шесть вызовов и 60 кредитов. Пробный период проходит дальше на узких вопросах, чем на открытых обходах.

Инструменты

Четыре инструмента, все только для чтения. Примеры ниже урезаны из реальных вызовов, и числа в них меняются по мере обновления YouTube. Читайте их как формы. Каждое имя инструмента ведёт на справочник конечной точки, где приведён полный список полей.

Примеры — это полезная нагрузка, а не весь ответ. Результат tools/call содержит один текстовый блок, и этот текст сам является JSON, содержащим url, status, text и json, с данными скрейпинга под json. Из сырого JSON-RPC ответа путь — result.content[0].text, затем разбор, затем .json. Чат-клиент разворачивает это за вас, а код, обращающийся к конечной точке напрямую, — нет.

Получить результаты поиска YouTube

hasdata_youtube_search_getYoutubeSearchResults

Ищет на YouTube и возвращает всю страницу результатов, разделённую по типу результата.

Страница результатов разбита на videoResults, shortsResults, inlineShortsResults, playlistResults, channelResults и shelves, с платными размещениями в adsResults и sponsoredResults. Какие блоки появятся, зависит от запроса, и блок, которому нечего сообщить, отсутствует, а не пуст. Проверяйте наличие ключа перед итерацией. searchInformation содержит общее количество, а pagination.nextPageToken — это то, что вы передаёте обратно как paginationToken. Реклама никогда не смешивается с органическими массивами, хотя их две, и их нужно пропустить.

{
  "positionOnPage": 1,
  "videoId": "GuTcle5edjk",
  "title": "you need to learn MCP RIGHT NOW!! (Model Context Protocol)",
  "viewsOriginal": "1.6M views",
  "views": 1653824,
  "length": "38:40",
  "publishedDate": "11 months ago",
  "extensions": ["4K"],
  "chapters": [
    { "title": "Intro", "time": "0:00" },
    { "title": "Problem: LLMs Suck at Accessing Code", "time": "0:40" }
  ],
  "channel": { "name": "NetworkChuck", "verified": true }
}

Здесь стоит упомянуть две вещи. views — это разобранное целое число рядом со строкой отображения 1.6M views и не требует парсера суффиксов. А chapters возвращаются внутри результатов поиска, а не только на самом видео, хотя только некоторые видео их содержат.

В справочнике конечной точки поиска перечислены все токены sp и filters__, которые принимает конечная точка.

Получить данные видео YouTube

hasdata_youtube_video_getYoutubeVideo

Одно видео по id.

Возвращает title, thumbnail, channel, publishedDate, lengthSeconds, category, isFamilySafe и isUnlisted, а также массивы relatedVideos, endScreenVideos, keywords, captions, music и socialLinks. description — это объект, содержащий полный текст в content и массив links, где каждая ссылка и хэштег содержат startIndex, length, text и url. Поле text содержит ссылку в том виде, как её написал автор, а url — обёртку перенаправления YouTube, что важно, если вы извлекаете спонсорские или партнёрские ссылки из описаний.

Читайте разобранное поле по имени для каждого инструмента, прежде чем копировать пример ниже. Результаты поиска и каналов помещают разобранное число в views, а строку отображения в viewsOriginal. Этот ответ инвертирует это, оставляя строку в views, а число в extractedViews, и та же инверсия применяется к likes и subscribers. Если ошибиться, item.views > 100000 будет сравнивать строку здесь, никогда не вызывая исключения.

{
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "views": "1,806,075,152 views",
  "extractedViews": 1806075152,
  "likes": "19M",
  "extractedLikes": 19344370,
  "publishedDate": "Oct 24, 2009",
  "lengthSeconds": 214,
  "category": "Music",
  "channel": { "name": "Rick Astley", "subscribers": "4.53M subscribers", "extractedSubscribers": 4530000 }
}

Получить данные канала YouTube

hasdata_youtube_channel_getYoutubeChannel

Канал по id или хэндлу, по одной вкладке за раз.

На вкладке по умолчанию возвращаются channelInfo, featuredVideo и sections. Остальные вкладки возвращают собственную структуру. channelInfo содержит handle, аватар, баннер, описание, ключевые слова канала и его rssUrl — этого достаточно, чтобы продолжать следить за каналом без опроса.

Массив availableTabs в примере ниже содержит отображаемые подписи, и это не те значения, которые принимает tab. Home, Live, Courses и Search не соответствуют ни одному значению параметра, а остальные нужно привести к нижнему регистру. Агент, который читает список и обходит каждый элемент, споткнётся уже на первом.

{
  "channelInfo": {
    "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
    "name": "Google for Developers",
    "handle": "@GoogleDevelopers",
    "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UC_x5XG1OV2P6uZZ5FSM9Ttw",
    "isFamilySafe": true,
    "availableTabs": ["Home", "Videos", "Shorts", "Live", "Courses", "Playlists", "Posts", "Search"]
  }
}

Получить транскрипт видео YouTube

hasdata_youtube_transcript_getYoutubeTranscript

Синхронизированный по времени транскрипт видео.

Проверяйте selected в ответе, прежде чем доверять языку. Запрос languageCode, которого нет в видео, не приводит ни к ошибке, ни к пустому ответу — он тихо переключается на дорожку по умолчанию. Каждая запись в списке содержит languageName и languageCode, и один язык может встречаться дважды: один раз созданный человеком и один раз с type равным asr.

{
  "transcript": [
    { "startMs": 320, "endMs": 18800, "snippet": "[Music]", "startTimeText": "0:00" },
    { "startMs": 18800, "endMs": 21800, "snippet": "We're no strangers to", "startTimeText": "0:18" }
  ],
  "availableTranscripts": [
    { "languageName": "English", "languageCode": "en" },
    { "languageName": "English", "languageCode": "en", "type": "asr", "selected": true },
    { "languageName": "German (Germany)", "languageCode": "de-DE" },
    { "languageName": "Japanese", "languageCode": "ja" }
  ]
}

Ошибки и пути отказа

Ваш клиент почти никогда не видит HTTP-код ошибки от вызова инструмента. Слой MCP отвечает 200 и помещает сбой внутрь результата, с isError равным true и причиной в виде текста. Агент читает сообщение там, где вы могли бы ожидать строку статуса.

Неверный ключ проявляется как вывод инструмента, а не как неудачное подключение. tools/list принимает любой непустой ключ и возвращает все четыре инструмента, поэтому клиент завершает рукопожатие и показывает зелёный индикатор. Первый вызов инструмента затем возвращается с isError: true и текстом HasData API error: 401 Unauthorized. Следите за этой строкой, потому что ничто ранее в потоке не сообщает о проблеме.

Отсутствующий ключ — единственная настоящая HTTP-ошибка. Авторизация выполняется перед любым инструментом, и само подключение завершается с ошибкой 401. Заголовки CORS присутствуют, и браузерный клиент читает статус, а не непрозрачный сетевой сбой.

Аргумент, нарушающий схему инструмента, отклоняется до того, как станет скрейпингом. Сервер отвечает с isError: true и текстом MCP error -32602: Input validation error, указывая offending-поле. Ничего не загружается и ничего не списывается. Сообщение называет поле, но не допустимые значения, поэтому таблицы параметров выше — справочник.

Вызов, который успешен и ничего не находит, — это случай, на котором спотыкаются. Он приходит как обычный результат с requestMetadata.status равным ok, а ключ данных просто отсутствует. Ничто в теле не говорит о том, что результат пуст. Проверяйте нужное поле, а не наличие ошибки.

Идентификатор, отклонённый платформой, возвращает 400 с requestMetadata.status равным error. Несуществующий handle канала — обычный способ это увидеть.

Результаты с данными также содержат requestMetadata.id, который стоит указывать в обращении в поддержку.

Цены, бесплатный тариф и лимиты

Каждый инструмент YouTube стоит 10 кредитов за успешный вызов. Размер ответа не меняет цену. Полная страница результатов поиска стоит столько же, сколько страница с одним видео.

Бесплатная пробная версия — 1 000 кредитов на 30 дней без карты, то есть 100 вызовов YouTube. После этого активный аккаунт продолжает получать 100 кредитов ежедневно, когда его баланс опускается ниже 100, так что агент с низким объёмом работает на бесплатном тарифе бессрочно.

Платные тарифы начинаются с 49 долларов в месяц за 200 000 кредитов, то есть 20 000 вызовов. Цена за единицу снижается с объёмом: от 2,45 доллара за 1 000 вызовов на начальном тарифе до 0,99 доллара на Business, 0,83 доллара на Growth и 0,75 доллара на самых крупных тарифах с высоким объёмом.

Ваш тариф также задаёт параллельность. Бесплатная пробная версия допускает 1 запрос одновременно, Startup — 15, Business — 30, Growth — 50, а тарифы с высоким объёмом — от 200 до 1 500. Обрабатывайте переполнение защитно во всём, что работает без присмотра, потому что агент, который разворачивает веер запросов, упрётся в потолок раньше вас.

Запрос, вернувшийся с кодом, отличным от 200, не тарифицируется. Успешный вызов, который ничего не нашёл, — это всё равно вызов.

Выбор инструментов

Параметр запроса apis определяет, какие инструменты видит ваш агент. Меньше инструментов — меньше контекста, потраченного на определения инструментов, и меньше шансов, что модель потянется не к тому.

?apis=youtube                    the four tools in this repo
?apis=youtube,google_serp        add Google search
?apis=youtube,tiktok,instagram   a social research bundle

Параметр принимает имена провайдеров, такие как youtube, и отдельные имена API, такие как google_maps_search. Опечатанные имена игнорируются. Если все имена неверны, запрос завершается ошибкой 400, и в теле перечислены и то, что не распознано, и все допустимые значения. Уберите параметр — и та же конечная точка откроет все 57 инструментов HasData.

Сравнение

Против официального YouTube Data API v3:

Последние две строки важны. Если дневной квоты хватает на ваш объём и вы владеете каналом, к которому обращаетесь, официальный API — более дешёвый ответ, и стоит выбрать его.

Большинство других MCP-серверов YouTube работают только с транскриптами. Этот также ищет, читает видео с их показателями вовлечённости и обходит вкладки каналов, так что агент проводит целый исследовательский проход без второго сервера.

Чего этот сервер не делает. Никаких комментариев, управления каналом, загрузок, аналитики, приватных данных. Он читает то, что видит посетитель без входа в аккаунт.

FAQ

Существует ли официальный MCP-сервер YouTube?

Google его не публикует. У YouTube нет собственного MCP-сервера. Любой вариант создан кем-то другим — либо вокруг YouTube Data API v3, либо вокруг публичных страниц. Этот поддерживается HasData и читает публичные страницы, поэтому ему не нужны учётные данные Google.

Что такое MCP-сервер YouTube?

Сервер, который предоставляет данные YouTube как инструменты, которые может вызывать ИИ-клиент. Клиент отправляет вызов инструмента по Model Context Protocol, сервер загружает данные и возвращает структурированный JSON, а модель работает с результатом и никогда не видит страницу HTML. Этот сервер предоставляет четыре инструмента и работает удалённо. Клиент подключается к URL и не запускает локальный процесс.

Нужен ли мне ключ YouTube API или проект Google Cloud?

Нет. Единственное учётное данное — ваш ключ HasData. Не нужно создавать проект Google Cloud, заполнять форму квоты или проходить экран согласия OAuth, потому что инструменты читают публичные страницы YouTube, а не YouTube Data API.

Нужно ли мне что-то хостить или запускать?

Нет. Это удалённый MCP-сервер на streamable HTTP. Нечего устанавливать, не нужно держать контейнер тёплым, не нужно перезапускать процесс.

Данные живые или кэшированные?

Живые. Каждый вызов загружает страницу в момент запроса и несёт собственный requestMetadata.id. Два одинаковых вызова — это две отдельные загрузки, а не воспроизведение сохранённой копии. Счётчики вроде просмотров и лайков отслеживают страницу, поэтому они движутся вместе с ней.

Что произойдёт, когда YouTube изменит свой макет?

С вашей стороны ничего. Мы отслеживаем изменения и сохраняем стабильной схему ответа, так что имена полей и типы остаются на месте. Поле без значения отсутствует в элементе, а не присутствует со значением null. Читайте необязательные поля со значением по умолчанию.

Можно ли использовать это вместе с другими API HasData?

Да. Параметр apis принимает список, и ?apis=youtube,google_serp даёт вашему агенту четыре инструмента YouTube плюс поиск Google. Уберите параметр — и получите всё.

Можно ли получить транскрипт для любого видео?

Только если у видео он есть, а availableTranscripts сообщает, что существует, прежде чем вы спросите.

Можно ли войти через OAuth вместо вставки ключа?

Да, в клиентах, которые это поддерживают. Claude Desktop и Cursor могут добавить конечную точку как коннектор и войти. Агенты и скрипты без присмотра используют заголовок x-api-key.

Соответствие требованиям и персональные данные

HasData обращается только к общедоступным данным. Условия платформы могут ограничивать автоматический доступ, и вы несёте ответственность за собственное соблюдение требований. Если собираемые вами данные включают личную информацию, убедитесь, что у вас есть законное основание для этого в соответствии с GDPR, CCPA или эквивалентными правилами вашей юрисдикции.

Ссылки HasData

Разработка

Этот репозиторий содержит конфигурацию и документацию для удалённого сервера. Здесь нет этапа сборки и нечего контейнеризировать.

Тесты в test/ проверяют контракт инструментов — ту часть, которая может сломаться без коммита здесь. Они проверяют, что ?apis=youtube возвращает ровно четыре инструмента, что каждый инструмент по-прежнему объявляет свой обязательный параметр, что ни одно имя не изменилось и что используемый ключ действительно принимается. Последняя проверка реально вызывает инструмент и стоит 10 кредитов — это цена канарейки, которая может упасть по правильной причине.

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

Тот же набор тестов запускается в CI при каждом пуше и раз в неделю по расписанию, потому что список инструментов вышестоящего сервиса может измениться без изменений в этом репозитории. Сбой означает, что список инструментов сдвинулся, ключ перестал работать или конечная точка была недоступна, и сообщение проверки указывает, что именно.

Вклад в проект

Исправления в таблицах инструментов и примерах ответов — самый полезный вклад, потому что именно эти части расходятся. Укажите выполненный вызов и полученный ответ. Запросы на включение из форков запускают набор тестов без ключа, а живые проверки пропускаются, а не становятся красными.

Лицензия

MIT. См. LICENSE.