Claude Code için NotebookLM Ajan Yeteneği

NotebookLM Claude Code Becerisi

Claude Code'un, yalnızca yüklediğiniz belgelere dayalı, kaynak temelli yanıtlar almak için NotebookLM ile doğrudan sohbet etmesini sağlayın

Bu beceriyi, Gemini'den kaynak temelli ve alıntılı yanıtlar almak için Google NotebookLM not defterlerinizi doğrudan Claude Code'dan sorgulamak için kullanın. Tarayıcı otomasyonu, kütüphane yönetimi, kalıcı kimlik doğrulama. Halüsinasyonlar büyük ölçüde azaltıldı - yanıtlar yalnızca yüklediğiniz belgelerden.

Kurulum • Hızlı Başlangıç • Neden NotebookLM • Nasıl Çalışır • MCP Alternatifi

⚠️ Önemli: Yalnızca Yerel Claude Code

Bu beceri YALNIZCA yerel Claude Code kurulumlarıyla çalışır, web arayüzünde DEĞİL.

Web arayüzü becerileri ağ erişimi olmayan bir korumalı alanda çalıştırır, bu beceri tarayıcı otomasyonu için ağ erişimi gerektirir. Makinenizde Claude Code'u yerel olarak kullanmalısınız.

Sorun

Claude Code'a "yerel dokümantasyonumda ara" dediğinizde şunlar olur:

• Büyük token tüketimi: Dokümantasyonda arama yapmak, birden çok dosyayı tekrar tekrar okumak anlamına gelir
• Yanlış getiri: Anahtar kelimeleri arar, bağlamı ve belgeler arası bağlantıları kaçırır
• Halüsinasyonlar: Bir şey bulamadığında, kulağa mantıklı gelen API'ler uydurur
• Manuel kopyala-yapıştır: NotebookLM tarayıcısı ve editörünüz arasında sürekli geçiş yapma

Çözüm

Bu Claude Code Becerisi, Claude Code'un, Gemini 2.5 tarafından desteklenen ve yalnızca yüklediğiniz belgelerden akıllı, sentezlenmiş yanıtlar sağlayan Google'ın kaynak temelli bilgi tabanı NotebookLM ile doğrudan sohbet etmesini sağlar.

Göreviniz → Claude NotebookLM'e sorar → Gemini yanıtı sentezler → Claude doğru kodu yazar

Artık kopyala-yapıştır dansı yok: Claude doğrudan sorular sorar ve yanıtları doğrudan CLI'da alır. Otomatik takiplerle derin anlayış oluşturur, belirli uygulama ayrıntılarını, uç durumları ve en iyi uygulamaları alır.

Neden NotebookLM, Yerel RAG Değil?

NotebookLM'i Üstün Kılan Nedir?

1. Gemini tarafından önceden işlenmiş: Belgeleri bir kez yükleyin, anında uzman bilgisi edinin
2. Doğal dil soru-cevap: Sadece getiri değil — gerçek anlayış ve sentez
3. Çok kaynaklı ilişkilendirme: 50'den fazla belge arasında bilgi bağlantısı kurar
4. Alıntı destekli: Her yanıt kaynak referansları içerir
5. Altyapı gerektirmez: Vektör veritabanları, gömmeler veya parçalama stratejilerine gerek yok

Kurulum

Şimdiye kadarki en basit kurulum:

# 1. Beceriler dizinini oluşturun (yoksa)
mkdir -p ~/.claude/skills

# 2. Bu depoyu klonlayın
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

# 3. Hepsi bu kadar! Claude Code'u açın ve şunu söyleyin:
"Becerilerim neler?"

Beceriyi ilk kullandığınızda, otomatik olarak:

• İzole bir Python ortamı oluşturur (.venv)
• Google Chrome dahil tüm bağımlılıkları yükler
• Maksimum güvenilirlik için Chrome (Chromium değil) ile tarayıcı otomasyonunu kurar
• Her şey beceri klasöründe kalır

Not: Kurulum, platformlar arası güvenilirlik, tutarlı tarayıcı parmak izi ve Google hizmetleriyle daha iyi tespit önleme için Chromium yerine gerçek Chrome kullanır

Hızlı Başlangıç

1. Becerilerinizi kontrol edin

Claude Code'da şunu söyleyin:

"Becerilerim neler?"

Claude, NotebookLM dahil mevcut becerilerinizi listeleyecektir.

