Skill Agen NotebookLM untuk Claude Code

Keterampilan Kode Claude Buku Catatan LM

Biarkan Kode Claude mengobrol langsung dengan Buku Catatan LM untuk jawaban berbasis sumber yang hanya didasarkan pada dokumen yang Anda unggah

Gunakan keterampilan ini untuk menanyakan buku catatan Buku Catatan LM Google Anda langsung dari Kode Claude untuk jawaban berbasis sumber yang didukung kutipan dari Gemini. Otomatisasi peramban, manajemen pustaka, autentikasi persisten. Halusinasi berkurang drastis - jawaban hanya dari dokumen yang Anda unggah.

Instalasi • Mulai Cepat • Mengapa Buku Catatan LM • Cara Kerjanya • Alternatif MCP

⚠️ Penting: Hanya Kode Claude Lokal

Keterampilan ini HANYA berfungsi dengan instalasi Kode Claude lokal, BUKAN di UI web.

UI web menjalankan keterampilan di dalam sandbox tanpa akses jaringan, yang diperlukan keterampilan ini untuk otomatisasi peramban. Anda harus menggunakan Kode Claude secara lokal di mesin Anda.

Masalah

Saat Anda memberi tahu Kode Claude untuk "cari di dokumentasi lokal saya", inilah yang terjadi:

• Konsumsi token besar-besaran: Mencari di dokumentasi berarti membaca banyak file berulang kali
• Pengambilan tidak akurat: Mencari kata kunci, melewatkan konteks dan koneksi antar dokumen
• Halusinasi: Saat tidak dapat menemukan sesuatu, ia menciptakan API yang terdengar masuk akal
• Salin-tempel manual: Terus-menerus beralih antara peramban Buku Catatan LM dan editor Anda

Solusinya

Keterampilan Kode Claude ini memungkinkan Kode Claude mengobrol langsung dengan Buku Catatan LM — basis pengetahuan berbasis sumber Google yang didukung oleh Gemini 2.5 yang memberikan jawaban yang disintesis secara cerdas hanya dari dokumen yang Anda unggah.

Tugas Anda → Claude bertanya ke Buku Catatan LM → Gemini mensintesis jawaban → Claude menulis kode yang benar

Tidak ada lagi tarian salin-tempel: Claude mengajukan pertanyaan langsung dan mendapat jawaban langsung kembali di CLI. Ini membangun pemahaman mendalam melalui tindak lanjut otomatis, mendapatkan rincian implementasi spesifik, kasus tepi, dan praktik terbaik.

Mengapa Buku Catatan LM, Bukan RAG Lokal?

Apa yang Membuat Buku Catatan LM Unggul?

1. Diproses sebelumnya oleh Gemini: Unggah dokumen sekali, dapatkan pengetahuan ahli instan
2. Tanya jawab bahasa alami: Bukan hanya pengambilan — pemahaman dan sintesis yang sebenarnya
3. Korelasi multi-sumber: Menghubungkan informasi di 50+ dokumen
4. Didukung kutipan: Setiap jawaban menyertakan referensi sumber
5. Tidak ada infrastruktur: Tidak perlu basis data vektor, penyematan, atau strategi chunking

Instalasi

Instalasi paling sederhana yang pernah ada:

# 1. Buat direktori keterampilan (jika belum ada)
mkdir -p ~/.claude/keterampilan

# 2. Kloning repositori ini
cd ~/.claude/keterampilan
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

# 3. Itu saja! Buka Kode Claude dan katakan:
"Apa keterampilan saya?"

Saat pertama kali menggunakan keterampilan ini, secara otomatis:

• Membuat lingkungan Python terisolasi (.venv)
• Menginstal semua dependensi termasuk Google Chrome
• Menyiapkan otomatisasi peramban dengan Chrome (bukan Chromium) untuk keandalan maksimum
• Semuanya tetap berada di dalam folder keterampilan

Catatan: Pengaturan menggunakan Chrome asli alih-alih Chromium untuk keandalan lintas platform, sidik jari peramban yang konsisten, dan deteksi anti yang lebih baik dengan layanan Google

Mulai Cepat

1. Periksa keterampilan Anda

Katakan di Kode Claude:

"Keterampilan apa yang saya miliki?"

