Umiejętność agenta NotebookLM dla Claude Code

Umiejętność NotebookLM dla Claude Code

Pozwól Claude Code rozmawiać bezpośrednio z NotebookLM, aby uzyskać odpowiedzi oparte na źródłach, wyłącznie na podstawie przesłanych dokumentów

Użyj tej umiejętności, aby bezpośrednio z poziomu Claude Code wysyłać zapytania do swoich notatników Google NotebookLM i uzyskiwać odpowiedzi oparte na źródłach, poparte cytatami, pochodzące od Gemini. Automatyzacja przeglądarki, zarządzanie biblioteką, trwałe uwierzytelnianie. Drastycznie ograniczone halucynacje – odpowiedzi wyłącznie z przesłanych dokumentów.

Instalacja • Szybki start • Dlaczego NotebookLM • Jak to działa • Alternatywa MCP

⚠️ Ważne: Tylko lokalna wersja Claude Code

Ta umiejętność działa TYLKO z lokalnymi instalacjami Claude Code, NIE w interfejsie internetowym.

Interfejs internetowy uruchamia umiejętności w piaskownicy bez dostępu do sieci, czego ta umiejętność wymaga do automatyzacji przeglądarki. Musisz używać Claude Code lokalnie na swoim komputerze.

Problem

Kiedy poprosisz Claude Code o „przeszukanie mojej lokalnej dokumentacji”, oto co się dzieje:

• Ogromne zużycie tokenów: Przeszukiwanie dokumentacji oznacza wielokrotne odczytywanie wielu plików
• Niedokładne wyszukiwanie: Szuka słów kluczowych, pomija kontekst i powiązania między dokumentami
• Halucynacje: Gdy nie może czegoś znaleźć, wymyśla prawdopodobnie brzmiące interfejsy API
• Ręczne kopiuj-wklej: Ciągłe przełączanie się między przeglądarką NotebookLM a edytorem

Rozwiązanie

Ta umiejętność Claude Code umożliwia Claude Code bezpośrednią rozmowę z NotebookLM — opartą na źródłach bazą wiedzy Google, zasilaną przez Gemini 2.5, która dostarcza inteligentne, zsyntetyzowane odpowiedzi wyłącznie na podstawie przesłanych dokumentów.

Twoje zadanie → Claude pyta NotebookLM → Gemini syntetyzuje odpowiedź → Claude pisze poprawny kod

Koniec z tańcem kopiuj-wklej: Claude zadaje pytania bezpośrednio i otrzymuje odpowiedzi prosto w CLI. Buduje głębokie zrozumienie dzięki automatycznym pytaniom uzupełniającym, uzyskując szczegółowe informacje implementacyjne, przypadki brzegowe i najlepsze praktyki.

Dlaczego NotebookLM, a nie lokalny RAG?

Co sprawia, że NotebookLM jest lepszy?

1. Wstępnie przetworzone przez Gemini: Prześlij dokumenty raz, uzyskaj natychmiastową wiedzę ekspercką
2. Pytania i odpowiedzi w języku naturalnym: Nie tylko wyszukiwanie — rzeczywiste zrozumienie i synteza
3. Korelacja wielu źródeł: Łączy informacje z ponad 50 dokumentów
4. Poparte cytatami: Każda odpowiedź zawiera odwołania do źródeł
5. Bez infrastruktury: Nie potrzebujesz wektorowych baz danych, osadzeń ani strategii dzielenia na fragmenty

Instalacja

Najprostsza instalacja w historii:

# 1. Utwórz katalog umiejętności (jeśli nie istnieje)
mkdir -p ~/.claude/skills

# 2. Sklonuj to repozytorium
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

# 3. To wszystko! Otwórz Claude Code i powiedz:
"Jakie mam umiejętności?"

Przy pierwszym użyciu umiejętność automatycznie:

• Tworzy izolowane środowisko Python (.venv)
• Instaluje wszystkie zależności, w tym Google Chrome
• Konfiguruje automatyzację przeglądarki za pomocą Chrome (nie Chromium) dla maksymalnej niezawodności
• Wszystko pozostaje w folderze umiejętności

Uwaga: Konfiguracja korzysta z prawdziwego Chrome zamiast Chromium ze względu na niezawodność międzyplatformową, spójne odciski palców przeglądarki i lepszą ochronę przed wykrywaniem przez usługi Google

Szybki start

1. Sprawdź swoje umiejętności

Powiedz w Claude Code:

"Jakie mam umiejętności?"