2. Google ile kimlik doğrulayın (tek seferlik)

"NotebookLM kimlik doğrulamasını ayarla"

Bir Chrome penceresi açılır → Google hesabınızla oturum açın

3. Bilgi tabanınızı oluşturun

notebooklm.google.com adresine gidin → Not defteri oluşturun → Belgelerinizi yükleyin:

• 📄 PDF'ler, Google Dokümanlar, markdown dosyaları
• 🔗 Web siteleri, GitHub depoları
• 🎥 YouTube videoları
• 📚 Not defteri başına birden çok kaynak

Paylaş: ⚙️ Paylaş → Bağlantıya sahip herkes → Kopyala

4. Kütüphanenize ekleyin

Seçenek A: Claude'un çözmesine izin verin (Akıllı Ekleme)

"Bu not defterini içeriği hakkında sorgula ve kütüphaneme ekle: [bağlantınız]"

Claude, içeriğini keşfetmek için not defterini otomatik olarak sorgulayacak, ardından uygun meta verilerle ekleyecektir.

Seçenek B: Manuel ekleme

"Bu NotebookLM'yi kütüphaneme ekle: [bağlantınız]"

Claude bir isim ve konular isteyecek, ardından daha sonra kullanmak üzere kaydedecektir.

5. Araştırmaya başlayın

"React dokümanlarım hook'lar hakkında ne diyor?"

Claude otomatik olarak doğru not defterini seçer ve yanıtı doğrudan NotebookLM'den alır.

Nasıl Çalışır

Bu bir Claude Code Becerisi'dir - Claude Code'un gerektiğinde kullanabileceği talimatlar ve betikler içeren yerel bir klasör. MCP sunucu sürümünün aksine, bu ayrı bir sunucuya ihtiyaç duymadan doğrudan Claude Code'da çalışır.

MCP Sunucusundan Temel Farklar

Mimari

~/.claude/skills/notebooklm/
├── SKILL.md              # Claude için talimatlar
├── scripts/              # Python otomasyon betikleri
│   ├── ask_question.py   # NotebookLM'i sorgula
│   ├── notebook_manager.py # Kütüphane yönetimi
│   └── auth_manager.py   # Google kimlik doğrulaması
├── .venv/                # İzole Python ortamı (otomatik oluşturulur)
└── data/                 # Yerel not defteri kütüphanesi

NotebookLM'den bahsettiğinizde veya bir not defteri URL'si gönderdiğinizde, Claude:

1. Beceri talimatlarını yükler
2. Uygun Python betiğini çalıştırır
3. Bir tarayıcı açar, sorunuzu sorar
4. Yanıtı doğrudan size döndürür
5. Görevinize yardımcı olmak için bu bilgiyi kullanır

Temel Özellikler

Kaynak Temelli Yanıtlar

NotebookLM, yalnızca yüklediğiniz belgelere dayanarak yanıtlayarak halüsinasyonları önemli ölçüde azaltır. Bilgi mevcut değilse, içerik uydurmak yerine belirsizliği belirtir.

Doğrudan Entegrasyon

Tarayıcı ve editör arasında kopyala-yapıştır yok. Claude soruları programlı olarak sorar ve yanıtları alır.

Akıllı Kütüphane Yönetimi

NotebookLM bağlantılarını etiketler ve açıklamalarla kaydedin. Claude, göreviniz için doğru not defterini otomatik olarak seçer.

Otomatik Kimlik Doğrulama

Tek seferlik Google oturumu, ardından kimlik doğrulama oturumlar arasında kalıcıdır.

Kendi Kendine Yeterli

Her şey, izole bir Python ortamına sahip beceri klasöründe çalışır. Genel kurulumlar yok.

İnsan Benzeri Otomasyon

Tespit edilmeyi önlemek için gerçekçi yazma hızları ve etkileşim desenleri kullanır.

Yaygın Komutlar

Gerçek Dünya Örnekleri

Örnek 1: Atölye Kılavuzu Sorgusu

Kullanıcı sorar: "Suzuki GSR 600 atölye kılavuzumda fren hidroliği türü, motor yağı özellikleri ve arka aks torkunu kontrol et."

Claude otomatik olarak:

• NotebookLM ile kimlik doğrular
• Her özellik hakkında kapsamlı sorular sorar
• "Bilmeniz gereken HER ŞEY bu mu?" diye sorulduğunda takip eder
• Doğru özellikleri sağlar: DOT 4 fren hidroliği, SAE 10W-40 yağ, 100 N·m arka aks torku

