← Blog

NotebookLM API: Kurumsal API, MCP ve CLI Araçları

Yazan LeoNotebookLM

NotebookLM API'si var mı? NotebookLM Enterprise ne sunar; notebooklm-py, MCP sunucuları ve CLI araçları ne yapar; transkriptler nasıl otomatikleştirilir?

NotebookLM API: Kurumsal API, MCP ve CLI Araçları

NotebookLM API'si var mı? Evet, ancak yalnızca Google'ın belgelediği bir tane var ve bu API ücretsiz tüketici uygulaması için değil. Resmî NotebookLM API'si, Google Cloud'daki NotebookLM Enterprise'ın bir parçasıdır: not defterleri oluşturan, kaynaklar ekleyen, not defterlerini paylaşan ve bir Google Cloud projesi içinde Audio Overviews üreten bir önizleme REST API'si. notebooklm-py, çok sayıdaki NotebookLM MCP sunucusu ve çoğu NotebookLM CLI aracı dâhil olmak üzere arama yaptığınızda bulacağınız diğer her şey topluluk tarafından geliştirilmiştir ve resmî bir Google ürünü değildir.

Bu kılavuz bu seçenekleri birbirinden ayırır. NotebookLM Enterprise API'sinin gerçekte neler yapabildiğini, resmî olmayan Python kütüphanesinin, MCP sunucularının ve CLI'ların nasıl çalıştığını, hangisinin hangi işe uygun olduğunu ve video ağırlıklı bir not defterinde genellikle ilk gereken adımı nasıl otomatikleştireceğinizi ele alır: YouTube videolarını, oynatma listelerini ve kanalları Transcript.im API'si ve Transcript.im MCP sunucusuyla temiz metne dönüştürmek.

Ayrıntılara geçmeden önce bir adlandırma notu. Google, 16 Temmuz 2026'da NotebookLM'nin adını Gemini Notebook olarak değiştirdi ve Google Cloud belgelerinde artık "Gemini Notebook Enterprise" ifadesi yer alıyor. Bu aynı üründür; bu makale, çoğu geliştiricinin hâlâ aradığı ad olduğu için NotebookLM adını kullanmaya devam ediyor. Aracın neleri iyi yaptığını ve hangi noktalarda yetersiz kaldığını daha geniş kapsamda öğrenmek istiyorsanız NotebookLM incelememiz ile başlayın. Aşağıdaki tüm API ayrıntıları, 24 Ekim 2026'da Google Cloud belgeleri ve her projenin kendi sayfası karşılaştırılarak doğrulandı. Önizleme API'leri ve topluluk projeleri hızla değişir; bu nedenle güncel sayfalarını nihai kaynak olarak kabul edin.

NotebookLM API'si Var mı? Kısa Yanıt

Resmî bir NotebookLM API'si var ve Google Cloud'da bulunuyor. Google, bir şirketin Google Cloud projesi içinde çalışan kurumsal sürüm olan NotebookLM Enterprise için REST belgeleri yayımlıyor. Google, kişisel bir Google hesabıyla açtığınız tüketici NotebookLM uygulaması için bir geliştirici API'si yayımlamadı. Bu boşluk, bu kadar çok gayriresmî aracın var olmasının nedeni: bu araçlar tüketici uygulamasına tarayıcıyı yönlendirerek veya web uygulamasının kullandığı belgelenmemiş uç noktaları çağırarak erişiyor.

Ana seçeneklerin karşılaştırması şöyle:

SeçenekKim geliştiriyorŞununla çalışırNasıl oturum açar
NotebookLM Enterprise APIGoogle (önizleme)Bir cloud projesindeki NotebookLM Enterprise not defterleriGoogle Cloud kimlik bilgileri; örneğin bir gcloud erişim token'ı
notebooklm-pyTopluluk (gayriresmî)Tüketici uygulamasıTarayıcı girişi üzerinden Google hesabınız
NotebookLM MCP sunucularıTopluluk (gayriresmî)Çoğunlukla tüketici uygulamasıGenellikle bir kez giriş yaptığınız tarayıcı oturumu
NotebookLM CLI araçlarıTopluluk (gayriresmî)Araca bağlıdır: tüketici uygulaması veya Enterprise APITarayıcı girişi veya gcloud

