# Как научить агента собирать комментарии с YouTube каждый день

> Пошагово: ключ YouTube Data API за 15 минут, промпт для Claude Code или Codex, расчёт квоты и правила, о которых агент обычно не предупреждает

Автор: Роман Шарафутдинов. Рубрика: Рабочие схемы. Опубликовано: 2026-10-28. Основание: проверил сам.
Адрес: https://sharafutdinov.ai/m/youtube-api-kommentarii-dlya-agenta/

## Что внутри

Как подключить официальный YouTube Data API к своему ИИ-агенту: создать проект в Google Cloud, включить API, получить и ограничить ключ, безопасно отдать его агенту, собрать первые комментарии, посчитать квоту и поставить сбор на расписание. Плюс ограничения: ответы на комментарии, субтитры, правило 30 дней.

## Коротко

- Для чтения публичных комментариев хватает API-ключа: без OAuth, без программиста, минут за пятнадцать.
- Бесплатная квота — 10 000 единиц в сутки. Страница из 100 комментариев стоит одну единицу.
- Поиск ограничен сотней запросов в сутки, поэтому знакомые каналы берите списком: их свежие ролики достаются за одну единицу квоты.
- Сырые данные из API по правилам YouTube нельзя хранить дольше 30 дней. Храните выводы, а выгрузку обновляйте.

