‍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

Config Manager Üzerinden Ayarların Yapılması

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi açın.
3. Üst menüden Config Manager modülüne tıklayın.

4. Var olan bir konfigürasyonu düzenlemek için listeden adına tıklayın veya Create a blank configuration kartıyla yeni bir konfigürasyon oluşturun.
5. Konfigürasyon ekranının üst kısmında App Settings sekmesinin seçili olduğundan emin olun.
6. Sol menüde INTEGRATIONS başlığı altındaki MCP seçeneğine tıklayın.
7. YouTube alanının altındaki Add New bağlantısına tıklayın.

8. Açılan YouTube MCP Setting penceresinde aşağıdaki alanları doldurun (tüm alanlar zorunludur):

• Name: Bu entegrasyona verilecek ayırt edici ad.
• API Key: Google Cloud Console’da APIs & Services > Credentials sayfasından oluşturduğunuz API anahtarı. Anahtarın kullanılabilmesi için projenizde YouTube Data API v3'ün etkin olması gerekir.
• Language: İçerik aramalarında kullanılacak dil (ISO 639-1 formatında). Örneğin:
  
  • en → İngilizce
  • tr → Türkçe
  • es → İspanyolca
  • de → Almanca
  • fr → Fransızca

9. Create butonuna tıklayın.
10. YouTube açılır menüsünden oluşturduğunuz yapılandırmayı seçin.
11. Sağ üst köşedeki Save butonuna tıklayarak değişiklikleri kaydedin. (Mevcut bir konfigürasyonda bu buton Update olarak görünür.)

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