Bu ayrım, herhangi bir tek özellikten daha önemlidir. Not defterleriniz kişisel bir hesapta bulunuyorsa, bulduğunuz her NotebookLM API seçeneği gayriresmîdir. Şirketiniz zaten NotebookLM Enterprise kullanıyorsa, Google'ın kendi NotebookLM API'sini kullanabilir ve her şeyi cloud projenizin içinde tutabilirsiniz.

Google Cloud'da NotebookLM Enterprise API

NotebookLM Enterprise API, Discovery Engine hizmetindeki v1alpha sürümüne sahip bir REST yöntemleri kümesidir. Google'ın API ile not defterleri oluşturma ve yönetme kılavuzu bu özelliği Preview olarak işaretler; bu da Google'ın Pre-GA şartları kapsamında olduğu ve desteğin sınırlı olabileceği anlamına gelir. İstekler, us veya eu çoklu bölgesindeki ya da global konumundaki bir uç noktaya gönderilir, proje numaranızla sınırlandırılır ve bir Google Cloud bearer token ile kimlik doğrulaması yapar.

NotebookLM Enterprise API: not defterleri ve IAM rolleri tek bir Google Cloud projesinde tutulur

Bu NotebookLM API'yi, ekibinizin tarayıcıda açtığı aynı not defterlerini programatik olarak kullanmanın resmi yolu olarak düşünebilirsiniz. Not defterleri cloud projenizin içinde kalır ve erişim, kişisel Google hesapları yerine IAM rolleriyle kontrol edilir.

Enterprise API Not Defterleriyle Neler Yapabilir?

Not defteri yöntemleri temel yaşam döngüsünü kapsar:

  • Oluşturma işlemi için notebooks.create kullanılır. İstek gövdesi bir title taşır ve yanıt, sonraki her çağrıda kullanacağınız bir notebookId döndürür.
  • Tek bir not defterini alma işlemi için notebooks.get kullanılır.
  • Son görüntülenen not defterlerini listeleme işlemi için notebooks.listRecentlyViewed kullanılır; bu yöntem, isteğe bağlı sayfalama ile en fazla son 500 not defterini döndürür.
  • Not defterlerini toplu silme işlemi için notebooks.batchDelete kullanılır.
  • Bir not defterini paylaşma işlemi için notebooks.share kullanılır; kişilere sahip, yazar veya okuyucu rolleri verilir. Alıcıların ayrıca Cloud NotebookLM User IAM rolüne sahip olması gerekir.

Bir not defteri oluşturma işlemi, Google'ın büyük harfle yazılmış yer tutucuları kullanılarak şöyle görünür:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks" \
  -d '{"title": "Customer interviews Q4"}'

API Üzerinden Kaynak Ekleme

NotebookLM Enterprise API'yi otomasyon için kullanışlı kılan şey kaynaklardır. Google'ın veri kaynakları eklemeye yönelik tamamlayıcı kılavuzu dört yöntem listeler: aynı anda birkaç kaynak eklemek için sources.batchCreate, tek bir dosya yüklemek için sources.uploadFile, bir kaynağı okumak için sources.get ve kaynakları kaldırmak için sources.batchDelete. Bir batchCreate isteğindeki her giriş, tek bir içerik türü barındırır:

  • Google Doc veya Slides dosyası için googleDriveContent; bu, kullanıcı kimlik bilgileriyle Drive yetkilendirmesi gerektirir
  • Ham metin için textContent; bir sourceName ve content içerir
  • Bir web sayfası URL'si için webContent
  • Bir YouTube videosu için videoContent; tek bir youtubeUrl içerir

Dosya yüklemeleri PDF, TXT, Markdown, DOCX, PPTX ve XLSX gibi belgelerin yanı sıra yaygın ses formatlarını ve görselleri de kabul eder. Transkript gibi kendiniz oluşturduğunuz metinler için textContent veya yüklenen bir .md dosyası en temiz seçenektir; çünkü içeriğe tam olarak neyin gireceğini siz kontrol edersiniz.

Audio Overviews ve Kullanımdan Kaldırılan Podcast API

