youtube-transcript-api YouTube Tarafından Engellendi mi? İşe Yarayan 4 Çözüm

Hata: yerelde çalışıyor, üretimde engelleniyor

Python kütüphanesi youtube-transcript-api, YouTube transkriptlerini programatik olarak çekmenin en yaygın yoludur. Kendi makinenizde genellikle sorunsuz çalışır. Ancak kodunuz bir bulut sunucusunda çalışmaya başladığı anda istekler IpBlocked, RequestBlocked veya TooManyRequests gibi istisnalarla başarısız olur — çoğunlukla YouTube'un IP'nizi engellediğini ima eden bir mesajla birlikte.

Aynı şey kazımaya dayalı her yaklaşımın başına gelir: Node.js transkript paketleri, yt-dlp ile altyazı çıkarma ve kendi yazdığınız kazıyıcılar aynı duvara toslar. Tetikleyici kodunuz değil, isteklerinizin nereden geldiğidir.

İş yükünüz AWS Lambda, Google Cloud Run, Vercel, Railway, Fly.io veya herhangi bir VPS üzerinde çalışıyorsa YouTube bir veri merkezi IP adresi görür. Bu IP aralıkları herkesçe bilinir, botlar tarafından yoğun biçimde kötüye kullanılır ve toplu olarak engellenir. Ev Wi-Fi'ınız gibi mesken bağlantıları ise nadiren engellenir — "benim makinemde çalışıyor" sözü burada kelimenin tam anlamıyla doğrudur.

YouTube bu istekleri neden engelliyor?

YouTube transkriptleri, üçüncü taraf kullanımı için hiç tasarlanmamış, dahili ve kimlik doğrulaması olmayan bir endpoint tarafından sunulur. Rastgele videoların transkriptini almaya yarayan resmî ve açık bir API yoktur: resmî Data API'nin altyazı endpoint'i, video sahibinden OAuth izni ister; yani yalnızca kendi videolarınız için çalışır.

Dahili endpoint ücretsiz ve kimlik doğrulamasız olduğu için yapay zekâ şirketleri, SEO araçları ve kazıyıcılar tarafından sürekli zorlanır. YouTube da elindeki tek yolla karşılık verir — agresif hız sınırlaması, veri merkezi IP aralıklarının topluca engellenmesi ve kazıma kütüphanelerini bir gecede bozan ara sıra endpoint değişiklikleri.

Bu da her kendi kendine barındırılan çözümün kalıcı bir kedi-fare oyununun içinde olduğu anlamına gelir. Aşağıdaki dört çözüm, en çok elle uğraştırandan en çok yönetilene doğru sıralanmıştır.

Çözüm 1: İstekleri mesken proxy'leri üzerinden yönlendirin

Standart kendin-yap çözümü, isteklerinizi dönüşümlü mesken (residential) proxy'ler üzerinden geçirmektir; böylece YouTube sunucunuzu değil sıradan ev IP'lerini görür. youtube-transcript-api'nin güncel sürümleri bunu doğrudan destekler: istemciyi oluştururken bir proxy yapılandırması geçin (kütüphane bir WebshareProxyConfig yardımcısıyla gelir; ya da herhangi bir HTTP/SOCKS proxy'si için GenericProxyConfig kullanın).

Bu yöntem işe yarar ama gerçek bir maliyeti vardır. Mesken proxy bant genişliği pahalıdır (genellikle GB başına birkaç dolar), sağlayıcılar arasında kalite çok değişkendir ve artık yeni bir arıza türünün sahibi olursunuz: bir proxy IP'si istek ortasında engellendiğinde yeniden deneme mantığı, sağlık kontrolleri ve sağlayıcı yedeklemesi gerekir. Düşük hacimlerde ayrıca en yavaş seçenek olabilir, çünkü her istek proxy ağı üzerinden fazladan bir sıçrama yapar.

Tam kontrol istiyorsanız, bakım için mühendislik zamanınız varsa ve hacminiz bu kurulumu haklı çıkaracak kadar yüksekse bunu seçin.