Claude wyświetli listę dostępnych umiejętności, w tym NotebookLM.

2. Uwierzytelnij się w Google (jednorazowo)

"Skonfiguruj uwierzytelnianie NotebookLM"

Otwiera się okno Chrome → zaloguj się za pomocą konta Google

3. Utwórz swoją bazę wiedzy

Przejdź do notebooklm.google.com → Utwórz notatnik → Prześlij swoje dokumenty:

• 📄 PDFy, Dokumenty Google, pliki markdown
• 🔗 Strony internetowe, repozytoria GitHub
• 🎥 Filmy z YouTube
• 📚 Wiele źródeł na notatnik

Udostępnij: ⚙️ Udostępnij → Każdy z linkiem → Kopiuj

4. Dodaj do swojej biblioteki

Opcja A: Pozwól Claude'owi to rozgryźć (Inteligentne dodawanie)

"Zapytaj ten notatnik o jego zawartość i dodaj go do mojej biblioteki: [twój-link]"

Claude automatycznie zapyta notatnik, aby poznać jego zawartość, a następnie doda go z odpowiednimi metadanymi.

Opcja B: Dodawanie ręczne

"Dodaj ten NotebookLM do mojej biblioteki: [twój-link]"

Claude zapyta o nazwę i tematy, a następnie zapisze go do późniejszego wykorzystania.

5. Rozpocznij badania

"Co moja dokumentacja React mówi o hookach?"

Claude automatycznie wybiera odpowiedni notatnik i otrzymuje odpowiedź bezpośrednio z NotebookLM.

Jak to działa

To jest Umiejętność Claude Code – lokalny folder zawierający instrukcje i skrypty, z których Claude Code może korzystać w razie potrzeby. W przeciwieństwie do wersji serwera MCP, ta działa bezpośrednio w Claude Code bez potrzeby korzystania z oddzielnego serwera.

Kluczowe różnice w porównaniu do serwera MCP

Architektura

~/.claude/skills/notebooklm/
├── SKILL.md              # Instrukcje dla Claude
├── scripts/              # Skrypty automatyzacji Python
│   ├── ask_question.py   # Zapytaj NotebookLM
│   ├── notebook_manager.py # Zarządzanie biblioteką
│   └── auth_manager.py   # Uwierzytelnianie Google
├── .venv/                # Izolowane środowisko Python (tworzone automatycznie)
└── data/                 # Lokalna biblioteka notatników

Gdy wspomnisz o NotebookLM lub wyślesz adres URL notatnika, Claude:

1. Ładuje instrukcje umiejętności
2. Uruchamia odpowiedni skrypt Python
3. Otwiera przeglądarkę, zadaje pytanie
4. Zwraca odpowiedź bezpośrednio do Ciebie
5. Wykorzystuje tę wiedzę, aby pomóc Ci w zadaniu

Główne cechy

Odpowiedzi oparte na źródłach

NotebookLM znacząco redukuje halucynacje, odpowiadając wyłącznie na podstawie przesłanych dokumentów. Jeśli informacja nie jest dostępna, sygnalizuje niepewność, zamiast wymyślać treści.

Bezpośrednia integracja

Bez kopiowania i wklejania między przeglądarką a edytorem. Claude zadaje pytania i otrzymuje odpowiedzi programowo.

Inteligentne zarządzanie biblioteką

Zapisuj linki do NotebookLM z tagami i opisami. Claude automatycznie wybiera odpowiedni notatnik do Twojego zadania.

Automatyczne uwierzytelnianie

Jednorazowe logowanie do Google, a następnie uwierzytelnianie utrzymuje się między sesjami.

Samodzielny

Wszystko działa w folderze umiejętności z izolowanym środowiskiem Python. Bez globalnych instalacji.

Automatyzacja przypominająca człowieka

Wykorzystuje realistyczne prędkości pisania i wzorce interakcji, aby uniknąć wykrycia.

Najczęściej używane polecenia

Przykłady z życia wzięte

Przykład 1: Zapytanie do instrukcji warsztatowej

Użytkownik pyta: „Sprawdź w mojej instrukcji warsztatowej Suzuki GSR 600 rodzaj płynu hamulcowego, specyfikację oleju silnikowego i moment dokręcania tylnej osi.”

Claude automatycznie:

• Uwierzytelnia się w NotebookLM
• Zadaje obszerne pytania dotyczące każdej specyfikacji
• Zadaje pytania uzupełniające po monitcie „Czy to WSZYSTKO, co musisz wiedzieć?”
• Podaje dokładne specyfikacje: płyn hamulcowy DOT 4, olej SAE 10W-40, moment dokręcania tylnej osi 100 N·m