Enterprise API, notebooks.audioOverviews.create ile bir Audio Overview da oluşturabilir. Kullanılacak kaynak kimliklerini, nelerin öne çıkarılacağını açıklayan bir episodeFocus değerini ve bir languageCode iletebilirsiniz. Google, bir not defterinin yalnızca bir Audio Overview içerebileceğini, not defterinin önce kaynaklara ihtiyaç duyduğunu ve oluşturma işleminin birkaç dakika sürdüğünü belirtir. Audio Overviews'ın nasıl duyulduğu ve uygulamanın sunduğu seçenekler için NotebookLM podcast ve Audio Overview kılavuzumuza bakın.

Ayrıca, sağladığınız bağlamdan bir not defterine ihtiyaç duymadan podcast tarzı MP3'ler oluşturan Google'ın bağımsız Podcast API'siyle de karşılaşabilirsiniz. Google'ın sayfası artık Podcast API'yi deprecated olarak işaretliyor ve yeni müşteriler için allowlist'e ekleme yapmadığını söylüyor; bu nedenle yeni çalışmalarınızı bunun üzerine planlamayın.

NotebookLM Enterprise API'yi Kimler Kullanabilir?

API yalnızca NotebookLM Enterprise çalıştıran kuruluşlarda çalışır. Google bunu bağımsız bir ürün olarak veya Gemini Enterprise'ın bir parçası olarak satar; kullanıcılar Cloud Identity ya da Microsoft Entra ID veya Okta gibi üçüncü taraf bir kimlik sağlayıcısı üzerinden oturum açar ve her kullanıcının Cloud NotebookLM User rolüne sahip olması gerekir. NotebookLM'yi kişisel bir Gmail hesabıyla kullanıyorsanız bu API not defterlerinizi göremez.

NotebookLM MCP Sunucuları

Bir NotebookLM MCP sunucusu, bir yapay zekâ aracısının NotebookLM’i bir araç olarak kullanmasını sağlayan küçük bir programdır. MCP, Model Context Protocol, Claude, ChatGPT, Cursor ve diğer aracıları dış araçlara ve verilere bağlamak için kullanılan açık bir standarttır. Bir istemci, sunucunun sunduğu araçları keşfeder ve bir konuşmanın ortasında çağırır; böylece bir aracı, bir dosyayı okur gibi not defterine soru sorabilir.

NotebookLM MCP: MCP sunucusu aracılığıyla bir not defterine bağlanan yapay zekâ aracısı

"NotebookLM MCP" ve "NotebookLM MCP server" aramaları topluluk projelerine yönlendirir. Kontrol ettiklerimizin hiçbiri Google tarafından yapılmamış. Bunlar iki yaygın biçimde karşımıza çıkar.

Tarayıcı Tabanlı MCP Sunucuları

İlk biçim, gerçek bir Chrome penceresini yönetir. Google hesabınızda bir kez oturum açarsınız, sunucu bu tarayıcı oturumunu kaydeder ve aracının araç çağrıları NotebookLM web uygulamasında tıklamalara ve yazılan metinlere dönüşür. Bu türden yaygın olarak paylaşılan bir proje olan PleasePrompto/notebooklm-mcp, bir not defterine soru sorma, bir URL veya metin kaynağı ekleme, bir Audio Overview oluşturup indirme ve not defterlerinden oluşan bir kütüphaneyi yönetme araçları sunuyordu; Claude Code’a claude mcp add notebooklm -- npx notebooklm-mcp@latest ile ekleniyordu. GitHub deposu artık arşivlenmiş durumda ve bakımı yapılmıyor; bu, bu alanın ne kadar hızlı değiştiğinin tipik bir örneği.

Bir Kütüphaneyle Birlikte Paketlenen MCP Sunucuları

İkinci biçim, resmî olmayan bir kütüphaneyi sarar ve işlevlerini MCP araçları olarak sunar. Bir sonraki bölümde ele alınan notebooklm-py, Claude Desktop, Claude Code ve Codex için stdio üzerinden yerel olarak veya kendi barındırdığınız uzak bir bağlayıcı olarak çalışan bir MCP sunucusuyla birlikte gelir. Tam kapsamlı bir kütüphanenin üzerinde çalıştığı için genellikle NotebookLM’in daha büyük bir bölümünü bir tarayıcı betiğine kıyasla kapsar.

