Transcript Dock и youtube-transcript-api

Коротко: для скриптов и ноутбуков на вашем собственном интернет-соединении продолжайте использовать youtube-transcript-api: она бесплатна и хороша. Переходите на облачный API, когда библиотека работает на сервере: YouTube блокирует большинство облачных IP-адресов, и тогда библиотеке нужен платный резидентный прокси. Облачный API также охватывает TikTok и видео без субтитров.

Сравнение по пунктам#

Проблема облачных IP-адресов#

В README библиотеки сказано, что YouTube начал блокировать большинство IP-адресов, известных как принадлежащие облачным провайдерам, и тогда запросы завершаются ошибками RequestBlocked или IpBlocked. Предлагаемое решение: ротируемый резидентный прокси. Это второй счёт и ещё одна вещь, за которой нужно следить. Transcript Dock берёт эту часть на себя, и вы платите за транскрипт, а не за гигабайт трафика прокси.

Переход займёт несколько строк#

Сегменты приходят с start и end в секундах, что близко к фрагментам библиотеки.

# before
from youtube_transcript_api import YouTubeTranscriptApi
snippets = YouTubeTranscriptApi().fetch("dQw4w9WgXcQ")
 
# after
import requests
API, H = "https://www.transcriptdock.com", {"Authorization": "Bearer td_live_YOUR_KEY"}
job = requests.post(f"{API}/v1/jobs", headers={**H, "Idempotency-Key": "yt-dQw4w9WgXcQ"},
    json={"source": {"url": "https://youtu.be/dQw4w9WgXcQ"}, "mode": "captions_only"}).json()
while job["status"] not in ("succeeded", "failed", "cancelled"):
    job = requests.get(f"{API}/v1/jobs/{job['id']}", params={"wait": 25}, headers=H).json()
segments = requests.get(f"{API}/v1/transcripts/{job['result_id']}", headers=H).json()["segments"]
# each segment: {"start": 0.0, "end": 2.4, "text": "..."}

Что выбрать#

• Выбирайте библиотеку, если нужен только YouTube, объём небольшой и вы работаете с ноутбука или домашнего сервера.
• Выбирайте Transcript Dock для продакшена на облачном хостинге, для TikTok, видео без субтитров, экспорта субтитров или доступа Claude и Cursor через MCP.

Другие варианты описаны в руководстве по получению транскрипта YouTube.