Claude akan mencantumkan keterampilan yang tersedia termasuk Buku Catatan LM.

2. Autentikasi dengan Google (satu kali)

"Siapkan autentikasi Buku Catatan LM"

Jendela Chrome terbuka → masuk dengan akun Google Anda

3. Buat basis pengetahuan Anda

Buka notebooklm.google.com → Buat buku catatan → Unggah dokumen Anda:

• 📄 PDF, Google Docs, file markdown
• 🔗 Situs web, repositori GitHub
• 🎥 Video YouTube
• 📚 Beberapa sumber per buku catatan

Bagikan: ⚙️ Bagikan → Siapa pun yang memiliki tautan → Salin

4. Tambahkan ke pustaka Anda

Opsi A: Biarkan Claude yang mencari tahu (Tambah Cerdas)

"Tanyakan buku catatan ini tentang kontennya dan tambahkan ke pustaka saya: [tautan-anda]"

Claude akan secara otomatis menanyakan buku catatan untuk mengetahui kontennya, lalu menambahkannya dengan metadata yang sesuai.

Opsi B: Tambah manual

"Tambahkan Buku Catatan LM ini ke pustaka saya: [tautan-anda]"

Claude akan meminta nama dan topik, lalu menyimpannya untuk digunakan di masa mendatang.

5. Mulai meneliti

"Apa kata dokumen React saya tentang hooks?"

Claude secara otomatis memilih buku catatan yang tepat dan mendapatkan jawabannya langsung dari Buku Catatan LM.

Cara Kerjanya

Ini adalah Keterampilan Kode Claude - folder lokal yang berisi instruksi dan skrip yang dapat digunakan Kode Claude saat diperlukan. Tidak seperti versi server MCP, ini berjalan langsung di Kode Claude tanpa memerlukan server terpisah.

Perbedaan Utama dari Server MCP

Arsitektur

~/.claude/keterampilan/notebooklm/
├── SKILL.md              # Instruksi untuk Claude
├── scripts/              # Skrip otomatisasi Python
│   ├── ajukan_pertanyaan.py   # Menanyakan Buku Catatan LM
│   ├── manajer_notebook.py # Manajemen pustaka
│   └── manajer_auth.py   # Autentikasi Google
├── .venv/                # Lingkungan Python terisolasi (dibuat otomatis)
└── data/                 # Pustaka notebook lokal

Saat Anda menyebut Buku Catatan LM atau mengirim URL notebook, Claude:

1. Memuat instruksi keterampilan
2. Menjalankan skrip Python yang sesuai
3. Membuka peramban, mengajukan pertanyaan Anda
4. Mengembalikan jawaban langsung kepada Anda
5. Menggunakan pengetahuan itu untuk membantu tugas Anda

Fitur Inti

Respons Berbasis Sumber

Buku Catatan LM secara signifikan mengurangi halusinasi dengan menjawab secara eksklusif dari dokumen yang Anda unggah. Jika informasi tidak tersedia, ia menunjukkan ketidakpastian daripada menciptakan konten.

Integrasi Langsung

Tidak ada salin-tempel antara peramban dan editor. Claude mengajukan dan menerima jawaban secara terprogram.

Manajemen Pustaka Cerdas

Simpan tautan Buku Catatan LM dengan tag dan deskripsi. Claude memilih buku catatan yang tepat untuk tugas Anda secara otomatis.

Autentikasi Otomatis

Login Google satu kali, lalu autentikasi tetap ada di seluruh sesi.

Mandiri

Semuanya berjalan di folder keterampilan dengan lingkungan Python terisolasi. Tidak ada instalasi global.

Otomatisasi Mirip Manusia

Menggunakan kecepatan pengetikan dan pola interaksi realistis untuk menghindari deteksi.

Perintah Umum

Contoh Dunia Nyata

Contoh 1: Kueri Manual Bengkel

Pengguna bertanya: "Periksa manual bengkel Suzuki GSR 600 saya untuk jenis minyak rem, spesifikasi oli mesin, dan torsi as roda belakang."

Claude secara otomatis:

• Mengautentikasi dengan Buku Catatan LM
• Mengajukan pertanyaan komprehensif tentang setiap spesifikasi
• Menindaklanjuti saat diminta "Apakah itu SEMUA yang perlu Anda ketahui?"
• Memberikan spesifikasi akurat: minyak rem DOT 4, oli SAE 10W-40, torsi as roda belakang 100 N·m