Birine Bağlanmadan Önce Kontrol Edilmesi Gerekenler

Hangi NotebookLM MCP sunucusunu seçerseniz seçin, kendi sayfasında dört şeyi kontrol edin: hâlâ bakımının yapılıp yapılmadığını, Google hesabınızda nasıl oturum açtığını ve bu oturumu nerede tuttuğunu, hangi not defterlerine erişebildiğini ve tüketici uygulamasına mı yoksa Enterprise API’ye mi ulaştığını. NotebookLM MCP sunucusuna sahip bir aracı, oturum açılmış hesabın erişebildiği her not defterini okuyabilir ve değiştirebilir; bu nedenle ona otomatikleştirme konusunda rahat olduğunuz bir hesap ve not defterleri verin.

notebooklm-py: Resmî Olmayan Python Kütüphanesi

notebooklm-py, tüketici uygulaması için en kapsamlı resmî olmayan NotebookLM API'sidir. GitHub deposu, onu “Google Gemini Notebook için Resmî Olmayan Python API'si ve aracı becerisi” olarak tanımlar ve bunun Google ile bağlantısı olmayan, önceden haber verilmeksizin değişebilen belgelenmemiş Google API'leri üzerine kurulmuş bir topluluk projesi olduğunu belirtir.

PyPI'dan notebooklm-py adıyla yüklenir. Proje, komut satırı aracının tarayıcı desteğiyle yüklenmesini önerir:

pipx install "notebooklm-py[browser]"
# veya bir sanal ortam içinde
pip install "notebooklm-py[browser]"

Kütüphane; not defterlerini, kaynakları ve alıntılı sohbeti kapsar; ses, video, slayt desteleri, infografikler, testler, bilgi kartları, raporlar, veri tabloları ve zihin haritaları gibi Studio çıktıları oluşturup indirir ve paylaşımı yönetir. Oturum açma varsayılan olarak etkileşimli bir tarayıcı girişidir; ayrıca hâlihazırda oturum açmış olduğunuz bir tarayıcıdan çerezleri içe aktarma seçeneği sunar.

Tüketici uygulamasının üzerinde kişisel veya araştırma amaçlı bir iş akışı istediğinizde notebooklm-py kullanın: her hafta bir dosya klasöründen not defteri oluşturmak, aynı soru grubunu birkaç not defterinde sormak veya oluşturulan ses dosyalarını bir arşiv için indirmek gibi. Bir işletmenin bağlı olduğu her şey için Google'ın belgelediği ve desteklediği yol Enterprise API'dir.

NotebookLM CLI Seçenekleri

NotebookLM CLI, tarayıcı yerine bir terminalden veya shell betiğinden not defteri görevlerini çalıştırmanızı sağlar. İki ana seçenek vardır ve bunlar farklı ürünlere erişir.

NotebookLM CLI: oturum açan, kaynak ekleyen ve sonuçları indiren terminal komutları

notebooklm-py'den Gelen notebooklm Komutu

notebooklm-py kurulumu, tüketici uygulaması için bir notebooklm komutu da yükler. Projenin kendi örnekleri bir oturumun yapısını gösterir:

notebooklm login
notebooklm create "My Research"
notebooklm source add "./paper.pdf"
notebooklm ask "What are the key themes?"
notebooklm generate audio "make it engaging" --wait
notebooklm download audio ./podcast.m4a

Bu, tam bir döngüyü betik hâline getirmek için yeterlidir: bir not defteri oluşturun, kaynaklar ekleyin, sorular sorun, bir Sesli Genel Bakış oluşturun ve kaydedin.

Enterprise API için nblm

Kuruluşunuz NotebookLM Enterprise kullanıyorsa nblm, yalnızca Enterprise API'yi hedefleyen bir NotebookLM CLI'dir. Rust çekirdeğine, bir komut satırı aracına ve PyPI'da yayımlanan bir Python SDK'sına sahip, resmi olmayan bir istemcidir. gcloud girişinizi yeniden kullanır; bu nedenle nblm notebooks create --title "My Notebook" veya nblm sources add --notebook-id YOUR_NOTEBOOK_ID --web-url "https://example.com" --web-name "Example" gibi bir komut, yukarıda açıklanan resmi REST yöntemleriyle doğrudan eşleşir.