Эта статья выросла из [разбора одного запроса](https://sharafutdinov.ai/m/razbor-zaprosa-kommentarii/): контентщик бренда косметики собрал 20 000 комментариев и захотел собирать их каждый день. Claude ему сказал: подключи YouTube Data API, и будет до миллиона комментариев в сутки бесплатно.

Это правда. Мы прошли этот путь на живом аккаунте 28 октября 2026 года: создали проект, ключ и сделали пробные запросы. По дороге есть пять мест, где люди спотыкаются: ключ, который отдают агенту небезопасно, поиск, которого всего 100 запросов в сутки, ответы на комментарии, которые приходят не все, субтитры, которых API не отдаёт, и правило про хранение данных, о котором агент обычно молчит. Ниже — весь путь по шагам.

Что получится в конце: [агент раз в сутки сам забирает свежие ролики](https://sharafutdinov.ai/m/rabota-za-70000-agentam/) по вашему списку каналов и ключевых слов, достаёт к ним комментарии и складывает в таблицу без дублей. Вам остаётся читать сводки.

Что понадобится: Google-аккаунт, минут пятнадцать и [Claude Code или Codex](https://sharafutdinov.ai/m/claude-code-chto-eto-i-kak-polzovatsya/). Программировать не нужно, код напишет агент.

## Шаг 1. Проект в Google Cloud

Откройте [console.cloud.google.com](https://console.cloud.google.com/) и войдите своим Google-аккаунтом. Проще всего создать проект по [прямой ссылке](https://console.cloud.google.com/projectcreate). Или нажмите выбор проекта наверху рядом с логотипом и затем New project («Новый проект»). Дайте понятное имя, например youtube-comments, и нажмите Create.

Новый проект. Номер в Project ID Google допишет сам. Источник: console.cloud.google.com, снимок 28.10.2026.

Проект — это папка, к которой привязаны ключ и квота. Если будете собирать для разных брендов, заведите на каждый свой проект: так квоты не смешиваются.

Платёжная карта не нужна. Мы проходили этот путь на обычном аккаунте 28 октября, и ни на одном шаге Google её не спросил.

## Шаг 2. Включить YouTube Data API v3

Откройте карточку API по [прямой ссылке](https://console.cloud.google.com/apis/library/youtube.googleapis.com) или через меню: APIs & Services → Library, в поиске — YouTube Data API v3. Проверьте, что наверху выбран ваш новый проект, и нажмите Enable.

Наверху — выбранный проект, под описанием — кнопка Enable. Источник: console.cloud.google.com, снимок 28.10.2026.

Через несколько секунд откроется страница API со статусом Enabled. Здесь же потом будут вкладки Metrics (сколько запросов ушло) и Quotas & System Limits (сколько осталось).

API включён. Справа — кнопка Create credentials, она понадобится на следующем шаге. Источник: console.cloud.google.com, снимок 28.10.2026.

## Шаг 3. Создать ключ и сразу его ограничить

APIs & Services → Credentials → Create credentials → API key.

Для чтения публичных данных нужен первый пункт — API key. Источник: console.cloud.google.com, снимок 28.10.2026.

Откроется окно создания ключа. Сейчас окно устроено так: ограничение по API выбирается прямо при создании, и без него ключ не создать. Заполните два поля:

— Name — понятное имя, например youtube-comments-agent;
— Select API restrictions — откройте список и отметьте только YouTube Data API v3. В списке лишь те API, которые включены в проекте, поэтому шаг 2 нужен раньше.

Ключ работает только с YouTube Data API v3. Если он утечёт, им не воспользуются для других сервисов Google в вашем проекте. Источник: console.cloud.google.com, снимок 28.10.2026.

Application restrictions оставьте пока None. Ограничение по IP-адресу имеет смысл добавить, когда сбор переедет на сервер с постоянным адресом.

Нажмите Create. Появится окно API key created, в нём ключ — строка из 39 символов, начинается с AIza. Скопируйте его значком рядом и сразу переходите к шагу 4.

Для чтения публичных данных — комментариев, просмотров, списка роликов канала — ключа достаточно. Вход через аккаунт (OAuth) нужен, только если агент будет что-то менять на канале или читать закрытую статистику своего канала.

## Шаг 4. Отдать ключ агенту безопасно

Не вставляйте ключ в чат с агентом и в общие документы. Всё, что попало в чат, остаётся в журнале сессии. В папке проекта создайте файл `.env` и положите туда одну строку:

```
YOUTUBE_API_KEY=ваш_ключ
```

Агенту достаточно сказать, что ключ лежит в `.env` в переменной `YOUTUBE_API_KEY`. И попросить добавить `.env` в `.gitignore`, чтобы ключ не уехал в репозиторий. Если у вас есть менеджер паролей или системная связка ключей, ещё лучше хранить ключ там, а агенту отдавать только имя.

## Шаг 5. Первый запрос

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

```
https://www.googleapis.com/youtube/v3/commentThreads?part=snippet,replies&videoId=ID_РОЛИКА&maxResults=100&order=relevance&textFormat=plainText&key=ВАШ_КЛЮЧ
```

ID ролика — это кусок ссылки после `watch?v=` (у Shorts — после `/shorts/`). В ответ придёт до 100 веток с текстом, автором, датой, лайками и числом ответов. С Shorts работает так же: в пробном запуске мы взяли 57-секундный ролик по запросу «выпадение волос», и комментарии пришли тем же запросом. Руками это делать не нужно, но полезно один раз понимать, что агент делает под капотом. Аккуратный агент вообще передаёт ключ не в адресе, а в заголовке запроса — так он не оседает в логах.

Дальше дайте агенту промпт из блока «Взять с собой» в конце статьи. Он попросит его сначала показать план и расход квоты, потом сделать пробный запуск на трёх роликах. Не пропускайте пробный запуск: на нём видно, собирается ли вообще то, что нужно.

## Квота: откуда миллион и как его не сжечь

Калькулятор квот: 10 000 единиц в сутки на всё, и отдельно — по 100 вызовов поиска и загрузки видео. Источник: developers.google.com, снимок 28.10.2026.

Бесплатно каждый проект получает 10 000 единиц в сутки. Почти любой запрос на чтение стоит одну единицу: страница комментариев (до 100 штук), список роликов канала (до 50), статистика по пачке роликов. Отсюда и миллион: 10 000 страниц по 100 комментариев.

Поиск устроен отдельно: 100 запросов в сутки. Оба лимита видно у себя в консоли, на вкладке Quotas & System Limits: Queries per day — 10 000, Search Queries per day — 100. Один поиск возвращает до 50 роликов. Квота обновляется в полночь по тихоокеанскому времени — это 10 утра по Москве, а после перехода США на зимнее время (со 2 ноября) — 11 утра.

Главный приём — не искать там, где можно взять список. Если вы знаете каналы конкурентов и блогеров ниши, их свежие ролики достаются почти даром: у каждого канала есть плейлист «все загрузки», и чтение его страницы стоит одну единицу. Поиск по ключевым словам оставьте на то, чего вы не знаете: новые каналы, случайные залётные ролики.

Прикинем типичный день. 30 каналов в списке — 30 единиц на проверку свежих роликов. Статистика по ним — ещё несколько единиц. Комментарии к 50 роликам по 5 страниц — 250 единиц. 20 поисков по ключевым словам — отдельный лимит. Итого меньше 300 единиц из 10 000. Квоты хватит с огромным запасом. Упрётесь вы скорее в то, сколько комментариев успеете осмыслить, а не в лимит Google.

Если квоты всё же не хватит, её можно увеличить, но через аудит: Google проверит, что проект соблюдает правила. Форма — в разделе [про аудит и квоты](https://developers.google.com/youtube/v3/guides/quota_and_compliance_audits).

## Что API не отдаёт

**Ответы на комментарии — не все.** К ветке приходит только часть ответов. В нашем пробном запуске у самой обсуждаемой ветки было 21 ответ, а вместе с веткой пришло пять. Остальные 16 вернул отдельный запрос по ID ветки (`parentId`). Если ответов много (а в спорах их много, и там самое интересное), агент должен отдельно запросить их по ID ветки. Это есть в промпте.

**Субтитры чужих роликов.** Официально скачать субтитры через API может только тот, у кого есть право редактировать ролик. Для чужих видео текст придётся получать иначе. Самый простой путь сейчас — Gemini: он принимает ссылку на публичный ролик YouTube и может пересказать, что в нём говорят и показывают. Есть и сервисы аналитики со своими подключениями к агентам, например vidIQ.

**Комментарии, где они отключены.** Агент получит ошибку `commentsDisabled`. Это нормально: пропустить и идти дальше.

## Правило 30 дней

У YouTube есть правила для разработчиков, и в разделе о хранении данных сказано: данные, полученные без авторизации владельца (то есть по ключу), можно хранить «временно, в ограниченном объёме» и не дольше 30 календарных дней. Потом — удалить или обновить. Статистику просмотров и подписчиков чужих каналов — тоже не дольше 30 дней.

Там же есть запрет строить из этих данных новые метрики; для аналитики на потоке с 1 июня 2026 года есть отдельный допуск через аудит (раздел III.L). Подробнее — в [разборе запроса](https://sharafutdinov.ai/m/razbor-zaprosa-kommentarii/). На практике я делаю так:

— сырые комментарии живут в базе скользящим окном: старше 30 дней — обновить или удалить (агент делает это сам, это есть в промпте);
— надолго остаются ваши выводы: какие темы растут, какие ролики их подтвердили, гипотезы и пометки команды;
— не передавайте выгрузку дальше: правила не дают вам прав на эти данные.

Как превращать собранное в темы, а не в свалку, — тоже в разборе.

## Как поставить на расписание

Когда пробный запуск прошёл, сбор надо запускать без вас. Варианта три.

**Запланированные задачи Claude Code.** Облачные работают без вашего компьютера, но не чаще раза в час и видят только репозиторий, а не локальные файлы. Локальные видят файлы, но работают, пока компьютер включён. Минус: каждый запуск тратит токены.

**Расписание на сервере.** Агент пишет скрипт один раз и ставит его на ежедневный запуск на недорогом сервере. Дальше сбор идёт без нейросети и без токенов. Для ежедневной рутины — мой выбор.

**GitHub Actions.** Бесплатное расписание при репозитории на GitHub. Учтите: в публичном репозитории расписание отключается после 60 дней без изменений, а в начале часа запуск может задерживаться.

В облаке и в GitHub Actions нет вашего `.env` и локальной базы: ключ кладётся в секреты сервиса, база — во внешнее хранилище. Публичный репозиторий для базы комментариев не годится.

В любом варианте попросите агента присылать отчёт после запуска: сколько собрано, сколько квоты ушло, какие ошибки. Если сбор молча упал неделю назад, лучше узнать об этом из сообщения, а не из пустой базы.

## А готовые подключения есть?

На 28 октября 2026 года официального MCP-сервера для YouTube Data API у Google я не нашёл. На GitHub лежит несколько сторонних MCP-серверов, которые умеют доставать комментарии по ключу. Пользоваться можно, но код чужого сервера стоит посмотреть до установки — через него проходит ваш ключ. У vidIQ есть официальный MCP: подключается к Claude и другим ассистентам, умеет анализировать каналы, ролики и комментарии, расходует кредиты сервиса.

Для ежедневного сбора в свою базу я бы не брал готовый сервер, а попросил агента написать маленький скрипт по промпту ниже. Он ваш, понятен целиком и ничего лишнего не делает.

## Взять с собой: Промпт: ежедневный сбор комментариев с YouTube

Когда пользоваться: Когда ключ уже получен и лежит в файле .env — отдать агенту в Claude Code или Codex

Задача: собрать систему ежедневного сбора комментариев с YouTube через официальный YouTube Data API v3.

Ключ лежит в файле .env в переменной YOUTUBE_API_KEY. Не выводи его в чат и в логи, добавь .env в .gitignore.

Что собирать:
- каналы из файла channels.txt (по одному @handle в строке): свежие ролики за последние [7] дней через uploads-плейлист канала (channels.list → playlistItems.list), без search.list;
- ролики по ключевым словам из файла keywords.txt через search.list — не больше [20] запросов в сутки;
- для каждого ролика: название, дата, просмотры, лайки, число комментариев (videos.list);
- комментарии (commentThreads.list, part=snippet,replies, order=relevance, textFormat=plainText, до [5] страниц на ролик) и все ответы к веткам, где ответов больше, чем пришло вместе с веткой (comments.list с parentId).

Где хранить: SQLite-файл comments.db. Один комментарий — одна строка: id, video_id, ссылка, автор, текст, лайки, число ответов, дата публикации, дата сбора. Без дублей: повторный сбор обновляет лайки и дописывает новое.

Правила:
- считай расход квоты и останавливайся на [8 000] единиц в сутки;
- удаляй или обновляй строки старше 30 дней (правила YouTube API Services, раздел III.E.4);
- если у ролика отключены комментарии — пропусти и запиши в лог;
- в конце каждого запуска — короткий отчёт: сколько роликов, сколько новых комментариев, сколько единиц квоты, какие ошибки.

Сначала покажи план и оценку расхода квоты на мои списки. Потом сделай пробный запуск на 3 роликах и покажи 10 строк из базы. Расписание ставь только после моего «ок».

## Источники

- YouTube Data API: начало работы и регистрация приложения — https://developers.google.com/youtube/v3/getting-started
- Калькулятор квот YouTube Data API (снимок 28.10.2026) — https://developers.google.com/youtube/v3/determine_quota_cost
- commentThreads.list — параметры и ограничения — https://developers.google.com/youtube/v3/docs/commentThreads/list
- comments.list — ответы на комментарии по parentId — https://developers.google.com/youtube/v3/docs/comments/list
- channels и playlistItems — uploads-плейлист канала — https://developers.google.com/youtube/v3/docs/playlistItems/list
- captions.download — только с правом редактирования ролика — https://developers.google.com/youtube/v3/docs/captions/download
- YouTube API Services Developer Policies, III.E.4 (редакция 15.10.2026) — https://developers.google.com/youtube/terms/developer-policies
- Аудит и увеличение квоты — https://developers.google.com/youtube/v3/guides/quota_and_compliance_audits
- vidIQ MCP — https://support.vidiq.com/en/articles/15082430-vidiq-mcp
