Blog NotebookLM: allikapõhine uurimistöö sinu dokumentidest

Päri Google NotebookLM-i märkmikke otse Claude Code'ist, et saada Geminilt viidetega varustatud vastuseid. Iga küsimus avab peata brauserisessiooni, hangib vastuse sinu üleslaetud dokumentidest ja sulgeb selle. Vastused on allikapõhised mudeli vastused, mitte tõe tõendus: üleslaetud dokumendid võivad olla esmased või teisesed ja vastus võib ikkagi konteksti välja jätta.

Vastused annavad kasutatavat päritolu ainult siis, kui tagastatud viide tuvastab kontrollitava aluseks oleva allika. Pane kirja püsiv allika-URL ja avaldamis-, uuringuperioodi- või hankimiskuupäev, kui see detail mõjutab kontrollimist või tõlgendamist. Kasuta tekstisisese viitena aluseks oleva allika pealkirja. Ära viita avaliku sisu kirjanduse kirjena privaatsele NotebookLM-i URL-ile.

Kiirülevaade

Eeldused

• NotebookLM-i ligipääsuga Google'i konto
• Python 3.11+ (venv-i haldab automaatselt run.py)
• Google Chrome (paigaldatakse esmakäivitusel automaatselt Patchrighti kaudu)
• Ühekordne autentimise seadistus (interaktiivne Google'i sisselogimine nähtavas brauseris)

Kasuta run.py mähist

Kutsu skripte ainult läbi run.py mähise: python3 scripts/run.py [script]:

# CORRECT:
python3 scripts/run.py auth_manager.py status
python3 scripts/run.py ask_question.py --question "..."

# Do not call files under scripts/ directly. The wrapper owns venv setup.

run.py mähis loob automaatselt .venv, paigaldab sõltuvused, seadistab Chrome'i ja käivitab sihtskripti.

Autentimise kontroll (värava muster)

Enne iga päringutoimingut kontrolli autentimist:

python3 scripts/run.py auth_manager.py status

• Kui autenditud: jätka päringuga
• Kui pole autenditud: teavita kasutajat ja juhata seadistusse: „NotebookLM nõuab Google'i sisselogimist. Autentimiseks käivita /blog notebooklm setup."
• Kui kutsutakse sisemiselt (blog-write'ist või blog-researcher'ist): tagasta vaikselt ilma veata, kui pole autenditud. Ära kunagi blokeeri kirjutamise töövoogu.

Seadistuse töövoog

Käsu /blog notebooklm setup jaoks:

# Opens a visible browser for manual Google login (one-time)
python3 scripts/run.py auth_manager.py setup

Ütle kasutajale: „Avaneb brauseriaken. Palun logi sisse oma Google'i kontole." Autentimine püsib brauseriprofiili + küpsiste sisestamise kaudu (hübriidlähenemine).

Muud autentimiskäsud:

python3 scripts/run.py auth_manager.py status   # Check auth
python3 scripts/run.py auth_manager.py reauth   # Re-authenticate
python3 scripts/run.py auth_manager.py clear     # Clear all auth data

Päringu töövoog

Käsu /blog notebooklm ask <question> jaoks:

Samm 1: kontrolli autentimist

Tee autentimise kontroll (vt värava muster ülal). Kui pole autenditud, juhata seadistusse.

Samm 2: lahenda märkmik

Määra, millist märkmikku pärida: - Kui --notebook-url on antud: valideeri, et see on NotebookLM-i märkmiku URL, seejärel kasuta seda - Kui --notebook-id on antud: otsi kogust üles - Kui ei kumbagi: kasuta kogu aktiivset märkmikku - Kui aktiivset märkmikku pole: näita kogu ja palu kasutajal valida

Samm 3: esita küsimus

# Basic query (uses active notebook)
python3 scripts/run.py ask_question.py --question "Your question here"

# Query specific notebook by ID
python3 scripts/run.py ask_question.py --question "..." --notebook-id notebook-id

# Query by URL directly
python3 scripts/run.py ask_question.py --question "..." --notebook-url "https://..."

# JSON output (for internal/programmatic use)
python3 scripts/run.py ask_question.py --question "..." --json

# Show browser for debugging
python3 scripts/run.py ask_question.py --question "..." --show-browser

Samm 4: analüüsi ja küsi edasi

Iga vastus lõpeb jätkuviibaga. Nõutav käitumine: 1. PEATU: ära vasta kasutajale kohe 2. ANALÜÜSI: võrdle vastust kasutaja algse sooviga 3. TUVASTA LÜNGAD: määra, kas on vaja rohkem infot 4. KÜSI EDASI: kui lünki on, esita kohe jätkuküsimus 5. KORDA: jätka, kuni info on täielik 6. SÜNTEESI: kombineeri kõik vastused enne kasutajale vastamist

Nutika avastamise töövoog

Käsu /blog notebooklm discover <url> jaoks:

Kui lisad märkmiku, teadmata selle sisu, päri seda esmalt:

# Step 1: Discover content
python3 scripts/run.py ask_question.py \
  --question "What is the content of this notebook? What topics are covered? Provide a complete overview briefly and concisely" \
  --notebook-url "<URL>"

# Step 2: Add with discovered metadata
python3 scripts/run.py notebook_manager.py add \
  --url "<URL>" \
  --name "<Based on content>" \
  --description "<Based on content>" \
  --topics "<Extracted topics>"

Ära arva kirjeldusi; avasta või küsi kasutajalt.

Kogu haldamine

# List all notebooks
python3 scripts/run.py notebook_manager.py list

# Add notebook (all params required -- discover or ask user!)
python3 scripts/run.py notebook_manager.py add \
  --url "https://notebooklm.google.com/notebook/..." \
  --name "Descriptive Name" \
  --description "What this notebook contains" \
  --topics "topic1,topic2,topic3"

# Search by keyword
python3 scripts/run.py notebook_manager.py search --query "keyword"

# Set active notebook
python3 scripts/run.py notebook_manager.py activate --id notebook-id

# Remove notebook
python3 scripts/run.py notebook_manager.py remove --id notebook-id

# Library statistics
python3 scripts/run.py notebook_manager.py stats

Sisemine API (blog-write / blog-researcher jaoks)

Kui kutsutakse Task-alamagendina blog-write'ist või blog-researcher'ist:

Sisend (annab kutsuv oskus): - question: blogiteemaga seotud uurimisküsimus - notebook_id või notebook_url: millist märkmikku pärida - context: "internal" (annab märku sujuvast tagavararežiimist)

Protsess: 1. Kontrolli autentimise olekut: kui pole autenditud, tagasta vaikselt tühi tulemus 2. Päri märkmikku uurimisküsimusega 3. Parsi ja tagasta struktureeritud vastus

Väljund (tagastatakse kutsuvale oskusele):

### NotebookLM Research
- **Source:** [Notebook name]
- **Question:** [What was asked]
- **Answer:** [Source-grounded response from user's documents]
- **Underlying Source:** [Public source URL or document identifier]
- **Underlying Source Date:** [Publication date or retrieval date]
- **Source Quality:** [Tier 1-3 after classifying the underlying document]

Sujuv tagavara: Kui autentimine puudub või päring ebaõnnestub, tagasta kohe ilma veata. Kutsuv töövoog jätkab WebSearch-põhise uurimistööga. Ära kunagi blokeeri blog-write'i ega blog-rewrite'i sellepärast, et NotebookLM pole saadaval.

Andmete salvestamine

Kõik andmed salvestatakse oskuse kausta sisse: - data/library.json: märkmike metaandmed ja kogu - data/auth_info.json: autentimise olek - data/browser_state/: Chrome'i profiil koos küpsistega

Turvalisus: Kõik andmekaustad on gitignore'itud. Ära kunagi committi autentimis- ega brauseriolekut.

Brauseri elutsükkel ja autenditud konteksti isolatsioon on koondatud faili scripts/browser_session.py. Käsuskriptid peavad kasutama seda abilist, mitte avama täiendavat püsivat profiili ega kopeerima küpsiseid teise faili.

Vigade käsitlemine

Piirangud

• Sessioon ei püsi (iga küsimus = uus brauserisessioon)
• Päringulimiidid tasuta Google'i kontodel (50 päringut/päevas)
• Vaja on käsitsi üleslaadimist (kasutaja peab lisama dokumendid NotebookLM-i veebiliidesesse)
• Brauseri lisakoormus (paar sekundit küsimuse kohta käivituseks + sulgemiseks)
• Ainult kohalik Claude Code (pole saadaval veebiliideses)

Viitedokumentatsioon

Lae vastavalt vajadusele: ÄRA lae kõike käivitusel: - references/commands.md: täielikud CLI-käsud, parameetrid ja töövoomustrid - references/troubleshooting.md: vealahendused, taastamisprotseduurid, silumine