Przykład 2: Budowanie bez halucynacji

Ty: „Muszę zbudować workflow n8n do filtrowania spamu w Gmailu. Użyj mojego notatnika n8n.”

Wewnętrzny proces Claude’a:

→ Ładuje umiejętność NotebookLM
→ Aktywuje notatnik n8n
→ Zadaje obszerne pytania z uzupełnieniami
→ Syntetyzuje kompletną odpowiedź na podstawie wielu zapytań

Rezultat: Działający workflow za pierwszym razem, bez debugowania halucynacyjnych API.

Szczegóły techniczne

Podstawowa technologia

• Patchright: Biblioteka automatyzacji przeglądarki (oparta na Playwright)
• Python: Język implementacji tej umiejętności
• Techniki ukrywania: Wzorce pisania i interakcji przypominające człowieka

Uwaga: Serwer MCP korzysta z tej samej biblioteki Patchright, ale z ekosystemu TypeScript/npm.

Zależności

• patchright==1.55.2: Automatyzacja przeglądarki
• python-dotenv==1.0.0: Konfiguracja środowiska
• Automatycznie instalowane w .venv przy pierwszym użyciu

Przechowywanie danych

Wszystkie dane są przechowywane lokalnie w katalogu umiejętności:

~/.claude/skills/notebooklm/data/
├── library.json       - Twoja biblioteka notatników z metadanymi
├── auth_info.json     - Informacje o statusie uwierzytelniania
└── browser_state/     - Pliki cookie przeglądarki i dane sesji

Ważna uwaga dotycząca bezpieczeństwa:

• Katalog data/ zawiera wrażliwe dane uwierzytelniające i osobiste notatniki
• Jest automatycznie wykluczany z git poprzez .gitignore
• NIGDY nie commituj ani nie udostępniaj ręcznie zawartości katalogu data/

Model sesji

W przeciwieństwie do serwera MCP, ta umiejętność wykorzystuje model bezstanowy:

• Każde pytanie otwiera nową przeglądarkę
• Zadaje pytanie, otrzymuje odpowiedź
• Dodaje monit uzupełniający, aby zachęcić Claude’a do zadawania kolejnych pytań
• Natychmiast zamyka przeglądarkę

Oznacza to:

• Brak trwałego kontekstu czatu
• Każde pytanie jest niezależne
• Ale Twoja biblioteka notatników jest trwała
• Mechanizm uzupełniania: Każda odpowiedź zawiera pytanie „Czy to WSZYSTKO, co musisz wiedzieć?”, aby skłonić Claude’a do zadawania wyczerpujących pytań uzupełniających

W przypadku badań wieloetapowych Claude automatycznie zadaje pytania uzupełniające, gdy jest to potrzebne.

Ograniczenia

Specyficzne dla umiejętności

• Tylko lokalny Claude Code - Nie działa w interfejsie internetowym (ograniczenia piaskownicy)
• Brak trwałości sesji - Każde pytanie jest niezależne
• Brak kontekstu uzupełniającego - Nie można odwołać się do „poprzedniej odpowiedzi”

NotebookLM

• Limity szybkości - Darmowy plan ma dzienne limity zapytań
• Ręczne przesyłanie - Musisz najpierw przesłać dokumenty do NotebookLM
• Wymóg udostępniania - Notatniki muszą być udostępnione publicznie

FAQ

Dlaczego to nie działa w interfejsie internetowym Claude? Interfejs internetowy uruchamia umiejętności w piaskownicy bez dostępu do sieci. Automatyzacja przeglądarki wymaga dostępu do sieci, aby dotrzeć do NotebookLM.

Czym to się różni od serwera MCP? To prostsza implementacja oparta na Pythonie, która działa bezpośrednio jako Umiejętność Claude. Serwer MCP jest bardziej rozbudowany, oferuje trwałe sesje i współpracuje z wieloma narzędziami (Codex, Cursor itp.).

Czy mogę korzystać zarówno z tej umiejętności, jak i z serwera MCP? Tak! Służą różnym celom. Używaj umiejętności do szybkiej integracji z Claude Code, używaj serwera MCP do trwałych sesji i obsługi wielu narzędzi.

Co zrobić, jeśli Chrome ulegnie awarii? Uruchom: „Wyczyść dane przeglądarki NotebookLM” i spróbuj ponownie.