Örnek 2: Halüsinasyon Olmadan Oluşturma

Siz: "Gmail spam filtrelemesi için bir n8n iş akışı oluşturmam gerekiyor. n8n not defterimi kullan."

Claude'un iç süreci:

→ NotebookLM becerisini yükler
→ n8n not defterini etkinleştirir
→ Takip içeren kapsamlı sorular sorar
→ Birden çok sorgudan tam yanıtı sentezler

Sonuç: İlk denemede çalışan iş akışı, halüsinasyonlu API'lerde hata ayıklama yok.

Teknik Detaylar

Temel Teknoloji

• Patchright: Tarayıcı otomasyon kütüphanesi (Playwright tabanlı)
• Python: Bu beceri için uygulama dili
• Gizlilik teknikleri: İnsan benzeri yazma ve etkileşim desenleri

Not: MCP sunucusu aynı Patchright kütüphanesini kullanır ancak TypeScript/npm ekosistemi aracılığıyla.

Bağımlılıklar

• patchright==1.55.2: Tarayıcı otomasyonu
• python-dotenv==1.0.0: Ortam yapılandırması
• İlk kullanımda otomatik olarak .venv içine kurulur

Veri Depolama

Tüm veriler beceri dizini içinde yerel olarak depolanır:

~/.claude/skills/notebooklm/data/
├── library.json       - Meta verili not defteri kütüphaneniz
├── auth_info.json     - Kimlik doğrulama durum bilgisi
└── browser_state/     - Tarayıcı çerezleri ve oturum verileri

Önemli Güvenlik Notu:

• data/ dizini hassas kimlik doğrulama verileri ve kişisel not defterleri içerir
• .gitignore aracılığıyla git'ten otomatik olarak hariç tutulur
• data/ dizininin içeriğini ASLA manuel olarak commit etmeyin veya paylaşmayın

Oturum Modeli

MCP sunucusunun aksine, bu beceri durumsuz bir model kullanır:

• Her soru yeni bir tarayıcı açar
• Soruyu sorar, yanıtı alır
• Claude'u daha fazla soru sormaya teşvik etmek için bir takip istemi ekler
• Tarayıcıyı hemen kapatır

Bu şu anlama gelir:

• Kalıcı sohbet bağlamı yok
• Her soru bağımsızdır
• Ancak not defteri kütüphaneniz kalıcıdır
• Takip mekanizması: Her yanıt, Claude'u kapsamlı takipler sormaya yönlendirmek için "Bilmeniz gereken HER ŞEY bu mu?" içerir

Çok adımlı araştırmalar için Claude gerektiğinde otomatik olarak takip soruları sorar.

Sınırlamalar

Beceriye Özgü

• Yalnızca yerel Claude Code - Web arayüzünde çalışmaz (korumalı alan kısıtlamaları)
• Oturum kalıcılığı yok - Her soru bağımsızdır
• Takip bağlamı yok - "Önceki yanıt"a atıfta bulunamaz

NotebookLM

• Hız sınırlamaları - Ücretsiz katmanda günlük sorgu limitleri vardır
• Manuel yükleme - Belgelerinizi önce NotebookLM'e yüklemelisiniz
• Paylaşım gereksinimi - Not defterleri herkese açık olarak paylaşılmalıdır

SSS

Bu neden Claude web arayüzünde çalışmıyor? Web arayüzü becerileri ağ erişimi olmayan bir korumalı alanda çalıştırır. Tarayıcı otomasyonu NotebookLM'e ulaşmak için ağ erişimi gerektirir.

Bunun MCP sunucusundan farkı nedir? Bu, doğrudan bir Claude Becerisi olarak çalışan daha basit, Python tabanlı bir uygulamadır. MCP sunucusu kalıcı oturumlarla daha zengin özelliklere sahiptir ve birden çok araçla (Codex, Cursor, vb.) çalışır.

Hem bu beceriyi hem de MCP sunucusunu kullanabilir miyim? Evet! Farklı amaçlara hizmet ederler. Hızlı Claude Code entegrasyonu için beceriyi, kalıcı oturumlar ve çok araçlı destek için MCP sunucusunu kullanın.

Chrome çökerse ne olur? Şunu çalıştırın: "NotebookLM tarayıcı verilerini temizle" ve tekrar deneyin.