İşinize Hangi NotebookLM Otomasyon Yolu Uygun?

Yolu, not defterlerinizin nerede bulunduğuna ve otomasyonu kimin çalıştıracağına göre seçin:

DurumunuzEn uygun seçenekNedeni
Şirketiniz NotebookLM Enterprise kullanıyorNotebookLM Enterprise API veya onun üzerinde çalışan nblmResmî ve belgelenmiş NotebookLM API yöntemleri
Kişisel not defterleri, Python ile betiklenmişnotebooklm-pyTüketici uygulamasının en geniş kapsamı
Kişisel not defterleri, bir yapay zekâ aracısı tarafından yönetiliyorBir NotebookLM MCP sunucusuAracı, konuşma sırasında NotebookLM’i bir araç olarak çağırır
Kişisel not defterleri, kabuk betiklerinotebooklm CLIAynı kitaplık; yazılacak Python kodu yok

Asıl sorunuz NotebookLM’in doğru araç olup olmadığıysa, NotebookLM alternatifleri rehberimizde onu ChatGPT, Claude, Gemini ve not uygulamalarıyla karşılaştırın. Bu makale otomasyona odaklanıyor.

Eksik Adım: Önce Videoyu Metne Dönüştürmek

Yukarıdaki her NotebookLM API rotası, bir not defterinin içinde gerçekleşen işlemleri otomatikleştirir. Ancak hiçbiri video kaynaklarıyla ilgili en yaygın sorunu çözmez: Öncelikle videolardan eksiksiz ve güvenilir metin elde etmek.

NotebookLM’nin kendi YouTube içe aktarma özelliği, yalnızca herkese açık bir videonun altyazı metnini okur. Her bağlantı bir kaynak hâline gelir ve oynatma listesi veya kanal bağlantısı videolarına genişletilmez. videoContent tek bir youtubeUrl kabul ettiğinden Enterprise API de aynı şekilde çalışır. Bu nedenle altyazısı olmayan bir video, 60 videoluk bir kurs veya bir içerik üreticisinin tüm arşivi, not defterinden önce tamamlanması gereken bir adım gerektirir. YouTube videolarını NotebookLM’de kullanma rehberimiz, bu içe aktarma kurallarını ve geçici çözümlerini ayrıntılı olarak ele alır.

Bu adımın otomatikleştirilmiş hâli Transcript.im API’sidir: bir video, oynatma listesi veya kanal gönderir, karşılığında metin alır ve metni seçtiğiniz not defteri rotasına iletirsiniz. Metin kaynakları bir not defterinde de daha iyi çalışır. İlgili transcript’leri tek bir dosyada birleştirebilir, başlıklar ekleyebilir ve tek bir kaynak alanında çok sayıda videoyu tutabilirsiniz.

Transcript.im API ile YouTube Transkriptlerini Otomatikleştirme

Transcript.im API, herkese açık bir video veya ses bağlantısını zaman damgalı bir transkripte dönüştüren bir REST API'dir. Web sitesindeki YouTube transkripti aracının kullandığı çıkarma işlem hattının aynısıdır: önce içerik üreticisinin altyazıları kullanılır; video altyazı içermiyorsa konuşulan ses AI tarafından yazıya dökülür. YouTube'un yanı sıra TikTok, Instagram, LinkedIn ve Twitter/X bağlantılarını da algılar; tüm sözleşme, Transcript.im API belgeleri sayfasında OpenAPI belgesi olarak yayımlanmıştır.

YouTube Transcript API: zaman damgalarıyla JSON olarak döndürülen bir video bağlantısı

Bir YouTube transkript API'si olarak, bir notebook projesinin genellikle ihtiyaç duyduğu üç biçimi destekler: tek video, tek oynatma listesi ve tek kanal. Kimlik doğrulama, Bearer token veya X-API-Key başlığı olarak gönderilen bir API anahtarıyla yapılır. Aşağıdaki örneklerde yer tutucu olarak YOUR_API_KEY kullanılmıştır.

Tek Video Getirme

Video URL'sini POST /v1/transcript adresine gönderin. format, zaman damgalı segmentler için json veya düz metin için text değeridir; language ise en veya de,en gibi bir öncelik listesidir.

