🧭 YouTube-Parser

YouTube-Parser — шаблон для сбора данных с YouTube и скачивания публичного контента. Он помогает находить видео, каналы и плейлисты по запросам, получать метаданные каналов и видео, собирать комментарии, посты, тренды, Shorts, субтитры, обложки и проверять API-ключи.

Шаблон работает через два метода: YouTube API и InnerTube API. Метод выбирается во входных настройках, но часть заданий поддерживает только один из них.

Важно: эта документация описывает клиентские настройки, рабочие файлы и ожидаемый результат. API-ключи, прокси, cookies, лицензионные файлы, служебные базы, логи и внутренняя логика шаблона не раскрываются и не нужны для обычной настройки.

⚙️ Конфигурация и задания

Работа YouTube-Parser начинается с вкладки Конфигурация YouTube-Parser. Здесь выбирается метод работы и одно задание, которое будет выполняться в текущем запуске.

Метод работы парсера

• YouTube API — официальный метод YouTube. Требует API-ключи и подходит для стабильного массового сбора данных.
• InnerTube API — метод, который используется для задач, недоступных через YouTube API, а также для скачивания, трендов, Shorts, постов и части дополнительных данных.

Задание

Одновременно выполняется только одно задание. После выбора задания настройте одноименную вкладку и заполните нужный файл входных данных.

Список заданий

• Парсинг поисковой выдачи — сбор видео, плейлистов или каналов по поисковым запросам.
• Парсинг поисковых подсказок — сбор подсказок YouTube по ключевым словам.
• Парсинг трендов — сбор трендовых видео по странам и категориям.
• Парсинг Shorts — сбор ленты Shorts с указанным лимитом.
• Парсинг метаданных канала — данные канала, статистика, описание и дополнительные поля.
• Парсинг подписок канала — список каналов, на которые подписан указанный канал.
• Парсинг ссылок на социальные сети — ссылки из публичных данных канала.
• Парсинг метаданных видео — данные видео по ссылкам или по каналам.
• Парсинг комментариев — комментарии к видео.
• Парсинг метаданных плейлистов — данные плейлистов по ссылкам или каналам.
• Парсинг видео в плейлистах — видео, входящие в плейлисты.
• Парсинг постов канала — посты сообщества канала.
• Парсинг комментариев в постах — комментарии к постам сообщества.
• Скачивание видео — скачивание видео или аудио по видео, плейлистам и каналам.
• Скачивание каналов — скачивание видео с каналов.
• Скачивание субтитров — скачивание субтитров по видео или каналам.
• Скачивание обложек — скачивание превью по ссылкам на обложки или видео.
• Чекер API-ключей — проверка работоспособности API-ключей.

Вкладки настроек

• Поисковая выдача — поиск через YouTube API и InnerTube API, а также поисковые подсказки. Подробнее: Поиск и фиды.
• Фиды — тренды и Shorts. Подробнее: Поиск и фиды.
• Каналы — метаданные каналов, подписки и социальные ссылки. Подробнее: Каналы.
• Видео — метаданные видео и комментарии к видео. Подробнее: Видео и комментарии.
• Плейлисты — плейлисты и видео в плейлистах. Подробнее: Плейлисты и посты.
• Посты — посты сообщества и комментарии к постам. Подробнее: Плейлисты и посты.
• Скачивание — видео, каналы, субтитры и обложки. Подробнее: Скачивание.
• Дополнительно — API, прокси, регион, результаты и папка скачивания. Подробнее: Дополнительные настройки.
• Лицензия — поле для лицензионного ключа.

📁 Основные файлы

В папке YouTube-Parser используются:

• 1_Search_Keywords.txt — поисковые запросы для парсинга выдачи и поисковых подсказок.
• 2_Channels_Urls.txt — ссылки на каналы.
• 3_Videos_Urls.txt — ссылки на видео.
• 4_Playlists_Urls.txt — ссылки на плейлисты.
• 5_Posts_Urls.txt — ссылки на посты сообщества.
• 6_Thumbnails_Urls.txt — ссылки на обложки или видео для скачивания обложек.
• [API].txt — API-ключи YouTube для заданий, которые работают через YouTube API.
• [Proxy].txt — прокси для заданий, которые требуют или выигрывают от работы через прокси.
• Downloads — скачанные видео, субтитры и обложки.
• Results — отчетные таблицы.
• [Config] — служебная папка шаблона.

Каждое значение указывается с новой строки. Если задание поддерживает несколько типов входных данных, нужный источник выбирается на вкладке соответствующего задания.

🧭 Как выбрать входные данные

1. Откройте входные настройки шаблона.
2. На вкладке Конфигурация YouTube-Parser выберите Задание.
3. Перейдите на вкладку этого задания и проверьте поле Входные данные.
4. Заполните соответствующий файл в папке YouTube-Parser.
5. Укажите лицензионный ключ и дополнительные параметры, если они нужны.
6. Запустите шаблон.

Например, для задания Парсинг поисковой выдачи используются поисковые запросы из 1_Search_Keywords.txt. Для Парсинга метаданных видео можно выбрать источник Видео или Канал: в первом случае используются ссылки из 3_Videos_Urls.txt, во втором — каналы из 2_Channels_Urls.txt.

🔀 Методы парсинга

YouTube API лучше использовать для задач, которые поддерживаются официальным API: поисковая выдача, метаданные каналов, видео, плейлистов, комментарии и часть связанных данных. Для работы нужны API-ключи.

InnerTube API используется для задач, где официальный API не дает нужных данных или не подходит по ограничениям: тренды, Shorts, посты, социальные ссылки, скачивание видео, скачивание субтитров и часть данных по каналам или видео. Для больших запусков могут понадобиться прокси.

✅ Типовой порядок работы

1. Выберите метод работы: YouTube API или InnerTube API.
2. Выберите одно задание.
3. Заполните файл входных данных для выбранного задания.
4. Настройте фильтры, лимиты, регион и дополнительные параметры.
5. Для YouTube API проверьте API-ключи.
6. Для InnerTube API при необходимости включите прокси или задержку между запросами.
7. Укажите лицензионный ключ.
8. Запустите шаблон и проверьте отчет.

Перед большим запуском выполните тест на нескольких строках. Это помогает проверить формат ссылок, доступность API-ключей, прокси и ожидаемый вид отчета.

⚠️ Ограничения

• Часть заданий работает только через YouTube API или только через InnerTube API. Поддерживаемый метод указан в заголовке блока настроек.
• Фильтры не превращают YouTube-Parser в поиск «по всей платформе». В большинстве сценариев сначала нужны входные данные: запросы, каналы, видео, плейлисты или посты.
• Для поисковой выдачи YouTube действует ограничение по количеству результатов на один запрос. Для расширения базы используйте разные поисковые фразы.
• Перед массовым запуском лучше выполнить тест на небольшом списке.

📊 Результаты и восстановление

Результаты сохраняются в отчетные таблицы в папке шаблона. Название отчета зависит от выбранного задания: поисковая выдача, метаданные каналов, метаданные видео, комментарии, плейлисты, тренды, Shorts или скачанный контент.

Для скачивания видео, каналов, субтитров и обложек используется папка Downloads, если во входных настройках не указан собственный путь скачивания.

Если выполнение было прервано и итоговая таблица не появилась, проверьте служебную папку базы данных внутри [Config]. Если база с промежуточными результатами сохранилась, запустите YouTube-Parser в одно выполнение:

Сколько делать: 1

При таком запуске шаблон попытается сохранить результаты из базы и создать отчетные таблицы.

🔒 Безопасность файлов

Не публикуйте и не отправляйте третьим лицам без очистки:

• [API].txt;
• [Proxy].txt;
• папку [Config];
• лицензионные файлы;
• cookies, логи и служебные базы;
• реальные результаты, если в них есть ссылки, email или коммерческие данные.