batch batch

README.md

@@ -60,9 +60,9 @@ curl -H "X-API-Key: demo_key_12345" \
 # Channel Handle ile (API key query parametresi)
 curl "http://localhost:5000/?channel=@tavakfi&format=Atom&api_key=demo_key_12345"
 
-# Channel URL ile
+# Channel URL ile (max_items: her istekte işlenecek transcript sayısı, default: 10, max: 100, 20'şer batch'ler)
 curl -H "X-API-Key: demo_key_12345" \
-  "http://localhost:5000/?channel_url=https://www.youtube.com/@tavakfi&format=Atom&max_items=100"
+  "http://localhost:5000/?channel_url=https://www.youtube.com/@tavakfi&format=Atom&max_items=50"
 ```
 
 **Detaylı API dokümantasyonu için:** [API.md](API.md)
@@ -108,7 +108,7 @@ channel:
 rss_bridge:
   base_url: "https://rss-bridge.org/bridge01"
   format: "Atom"
-  max_items: 100
+  max_items: 100  # RSS-Bridge'den çekilecek video sayısı (web server'da max_items parametresi farklı)
 ```
 
 ### Güvenlik Yapılandırması
@@ -139,6 +139,29 @@ Sistem, işlenmiş transcript'leri **3 gün boyunca cache'de tutar**. Bu özelli
 
 Cache kontrolü otomatik yapılır ve kullanıcı müdahalesi gerektirmez.
 
+### max_items Parametresi
+
+Her API isteğinde kaç video transcript'inin işleneceğini kontrol eder:
+
+- **Varsayılan**: 10 transcript
+- **Maksimum**: 100 transcript
+- **Kullanım**: `?max_items=50` query parametresi ile belirtilir
+- **Batch İşleme**: 20'şer batch'ler halinde işlenir (YouTube IP blocking önleme için)
+
+**Önemli Notlar:**
+- `max_items` parametresi **her istekte işlenecek transcript sayısını** belirler
+- RSS-Bridge'den daha fazla video çekilir (max_items × 2, minimum 50) çünkü bazı videolar transcript'siz olabilir
+- **Batch İşleme**: YouTube IP blocking'i önlemek için 20'şer batch'ler halinde işlenir
+- **Veritabanı Kaydı**: Her batch işlendikten sonra hemen veritabanına kaydedilir, böylece sonraki sorgularda görülebilir
+- İlk isteklerde daha az transcript görebilirsiniz; sonraki isteklerde cache'den daha fazla transcript döner
+
+**Örnek:**
+```bash
+# 50 transcript işle (20+20+10 batch'ler halinde)
+curl -H "X-API-Key: demo_key_12345" \
+  "http://localhost:5000/?channel_id=UC9h8BDcXwkhZtnqoQJ7PggA&max_items=50&format=Atom"
+```
+
 ## Proje Yapısı
 
 ```