curl -X POST https://api.transcript.im/v1/transcript \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=VIDEO_ID", "format": "text", "language": "en"}'

Eşleşen bir altyazı parçasına sahip video, yanıt içinde döndürülür. Altyazısı olmayan bir video ise 202 ve bunun yerine bir iş kimliği döndürür; çünkü AI transkripsiyonu eşzamansız olarak çalışır. İş başarılı olana veya başarısız olana kadar GET /v1/transcript/job/{id} adresini yoklayın ya da ilerleme durumunu görmek için /events akışına abone olun. Yalnızca bir videonun öncelikle neler sunduğunu öğrenmek istiyorsanız, GET /v1/transcript/info herhangi bir çıkarma yapmadan önce sunabileceği dilleri listeler.

Tüm Oynatma Listesini veya Kanalı Getirme

POST /v1/batch, URL'ler, oynatma listesi veya kanal listesini kabul eder. Gövdenin yapısı modu belirler: urls, playlist (bir ID veya URL) ya da channel (bir ID, @handle veya URL).

curl -X POST https://api.transcript.im/v1/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"playlist": "https://www.youtube.com/playlist?list=PLAYLIST_ID", "language": "auto"}'

Yanıt, toplam, bekleyen, başarılı ve başarısız öğelerin sayılarıyla birlikte bir toplu işlem kimliği içerir. Başarısız bir video kendi başına işaretlenir ve diğerlerini asla silmez; başarısız öğeler /retry ile yeniden denenebilir. Aynı işler, YouTube oynatma listesi transkripti ve YouTube kanal transkripti araçlarında kod yazmadan da kullanılabilir.

Sonuçları Yoklama ve Dışa Aktarma

İlerleme durumunu GET /v1/batch/{batchId} ile okuyun ve kalan öğeler için döndürülen sayfa token'ını takip edin. Toplu işlem tamamlandığında, /export adresinden txt, csv, json, srt, vtt veya zip olarak indirin:

curl -L -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.transcript.im/v1/batch/BATCH_ID/export?format=txt" -o playlist.txt

Hesabınızın Kitaplığına kaydedilen tek bir transkript de Markdown (md) olarak indirilebilir; bu biçim NotebookLM için temiz bir başlık korur. Buradan metin, notebook'a elle, notebooklm-py aracılığıyla veya Enterprise API'nin textContent kaynakları üzerinden aktarılabilir.

Agent’ınıza Transcript.im MCP Server ile Transkriptler Sağlama

Arayan bir komut dosyası yerine bir AI agent ise, Transcript.im MCP server ona aynı transkriptleri araçlar olarak sunar. Bu, https://mcp.transcript.im/mcp adresinde bulunan uzak bir HTTP uç noktasıdır; yüklemeniz gereken hiçbir şey yoktur: bir MCP istemcisinin URL’ye ve API anahtarına ihtiyacı vardır.

Transcript.im MCP Server: oynatma listesi ve kanal videoları, bir AI agent için zaman damgalı transkripte dönüştürülüyor

Transcript.im MCP Server’a Bağlanma

Claude Code’da Transcript.im MCP server’ı komut satırından kaydedin:

claude mcp add --transport http transcript https://mcp.transcript.im/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

mcpServers yapılandırmasını okuyabilen Cursor gibi editörler aynı URL’yi ve anahtarı kullanır:

{
  "mcpServers": {
    "transcript": {
      "url": "https://mcp.transcript.im/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude bunu özel bir bağlayıcı olarak, ChatGPT API anahtarı kimlik doğrulamalı bir MCP bağlayıcısı olarak, OpenAI Agent Builder ise Bearer kimlik bilgisine sahip bir MCP aracı olarak da ekleyebilir. Anahtar Authorization: Bearer veya x-api-key olarak gönderilebilir ve server bunu REST API’ye iletir; böylece agent, komut dosyalarınızla aynı hesapla çalışır.

Agent’ınızın Elde Ettiği Araçlar

Transcript.im MCP server on bir araç yayımlar:

  • Transkriptler: get_transcript, bir URL’den transkript çıkarır veya uzun bir transkriptin sonraki parçasını okur; get_transcript_info, bir videonun meta verilerini ve kullanılabilir altyazı parçalarını döndürür.
  • Toplu işlemler ve dışa aktarmalar: create_batch, bir URL listesinden, oynatma listesinden veya kanaldan bir işlem başlatır; get_batch, durumu, sayımları ve öğelerin sonraki sayfasını bildirir; export_batch, tamamlanmış bir toplu işlemi metne veya altyazılara dönüştürür.
  • YouTube keşfi: search_video, get_channel, list_channel_video, list_playlist_item ve list_caption, videoları bulur, kanalları çözümler, yüklemeler ve oynatma listelerinde gezinir ve altyazı meta verilerini okur.
  • Hesap: get_usage, hesabın kullanım özetini bildirir.

Server’ın kendine ait AI araçları yoktur. Modeli zaten istemciniz çalıştırır; bu nedenle server veriye odaklanır ve özetleme ile yeniden yazma işlerini agent’a bırakır.

Uzun Transkriptler Yönetilebilir Kalır

İki saatlik bir kayıt, bir agent’ın tek bir araç sonucunda alması gerekenden daha fazla metin üretir. Server, uzun transkriptleri sınırlandırılmış parçalar hâlinde döndürür: her parça truncated: true ve bir nextPageToken taşır; agent sonraki parça için bu token ile get_transcript çağrısını yeniden yapar. Hatalar; okunabilir metin, bir code, bir HTTP status ve dil eksik olduğunda availableLanguages ile döner; böylece agent körü körüne yeniden denemek yerine sonraki adımını seçebilir.

YouTube'dan Notebook'a Üç Pipeline

Parçaları bir araya getirdiğinizde birkaç tekrarlanabilir pipeline elde edersiniz. Her biri transcript'lerle başlar ve bir notebook ya da agent ile sona erer.

Pipeline 1: Bir Kanalı Consumer App'e Aktarma

Bir kanal grubunu Transcript.im API üzerinden çalıştırın, sonucu metin olarak dışa aktarın ve transcript'leri konuya göre gruplandırılmış, her videonun başlığının başlık olarak kullanıldığı birkaç dosyada birleştirin. Bu dosyaları NotebookLM'e manuel olarak veya notebooklm source add ile yükleyin. Birleştirme önemlidir çünkü NotebookLM kelimeleri değil, kaynakları sayar; NotebookLM'in ücretsiz olup olmadığına dair rehberimiz, her plandaki kaynak sınırlarını ve birleştirmenin büyük bir kanalı bu sınırlar içinde tutmaya nasıl yardımcı olduğunu açıklar.

Pipeline 2: Bir Oynatma Listesini NotebookLM Enterprise'a Aktarma

Bir şirket notebook'u için notebook'u notebooks.create ile oluşturun, oynatma listesini POST /v1/batch üzerinden çalıştırın ve her transcript'i, sourceName alanı video başlığı olan bir textContent girdisi olarak sources.batchCreate'e gönderin. Herhangi bir dilde yazılmış kısa bir script bunu uçtan uca gerçekleştirebilir; her iki taraf da basit REST API'leri olduğundan, yeni videolar geldiğinde notebook'u yenileyen zamanlanmış bir işe kolayca uyarlanabilir.

Pipeline 3: İki MCP Sunucusuna Sahip Bir Agent

Transcript.im MCP sunucusunu ve bir NotebookLM MCP sunucusunu aynı agent'a bağlayın. Ardından tek bir istek tüm döngüyü kapsayabilir: "Bu kanaldaki son 20 yüklemeyi listele, transcript'lerini al, araştırma notebook'uma ekle ve notebook'a hangi konuların en sık ortaya çıktığını sor." Agent bir sunucuda list_channel_video ve get_transcript çağrılarını yapar, ardından diğer sunucudaki notebook araçlarını kullanır. Kaynaklar eklendikten sonra bir notebook içinde çalışmaya yeni başlıyorsanız, NotebookLM'in nasıl kullanılacağına dair eğitimimiz kaynakları, sohbeti ve Studio'yu adım adım ele alır.

SSS

Resmî bir NotebookLM API'si var mı?

Evet, resmî NotebookLM API'si Google Cloud'daki NotebookLM Enterprise API'sidir. Bu, bir kuruluşun cloud projesindeki not defterleri, kaynaklar, paylaşım ve Sesli Genel Bakışlar için kullanılan bir önizleme REST API'sidir. Google, kişisel Google hesaplarıyla kullanılan tüketici uygulaması için bir geliştirici API'si yayımlamamıştır.

NotebookLM API'sini ücretsiz bir Google hesabıyla kullanabilir miyim?

Hayır, NotebookLM Enterprise API yalnızca bir Google Cloud projesindeki NotebookLM Enterprise not defterleriyle çalışır. Kişisel hesaptaki not defterleri için notebooklm-py veya topluluk tarafından geliştirilmiş bir MCP sunucusu gibi resmî olmayan araçlar kullanılabilir.

NotebookLM Enterprise API nedir?

NotebookLM Enterprise API, Google'ın Discovery Engine hizmetindeki v1alpha REST yöntemleri kümesidir. Google Cloud IAM rolleri tarafından kontrol edilen erişimle not defterleri oluşturabilir, alabilir, listeleyebilir, silebilir ve paylaşabilir; kaynak ekleyip kaldırabilir ve bir Sesli Genel Bakış oluşturabilir.

NotebookLM MCP sunucusu nedir?

NotebookLM MCP sunucusu, bir not defterine soru sormak veya kaynak eklemek gibi NotebookLM eylemlerini, bir AI aracısının Model Context Protocol üzerinden çağırabileceği araçlar olarak sunan bir programdır. Günümüzde mevcut NotebookLM MCP sunucuları topluluk projeleridir, Google ürünleri değildir.

notebooklm-py resmî mi?

Hayır, notebooklm-py resmî olmayan bir topluluk kütüphanesidir. GitHub sayfasında Google ile bağlantılı olmadığı ve önceden haber verilmeksizin değişebilecek belgelenmemiş Google API'lerini kullandığı belirtilir.

Bir NotebookLM CLI var mı?

Evet, ancak Google tarafından sunulmuyor. notebooklm-py ile gelen notebooklm komutu tüketici uygulamasıyla çalışır; nblm ise gcloud üzerinden oturum açan, Enterprise API için geliştirilmiş resmî olmayan bir NotebookLM CLI'sidir.

NotebookLM API bir YouTube oynatma listesini içe aktarabilir mi?

Hayır, NotebookLM Enterprise API YouTube videolarını videoContent üzerinden tek tek, tek bir youtubeUrl kullanarak ekler ve yalnızca altyazı metnini içe aktarır. Bir oynatma listesinin veya kanalın tamamını eklemek için önce Transcript.im API ile transkriptleri alın ve bunları metin kaynakları olarak ekleyin.

YouTube transkriptlerini NotebookLM'e otomatik olarak nasıl aktarırım?

Bir video, oynatma listesi veya kanalın transkriptlerini almak için Transcript.im API'sini veya Transcript.im MCP sunucusunu kullanın; ardından metni yükleme yoluyla, notebooklm-py ile ya da Enterprise API'nin textContent kaynaklarıyla bir not defterine ekleyin.

Sonuç

Tek resmi NotebookLM API’si Google Cloud’daki NotebookLM Enterprise API’sidir ve hâlâ önizleme aşamasındadır. Kişisel not defterleri için notebooklm-py, notebooklm CLI’si ve topluluk tarafından geliştirilen NotebookLM MCP sunucuları bu boşluğu doldurur; ancak bunların belgelenmemiş erişime dayandığını ve Google uygulamada değişiklik yaptığında çalışmayabileceğini unutmamak gerekir.

Hangi yolu seçerseniz seçin, not defteriniz yalnızca kaynakları kadar iyidir. Video söz konusu olduğunda bu, önce eksiksiz metin anlamına gelir: Transcript.im API’si veya MCP sunucusuyla tek videolar, oynatma listeleri ve kanallar için transcript’leri alın, bunları iyi adlandırılmış birkaç kaynakta gruplayın ve okumayı NotebookLM’e veya ajansınıza bırakın.

Transkript Oluşturucu

Her Videoyu Metne Dönüştürün

Bir YouTube, TikTok veya Instagram bağlantısı yapıştırın ve her satırda zaman damgasıyla transkripti okuyun.

TXT, SRT veya VTT olarak dışa aktarılır.