‍Genel Bakış

YouTube MCP, YouTube Data API v3 ile entegrasyon sağlar. Bu sayede LLM tabanlı uygulamalar (ChatGPT, Claude, Cursor vb.) YouTube içeriklerini standart bir şekilde sorgulayabilir ve kullanabilir.

Desteklenen işlemler:

• Video Detaylarını Getirme
• Video Arama

Configuration Manager Üzerinden Ayarların Yapılması

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi seçin.

3. Configuration Manager → App Settings sekmesine gidin.
4. MCP > YouTubeMcp bölümünden ADD NEW seçeneğini tıklayın.
5. Açılan pencerede:
   
   • Name: Bu entegrasyona verilecek ayırt edici ad.
   • API Key: Google Cloud Console üzerinden oluşturulan API anahtarı.
   • Language: Kullanılacak dil (ISO 639-1 formatında).
     
     • "en" → İngilizce
     • "tr" → Türkçe
     • "es" → İspanyolca
     • "de" → Almanca
     • "fr" → Fransızca

YouTube API Key Oluşturma Adımları

1. Google Cloud Console adresine giriş yapın.

2. Var olan bir proje seçin veya yeni bir proje oluşturun.

3. Arama kısmına “YouTube Data API v3” yazın ve ilgili sonucu seçin.

4. Açılan sayfada Enable butonuna tıklayın.

5. Credentials → Create Credentials → API Key yolunu takip edin.
6. Oluşturulan API Key’i kopyalayın.

7. Kuika’daki Configuration Manager → YouTubeMcp Settings alanına yapıştırın.

Action Türleri

YouTube Get Video Details

Belirli bir YouTube videosunun ayrıntılarını getirir.

Action Input

• settings: Config Manager’da oluşturduğunuz YouTube ayarı.
• videoIds: Videonun benzersiz kimliği (11 karakter).
  
  • https://www.youtube.com/watch?v=dQw4w9WgXcQ → v= sonrası
  • https://youtu.be/dQw4w9WgXcQ → linkin sonundaki 11 karakter
  • https://www.youtube.com/watch?v=dQw4w9WgXcQ&list=PL12345ABCDE → v= sonrası (list parametresi playlist ID’sidir)

Action Output

• id → Video ID’si
• etag → Veri değişim takibi için Entity Tag

• kind → Yanıtın türü (video, kanal, playlist vb.)
• snippet → Başlık, açıklama, kanal, tarih, thumbnail’ler

• statistics → İzlenme, beğeni, yorum sayıları
• contentDetails → Süre, çözünürlük, altyazı bilgisi, lisans bilgisi

Önemli Alt Alanlar:

• contentDetails
  
  • duration → ISO 8601 formatında süre (örn: PT3M34S)
  • definition → sd / hd
  • dimension → 2D / 3D
  • caption → Altyazı var mı
  • licensedContent → Lisanslı içerik mi

• projection → Normal / 360° video

• Snippet

• title → Videonun başlığı
• description → Açıklama metni
• channelId → Yükleyen kanalın ID’si
• channelTitle → Kanal adı
• publishedAt → Yayın tarihi (ISO 8601)
• tags → Video etiketleri
• thumbnails → Küçük resimler (farklı boyutlarda)
• localized → Çoklu dil başlık ve açıklamalar

• Statistics

• viewCount → İzlenme sayısı
• likeCount → Beğeni sayısı
• commentCount → Yorum sayısı
• favoriteCount → Favorilere eklenme sayısı

YouTube Search Videos

‍

Anahtar kelimeye göre video araması yapar.

Action Input

• settings: Config Manager’da oluşturduğunuz YouTube ayarı.
• query: Aranacak video için anahtar kelimeler.
• maxResults: Getirilecek maksimum sonuç sayısı.

Action Output

• etag → Veri değişim takibi için Entity Tag
• id → Video kimliği ve türü
• kind → Yanıtın türü

• snippet → Başlık, açıklama, kanal bilgisi, tarih, thumbnail’ler

Önemli Alt Alanlar:

• title → Videonun başlığı
• description → Video açıklaması
• channelId → Kanal ID’si
• channelTitle → Kanal adı
• publishedAt → Yayın tarihi (ISO 8601)
• tags → Video etiketleri
• thumbnails → Farklı boyutlarda küçük resimler
• liveBroadcastContent → Canlı yayın durumu
• localized → Çoklu dil başlık ve açıklamalar

Kuika’da Kullanım

Configuration Manager’da oluşturulan YouTube ayarları, projedeki YouTube Action içinde settings parametresine bağlanarak kullanılabilir.

Örnek senaryolar:

• Kullanıcıdan alınan bir video linkinin detaylarını göstermek → Get Video Details
• Belirli bir kelimeyle arama yapıp liste halinde video döndürmek → Search Videos