youtube-api

youtube-api — это инструмент (skill), который предоставляет доступ к данным YouTube через API TranscriptAPI. Он позволяет получать расшифровки видео, выполнять поиск, работать с каналами и плейлистами — без необходимости использовать официальный API Google.

Обзор

Данный skill создан для AI-агентов и разработчиков, которым требуется быстрый и стабильный доступ к данным YouTube. В отличие от традиционных решений (например, yt-dlp или неофициальных парсеров), он работает через специализированный API и не сталкивается с блокировками или ограничениями платформы.

Основная цель — упростить работу с YouTube-данными и предоставить единый интерфейс для получения информации о видео, каналах и плейлистах.

Основные возможности

• Получение транскриптов (субтитров) видео
• Поиск видео и каналов
• Просмотр данных каналов и последних публикаций
• Получение списка видео из плейлистов
• Поиск внутри конкретного канала

Все операции выполняются через REST API, что делает инструмент универсальным и пригодным для использования в любых средах и языках программирования.

Настройка

Для работы необходим API-ключ TRANSCRIPT_API_KEY. Если переменная окружения не задана, потребуется создать аккаунт в TranscriptAPI.

Шаг 1 — Регистрация

node ./scripts/tapi-auth.js register --email USER_EMAIL --password SECURE_PASS --json

На email будет отправлен одноразовый код подтверждения.

Шаг 2 — Подтверждение

node ./scripts/tapi-auth.js verify --email USER_EMAIL --password SECURE_PASS --otp CODE --json

После подтверждения вы получите API-ключ.

Шаг 3 — Сохранение ключа

node ./scripts/tapi-auth.js save-key --key API_KEY --json

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

Примеры использования API

Получение транскрипта

curl -s "https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_URL&format=text&include_timestamp=true" \
-H "Authorization: Bearer $TRANSCRIPT_API_KEY"

Возвращает текстовую расшифровку видео с таймкодами.

Поиск

curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" \
-H "Authorization: Bearer $TRANSCRIPT_API_KEY"

Позволяет искать видео или каналы по ключевым словам.

Работа с каналами

Получение ID канала по handle:

curl -s "https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@channel"

Получение последних видео канала:

curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel_id=UC_ID"

Плейлисты

curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist_id=PL_ID"

Возвращает список видео в плейлисте с поддержкой пагинации.

Стоимость запросов

• Транскрипт — 1 кредит
• Поиск — 1 кредит
• Видео канала — 1 кредит за страницу
• Плейлисты — 1 кредит за страницу
• Resolve и Latest — бесплатно

Типичный сценарий использования

Один из самых распространённых сценариев — исследование темы через YouTube:

• Выполнить поиск по теме
• Выбрать релевантные видео
• Получить транскрипты
• Проанализировать содержимое

Такой подход позволяет автоматизировать анализ видеоконтента и использовать его в AI-приложениях.

Обработка ошибок

• 401 — неверный API-ключ
• 402 — недостаточно кредитов
• 404 — ресурс не найден
• 429 — превышен лимит запросов

При возникновении ошибок рекомендуется проверить параметры запроса и состояние API-ключа.

Заключение

youtube-api — это мощный инструмент для работы с YouTube-данными, ориентированный на разработчиков и AI-агентов. Он избавляет от необходимости использовать сложные обходные решения и предоставляет стабильный доступ к информации через единый API.