notebooklm
Query and manage Google NotebookLM notebooks with persistent profile auth, source sync, batch/multi queries, and structured exports. Use when user asks to query NotebookLM, 'ask my notebook', shares NotebookLM notebook URLs, wants to list/create notebooks, manage sources, do bulk
Install
npx skills add https://github.com/sanjay3290/ai-skills/tree/main/skills/notebooklm
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install sanjay3290-ai-skills@llmmart
git clone https://github.com/sanjay3290/ai-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole sanjay3290/ai-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
NotebookLM Skill
Query NotebookLM notebooks and manage notebooks/sources via Playwright browser automation.
All commands run from the skill directory. All scripts output JSON to stdout and exit 1 on error. Use --help on any script for full flag reference.
Workflow
- Authenticate:
python scripts/auth_manager.py setup --profile <name> - Register notebook:
python scripts/notebook_manager.py add --url <url> --name <name> --description <desc> --topics <topics> - Ask questions:
python scripts/ask_question.py --question "..." --notebook-id <id> - Manage sources:
python scripts/remote_manager.py add-source|sync-sources ...
Key Behaviors
- Runs headless by default; use
--show-browserfor debugging only. - Persistent Chrome profiles stored at
~/.config/claude/notebooklm-skill/(override withNOTEBOOKLM_DATA_DIR). - Hash-based dedupe: file uploads skip unchanged sources automatically.
--dry-runavailable on all destructive/bulk operations (create, add-source, delete-source, sync-sources).--retries Nretries transient browser failures with screenshot/HTML artifact capture.- Batch mode (
--questions "q1||q2||q3") and multi-notebook comparison (--compare-notebook-ids) supported. - Exports to JSON or Markdown via
--export-format markdown --save-notes. - Answers include a follow-up reminder prompting Claude to ask clarifying questions before replying.
Quick Reference
# Auth
python scripts/auth_manager.py setup --profile work
python scripts/auth_manager.py status --profile work
# Library
python scripts/notebook_manager.py add --url "..." --name "..." --description "..." --topics "..."
python scripts/notebook_manager.py list
# Ask
python scripts/ask_question.py --question "..." --notebook-id <id>
python scripts/ask_question.py --questions "q1||q2" --notebook-id <id>
# Sources
python scripts/remote_manager.py add-source --notebook-id <id> --dir ./docs --recursive
python scripts/remote_manager.py sync-sources --notebook-id <id> --dir ./docs --recursive --delete-missing --dry-run
For full command reference with all flags and examples, see references/commands.md.
Files (ai-skills)
-
references
-
commands.md 4.1 KB
Loading…
-
-
scripts
-
ask_question.py 27.2 KB
Loading… -
auth_manager.py 7.9 KB
Loading… -
common.py 8.1 KB
Loading… -
notebook_manager.py 7.3 KB
Loading… -
remote_manager.py 55.4 KB
Loading…
-
-
tests
-
conftest.py 148 B
Loading… -
test_ask_question_modes.py 2 KB
Loading… -
test_remote_manager_filters.py 2.5 KB
Loading… -
test_smoke_playwright.py 2.8 KB
Loading…
-
-
.gitignore 34 B · in bundle
-
requirements.txt 19 B
Loading… -
SKILL.md 2.6 KB
--- name: notebooklm description: "Query and manage Google NotebookLM notebooks with persistent profile auth, source sync, batch/multi queries, and structured exports. Use when user asks to query NotebookLM, 'ask my notebook', shares NotebookLM notebook URLs, wants to list/create notebooks, manage sources, do bulk folder sync, dedupe, or audit exports." license: Apache-2.0 metadata: author: sanjay3290 version: "1.0" --- # NotebookLM Skill Query NotebookLM notebooks and manage notebooks/sources via Playwright browser automation. All commands run from the skill directory. All scripts output JSON to stdout and exit 1 on error. Use `--help` on any script for full flag reference. ## Workflow 1. **Authenticate**: `python scripts/auth_manager.py setup --profile <name>` 2. **Register notebook**: `python scripts/notebook_manager.py add --url <url> --name <name> --description <desc> --topics <topics>` 3. **Ask questions**: `python scripts/ask_question.py --question "..." --notebook-id <id>` 4. **Manage sources**: `python scripts/remote_manager.py add-source|sync-sources ...` ## Key Behaviors - Runs headless by default; use `--show-browser` for debugging only. - Persistent Chrome profiles stored at `~/.config/claude/notebooklm-skill/` (override with `NOTEBOOKLM_DATA_DIR`). - Hash-based dedupe: file uploads skip unchanged sources automatically. - `--dry-run` available on all destructive/bulk operations (create, add-source, delete-source, sync-sources). - `--retries N` retries transient browser failures with screenshot/HTML artifact capture. - Batch mode (`--questions "q1||q2||q3"`) and multi-notebook comparison (`--compare-notebook-ids`) supported. - Exports to JSON or Markdown via `--export-format markdown --save-notes`. - Answers include a follow-up reminder prompting Claude to ask clarifying questions before replying. ## Quick Reference ```bash # Auth python scripts/auth_manager.py setup --profile work python scripts/auth_manager.py status --profile work # Library python scripts/notebook_manager.py add --url "..." --name "..." --description "..." --topics "..." python scripts/notebook_manager.py list # Ask python scripts/ask_question.py --question "..." --notebook-id <id> python scripts/ask_question.py --questions "q1||q2" --notebook-id <id> # Sources python scripts/remote_manager.py add-source --notebook-id <id> --dir ./docs --recursive python scripts/remote_manager.py sync-sources --notebook-id <id> --dir ./docs --recursive --delete-missing --dry-run ``` For full command reference with all flags and examples, see [references/commands.md](references/commands.md).
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.