Google hesabım güvende mi? Chrome makinenizde yerel olarak çalışır. Kimlik bilgileriniz asla bilgisayarınızdan ayrılmaz. Endişeleriniz varsa özel bir Google hesabı kullanın.

Sorun Giderme

Beceri bulunamadı

# Doğru konumda olduğundan emin olun
ls ~/.claude/skills/notebooklm/
# Şunları göstermeli: SKILL.md, scripts/, vb.

Kimlik doğrulama sorunları

Şunu söyleyin: "NotebookLM kimlik doğrulamasını sıfırla"

Tarayıcı çökmesi

Şunu söyleyin: "NotebookLM tarayıcı verilerini temizle"

Bağımlılık sorunları

# Gerekirse manuel yeniden kurulum
cd ~/.claude/skills/notebooklm
rm -rf .venv
python -m venv .venv
source .venv/bin/activate  # veya Windows'ta .venv\Scripts\activate
pip install -r requirements.txt

Feragatname

Bu araç, iş akışınızı daha verimli hale getirmek için NotebookLM ile tarayıcı etkileşimlerini otomatikleştirir. Ancak, birkaç dostça hatırlatma:

Tarayıcı otomasyonu hakkında: Otomasyonun daha doğal davranması için insanlaştırma özellikleri (gerçekçi yazma hızları, doğal gecikmeler, fare hareketleri) eklemiş olsam da, Google'ın otomatik kullanımı tespit etmeyeceğini veya işaretlemeyeceğini garanti edemem. Ana hesabınız yerine otomasyon için özel bir Google hesabı kullanmanızı öneririm—bunu web kazıma gibi düşünün: muhtemelen sorun olmaz, ama tedbirli olmak pişman olmaktan iyidir!

CLI araçları ve AI ajanları hakkında: Claude Code, Codex ve benzeri AI destekli asistanlar inanılmaz derecede güçlüdür, ancak hata yapabilirler. Lütfen onları dikkatli ve farkında olarak kullanın:

• Commit etmeden veya dağıtmadan önce her zaman değişiklikleri gözden geçirin
• Önce güvenli ortamlarda test edin
• Önemli işlerin yedeklerini alın
• Unutmayın: AI ajanları asistanlardır, yanılmaz kahinler değil

Bu aracı, NotebookLM ve editörüm arasındaki kopyala-yapıştır dansından bıktığım için kendim için oluşturdum. Başkalarına da yardımcı olması umuduyla paylaşıyorum, ancak oluşabilecek sorunlar, veri kaybı veya hesap problemleri için sorumluluk alamam. Kendi takdirinize ve muhakemenize göre kullanın.

Bununla birlikte, sorunlarla karşılaşırsanız veya sorularınız varsa, GitHub'da bir konu açmaktan çekinmeyin. Sorun gidermeye yardımcı olmaktan mutluluk duyarım!

Katkıda Bulunanlar

Bu beceri, NotebookLM MCP Sunucumdan esinlenmiştir ve bir Claude Code Becerisi olarak alternatif bir uygulama sunar:

• Her ikisi de tarayıcı otomasyonu için Patchright kullanır (MCP için TypeScript, Beceri için Python)
• Beceri sürümü, MCP protokolü olmadan doğrudan Claude Code'da çalışır
• Beceri mimarisi için optimize edilmiş durumsuz tasarım

İhtiyacınız varsa:

• Kalıcı oturumlar → MCP Sunucusunu kullanın
• Çoklu araç desteği (Codex, Cursor) → MCP Sunucusunu kullanın
• Hızlı Claude Code entegrasyonu → Bu beceriyi kullanın

Sonuç

Bu beceri olmadan: NotebookLM tarayıcıda → Yanıtı kopyala → Claude'a yapıştır → Sonraki soruyu kopyala → Tarayıcıya geri dön...

Bu beceriyle: Claude doğrudan araştırır → Yanıtları anında alır → Doğru kodu yazar

Kopyala-yapıştır dansını durdurun. Claude Code'da doğrudan doğru, temelli yanıtlar almaya başlayın.

# 30 saniyede başlayın
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# Claude Code'u açın: "Becerilerim neler?"

NotebookLM MCP Sunucumun bir Claude Code Becerisi uyarlaması olarak oluşturuldu

Claude Code'da doğrudan kaynak temelli, belgeye dayalı araştırma için