Çözüm 2: Getiriciyi bir mesken bağlantısında çalıştırın

Daha basit bir varyant: işlem hattınızın transkript çeken kısmını mesken IP'ye sahip bir yerde çalıştırın — evdeki bir Raspberry Pi, ofisteki bir makine ya da ucuz bir mini bilgisayar — ve sonuçları bir kuyruk veya webhook aracılığıyla bulut altyapınıza gönderin.

Bu, proxy maliyetlerini tümüyle ortadan kaldırır ve küçük, kişisel iş yüklerinde (diyelim ki kendi notlarınız veya küçük bir bülten için video yazıya dökmek) şaşırtıcı derecede iyi çalışır. Dezavantajları ise ortada: fiziksel bir tek hata noktasıdır, ölçeklenmez ve bir üretim ürünü için tuhaf bir mimaridir.

Çözüm 3: Agresif önbellekleyin ve hatalarda geri çekilin

Hangi çekme yöntemini kullanırsanız kullanın, iki pratik engellenme oranını ciddi biçimde düşürür. Birincisi, çektiğiniz her transkripti önbelleğe alın — transkriptler neredeyse hiç değişmez, dolayısıyla aynı videoyu iki kez çekmenin bir anlamı yok. Video kimliğine göre anahtarlanmış basit bir veritabanı tablosu, tekrar eden trafiğin çoğunu ortadan kaldırır.

İkincisi, engellenmeyi hemen yeniden denenecek bir hata değil, bir sinyal olarak görün. Rastgele gecikmeli üstel geri çekilme (1 sn bekle, sonra 2, 4, 8 sn...) sizi radarın altında tutar. Engellendikten sonra endpoint'i zorlamak, tüm IP aralığınızın yasaklanmasının en hızlı yoludur.

Bunun bir çözüm değil, bir hafifletme olduğunu unutmayın — veri merkezi IP'sinde daha ilk isteğiniz bile engellenebilir. Bunu diğer üç çözümden biriyle birlikte uygulayın.

Çözüm 4: Barındırılan bir transkript API'si kullanın (bakım derdi yok)

Yönetilen seçenek: IP sorununu zaten çözmüş bir hizmetin sizin yerinize transkript çekmesine izin verin. ParseJet tek bir endpoint sunar — video URL'siyle POST /v1/parse/youtube — ve tam transkripti; video başlığı, kanal ve süre bilgisiyle birlikte JSON olarak döndürür. Engellenme, proxy yönetimi ve endpoint değişiklikleri sunucu tarafında halledilir; kodunuz üç satırdır ve üç satır kalır.

youtube-transcript-api'den geçiş birkaç dakika sürer: kütüphane çağrısını tek bir HTTP POST ile değiştirin (Python, Node.js veya HTTP konuşan her şeyden çalışır — kütüphane yaklaşımının en çok engellendiği sunucusuz fonksiyonlar dahil). Belirli bir altyazı dilini language parametresiyle isteyin.

Ücretsiz katman ayda 300 kredi içerir (bir YouTube transkripti 5 kredidir, yani 60 video) ve ücretli planlar ayda 19$'dan başlar. Çoğu ürün için bu, mesken proxy bant genişliği artı onu sürekli kollamanın mühendislik maliyetinden daha ucuzdur.

Hangi çözümü seçmelisiniz?

Kişisel proje, düşük hacim, teknik rahatlık: Çözüm 2 (mesken makine) ücretsizdir ve yeterince güvenilirdir.

Özel altyapı mühendisliğiyle yüksek hacim: Çözüm 1 (dönüşümlü mesken proxy'ler) size en fazla kontrolü verir — proxy maliyetleri ve sürekli bakım için bütçe ayırın.

Transkriptin çekirdek işiniz değil bir özellik olduğu üretim uygulamaları, ajanlar veya RAG işlem hatları: Çözüm 4 (barındırılan API) — tek HTTP çağrısı, kedi-fare oyunu yok. Her durumda üzerine Çözüm 3'ü (önbellekleme + geri çekilme) ekleyin.