Contoh 2: Membangun Tanpa Halusinasi

Anda: "Saya perlu membuat alur kerja n8n untuk penyaringan spam Gmail. Gunakan notebook n8n saya."

Proses internal Claude:

→ Memuat keterampilan Buku Catatan LM
→ Mengaktifkan notebook n8n
→ Mengajukan pertanyaan komprehensif dengan tindak lanjut
→ Mensintesis jawaban lengkap dari banyak kueri

Hasil: Alur kerja berfungsi pada percobaan pertama, tidak ada debugging API yang dihalusinasi.

Rincian Teknis

Teknologi Inti

• Patchright: Pustaka otomatisasi peramban (berbasis Playwright)
• Python: Bahasa implementasi untuk keterampilan ini
• Teknik siluman: Pola pengetikan dan interaksi seperti manusia

Catatan: Server MCP menggunakan pustaka Patchright yang sama tetapi melalui ekosistem TypeScript/npm.

Dependensi

• patchright==1.55.2: Otomatisasi peramban
• python-dotenv==1.0.0: Konfigurasi lingkungan
• Terinstal otomatis di .venv pada penggunaan pertama

Penyimpanan Data

Semua data disimpan secara lokal di dalam direktori keterampilan:

~/.claude/keterampilan/notebooklm/data/
├── library.json       - Pustaka notebook Anda dengan metadata
├── auth_info.json     - Informasi status autentikasi
└── browser_state/     - Cookie peramban dan data sesi

Catatan Keamanan Penting:

• Direktori data/ berisi data autentikasi sensitif dan notebook pribadi
• Secara otomatis dikecualikan dari git melalui .gitignore
• JANGAN PERNAH secara manual meng-commit atau membagikan isi direktori data/

Model Sesi

Tidak seperti server MCP, keterampilan ini menggunakan model stateless:

• Setiap pertanyaan membuka peramban baru
• Mengajukan pertanyaan, mendapatkan jawabannya
• Menambahkan prompt tindak lanjut untuk mendorong Claude mengajukan lebih banyak pertanyaan
• Menutup peramban segera

Ini berarti:

• Tidak ada konteks obrolan persisten
• Setiap pertanyaan independen
• Tetapi pustaka notebook Anda tetap ada
• Mekanisme tindak lanjut: Setiap jawaban menyertakan "Apakah itu SEMUA yang perlu Anda ketahui?" untuk mendorong Claude mengajukan tindak lanjut komprehensif

Untuk penelitian multi-langkah, Claude secara otomatis mengajukan pertanyaan tindak lanjut saat diperlukan.

Keterbatasan

Spesifik Keterampilan

• Hanya Kode Claude lokal - Tidak berfungsi di UI web (pembatasan sandbox)
• Tidak ada persistensi sesi - Setiap pertanyaan independen
• Tidak ada konteks tindak lanjut - Tidak dapat merujuk "jawaban sebelumnya"

Buku Catatan LM

• Batas laju - Tingkat gratis memiliki batas kueri harian
• Unggahan manual - Anda harus mengunggah dokumen ke Buku Catatan LM terlebih dahulu
• Persyaratan berbagi - Notebook harus dibagikan secara publik

Tanya Jawab

Mengapa ini tidak berfungsi di UI web Claude? UI web menjalankan keterampilan di sandbox tanpa akses jaringan. Otomatisasi peramban memerlukan akses jaringan untuk mencapai Buku Catatan LM.

Apa bedanya dengan server MCP? Ini adalah implementasi berbasis Python yang lebih sederhana yang berjalan langsung sebagai Keterampilan Claude. Server MCP lebih kaya fitur dengan sesi persisten dan bekerja dengan banyak alat (Codex, Cursor, dll.).

Bisakah saya menggunakan keterampilan ini dan server MCP sekaligus? Ya! Keduanya melayani tujuan yang berbeda. Gunakan keterampilan untuk integrasi cepat Kode Claude, gunakan server MCP untuk sesi persisten dan dukungan multi-alat.

Bagaimana jika Chrome mogok? Jalankan: "Hapus data peramban Buku Catatan LM" dan coba lagi.