Czy moje konto Google jest bezpieczne? Chrome działa lokalnie na Twoim komputerze. Twoje dane uwierzytelniające nigdy nie opuszczają Twojego komputera. Jeśli masz obawy, użyj dedykowanego konta Google.

Rozwiązywanie problemów

Nie znaleziono umiejętności

# Upewnij się, że znajduje się we właściwej lokalizacji
ls ~/.claude/skills/notebooklm/
# Powinno pokazać: SKILL.md, scripts/ itp.

Problemy z uwierzytelnianiem

Powiedz: „Zresetuj uwierzytelnianie NotebookLM”

Awaria przeglądarki

Powiedz: „Wyczyść dane przeglądarki NotebookLM”

Problemy z zależnościami

# Ręczna ponowna instalacja w razie potrzeby
cd ~/.claude/skills/notebooklm
rm -rf .venv
python -m venv .venv
source .venv/bin/activate  # lub .venv\Scripts\activate w systemie Windows
pip install -r requirements.txt

Zastrzeżenie

To narzędzie automatyzuje interakcje przeglądarki z NotebookLM, aby zwiększyć wydajność Twojej pracy. Jednak kilka przyjaznych przypomnień:

O automatyzacji przeglądarki: Chociaż wbudowałem funkcje humanizacji (realistyczne prędkości pisania, naturalne opóźnienia, ruchy myszy), aby automatyzacja zachowywała się bardziej naturalnie, nie mogę zagwarantować, że Google nie wykryje lub nie oznaczy zautomatyzowanego użycia. Zalecam korzystanie z dedykowanego konta Google do automatyzacji, a nie z głównego konta — pomyśl o tym jak o scrapowaniu stron internetowych: prawdopodobnie jest w porządku, ale lepiej dmuchać na zimne!

O narzędziach CLI i agentach AI: Narzędzia CLI, takie jak Claude Code, Codex i podobne asystenty oparte na AI, są niezwykle potężne, ale mogą popełniać błędy. Proszę, korzystaj z nich ostrożnie i świadomie:

• Zawsze przeglądaj zmiany przed zatwierdzeniem lub wdrożeniem
• Najpierw testuj w bezpiecznych środowiskach
• Twórz kopie zapasowe ważnych prac
• Pamiętaj: Agenci AI są asystentami, a nie nieomylnymi wyroczniami

Zbudowałem to narzędzie dla siebie, ponieważ byłem zmęczony tańcem kopiuj-wklej między NotebookLM a edytorem. Udostępniam je w nadziei, że pomoże również innym, ale nie mogę brać odpowiedzialności za jakiekolwiek problemy, utratę danych lub problemy z kontem, które mogą wystąpić. Korzystaj według własnego uznania i osądu.

Jeśli jednak napotkasz problemy lub masz pytania, zachęcam do otwarcia zgłoszenia na GitHubie. Chętnie pomogę w rozwiązywaniu problemów!

Podziękowania

Ta umiejętność jest inspirowana moim serwerem NotebookLM MCP i stanowi alternatywną implementację jako Umiejętność Claude Code:

• Obie korzystają z Patchright do automatyzacji przeglądarki (TypeScript dla MCP, Python dla Umiejętności)
• Wersja Umiejętności działa bezpośrednio w Claude Code bez protokołu MCP
• Bezstanowa konstrukcja zoptymalizowana pod kątem architektury umiejętności

Jeśli potrzebujesz:

• Trwałych sesji → Użyj serwera MCP
• Obsługi wielu narzędzi (Codex, Cursor) → Użyj serwera MCP
• Szybkiej integracji z Claude Code → Użyj tej umiejętności

Podsumowując

Bez tej umiejętności: NotebookLM w przeglądarce → Kopiuj odpowiedź → Wklej w Claude → Kopiuj następne pytanie → Z powrotem do przeglądarki...

Z tą umiejętnością: Claude bada bezpośrednio → Otrzymuje odpowiedzi natychmiast → Pisze poprawny kod

Przerwij taniec kopiuj-wklej. Zacznij otrzymywać dokładne, oparte na źródłach odpowiedzi bezpośrednio w Claude Code.

# Zacznij w 30 sekund
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# Otwórz Claude Code: „Jakie mam umiejętności?”

Zbudowane jako adaptacja Umiejętności Claude Code mojego serwera NotebookLM MCP

Do badań opartych na źródłach, na podstawie dokumentów, bezpośrednio w Claude Code