Agent Skills › sanjay3290/ai-skills › notebooklm

notebooklm

GitHub

通过Playwright自动化操作Google NotebookLM，支持身份验证、笔记本管理、批量提问、源同步及结构化导出。

skills/notebooklm/SKILL.md sanjay3290/ai-skills

Trigger Scenarios

查询NotebookLM内容管理笔记本或源文件执行批量或多笔记本对比导出笔记数据

Install

npx skills add sanjay3290/ai-skills --skill notebooklm -g -y

More Options

Use without installing

npx skills use sanjay3290/ai-skills@notebooklm

指定 Agent (Claude Code)

npx skills add sanjay3290/ai-skills --skill notebooklm -a claude-code -g -y

安装 repo 全部 skill

npx skills add sanjay3290/ai-skills --all -g -y

预览 repo 内 skill

npx skills add sanjay3290/ai-skills --list

SKILL.md

Frontmatter

{
    "name": "notebooklm",
    "license": "Apache-2.0",
    "metadata": {
        "author": "sanjay3290",
        "version": "1.0"
    },
    "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."
}

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-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

# 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.