Apakah akun Google saya aman? Chrome berjalan secara lokal di mesin Anda. Kredensial Anda tidak pernah meninggalkan komputer Anda. Gunakan akun Google khusus jika Anda khawatir.

Pemecahan Masalah

Keterampilan tidak ditemukan

# Pastikan ada di lokasi yang tepat
ls ~/.claude/keterampilan/notebooklm/
# Harus menampilkan: SKILL.md, scripts/, dll.

Masalah autentikasi

Katakan: "Reset autentikasi Buku Catatan LM"

Peramban mogok

Katakan: "Hapus data peramban Buku Catatan LM"

Masalah dependensi

# Instal ulang manual jika perlu
cd ~/.claude/keterampilan/notebooklm
rm -rf .venv
python -m venv .venv
source .venv/bin/activate  # atau .venv\Scripts\activate di Windows
pip install -r requirements.txt

Penafian

Alat ini mengotomatiskan interaksi peramban dengan Buku Catatan LM untuk membuat alur kerja Anda lebih efisien. Namun, beberapa pengingat ramah:

Tentang otomatisasi peramban: Meskipun saya telah membangun fitur humanisasi (kecepatan pengetikan realistis, jeda alami, gerakan mouse) untuk membuat otomatisasi berperilaku lebih alami, saya tidak dapat menjamin Google tidak akan mendeteksi atau menandai penggunaan otomatis. Saya sarankan menggunakan akun Google khusus untuk otomatisasi daripada akun utama Anda—anggap seperti web scraping: mungkin baik-baik saja, tetapi lebih baik aman daripada menyesal!

Tentang alat CLI dan agen AI: Alat CLI seperti Kode Claude, Codex, dan asisten bertenaga AI serupa sangat kuat, tetapi mereka dapat membuat kesalahan. Harap gunakan dengan hati-hati dan kesadaran:

• Selalu tinjau perubahan sebelum melakukan atau menerapkan
• Uji di lingkungan aman terlebih dahulu
• Simpan cadangan pekerjaan penting
• Ingat: Agen AI adalah asisten, bukan peramal yang sempurna

Saya membangun alat ini untuk diri saya sendiri karena saya bosan dengan tarian salin-tempel antara Buku Catatan LM dan editor saya. Saya membagikannya dengan harapan dapat membantu orang lain juga, tetapi saya tidak dapat bertanggung jawab atas masalah, kehilangan data, atau masalah akun yang mungkin terjadi. Gunakan dengan kebijaksanaan dan penilaian Anda sendiri.

Meskipun demikian, jika Anda mengalami masalah atau memiliki pertanyaan, jangan ragu untuk membuka masalah di GitHub. Saya senang membantu memecahkan masalah!

Kredit

Keterampilan ini terinspirasi oleh Server MCP Buku Catatan LM saya dan menyediakan implementasi alternatif sebagai Keterampilan Kode Claude:

• Keduanya menggunakan Patchright untuk otomatisasi peramban (TypeScript untuk MCP, Python untuk Keterampilan)
• Versi Keterampilan berjalan langsung di Kode Claude tanpa protokol MCP
• Desain stateless dioptimalkan untuk arsitektur keterampilan

Jika Anda membutuhkan:

• Sesi persisten → Gunakan Server MCP
• Dukungan multi-alat (Codex, Cursor) → Gunakan Server MCP
• Integrasi cepat Kode Claude → Gunakan keterampilan ini

Intinya

Tanpa keterampilan ini: Buku Catatan LM di peramban → Salin jawaban → Tempel di Claude → Salin pertanyaan berikutnya → Kembali ke peramban...

Dengan keterampilan ini: Claude meneliti langsung → Mendapat jawaban instan → Menulis kode yang benar

Hentikan tarian salin-tempel. Mulailah mendapatkan jawaban yang akurat dan berbasis langsung di Kode Claude.

# Mulai dalam 30 detik
cd ~/.claude/keterampilan
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# Buka Kode Claude: "Apa keterampilan saya?"

Dibangun sebagai adaptasi Keterampilan Kode Claude dari Server MCP Buku Catatan LM saya

Untuk penelitian berbasis sumber dan berbasis dokumen langsung di Kode Claude