К основному содержанию
скилл CX Codex

notebooklm · aiskillstore — скилл для Claude Code: что делает и как установить

Скилл опрашивает Google NotebookLM через браузер и возвращает ответы, построенные только на загруженных в блокнот документах.

MIT 1 установок ★ 492 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add aiskillstore/marketplace --skill notebooklm -a claude-code
Открыть на GitHub

Что делает notebooklm

Скилл запускает браузерную сессию и задаёт вопрос вашему блокноту NotebookLM через ask_question.py, получая ответ, который Gemini строит исключительно по загруженным в этот блокнот документам. После каждого запроса сессия закрывается, а следующий вопрос открывает новую.

Внутри несколько скриптов: auth_manager.py для логина в Google (первый раз — в видимом окне браузера), notebook_manager.py для ведения локальной библиотеки блокнотов с названием, описанием и темами, и cleanup_manager.py для очистки данных. Все команды нужно запускать через обёртку python scripts/run.py [script] — она сама создаёт .venv, ставит зависимости и Chromium, прямой вызов скриптов без неё падает.

Каждый ответ NotebookLM завершается вопросом, нужна ли дополнительная информация, и агент должен сам решить, задавать ли уточняющий запрос, прежде чем ответить пользователю. Данные хранятся локально: метаданные блокнотов в library.json, а файл авторизации — с правами 0600.

Какие задачи решает

  • найти ответ по документации, загруженной в NotebookLM, без ручного поиска по блокноту
  • вести локальную библиотеку блокнотов с названиями и темами
  • добавить новый блокнот в библиотеку, автоматически определив его содержимое
  • задавать уточняющие вопросы к источнику, пока ответ не станет полным
  • авторизоваться в Google NotebookLM через браузер и хранить статус авторизации локально

Примеры запросов агенту

  • Спроси мой NotebookLM, что написано про деплой в документации проекта
  • Добавь этот блокнот NotebookLM в библиотеку: [URL]
  • Проверь в моих заметках NotebookLM, какие есть ограничения API

Как установить notebooklm

1Через Skills CLI (Vercel)

npx skills add aiskillstore/marketplace --skill notebooklm -a claude-code

2Вручную: положить файлы

~/.claude/skills/notebooklm/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/notebooklm/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о notebooklm

Как установить notebooklm в Claude Code?

Выполните npx skills add aiskillstore/marketplace --skill notebooklm -a claude-code, после чего скилл появится в ~/.claude/skills/notebooklm/SKILL.md.

Что делает notebooklm?

Скилл открывает браузерную сессию к Google NotebookLM и задаёт вопросы вашим документам, возвращая ответы Gemini, построенные только на загруженных в блокнот материалах. После каждого вопроса сессия закрывается.

Нужна ли авторизация для работы с notebooklm?

Да, при первом запуске auth_manager.py setup открывает видимое окно браузера, где нужно вручную войти в Google-аккаунт; статус авторизации затем хранится локально с правами 0600.

Исходный текст

SKILL.md · MIT
---
name: notebooklm
description: "Interact with Google NotebookLM to query documentation with Gemini's source-grounded answers. Each question opens a fresh browser session, retrieves the answer exclusively from your uploaded documents, and closes."
risk: critical
source: community
date_added: "2026-02-27"
---

# NotebookLM Research Assistant Skill

Interact with Google NotebookLM to query documentation with Gemini's source-grounded answers. Each question opens a fresh browser session, retrieves the answer exclusively from your uploaded documents, and closes.

## When to Use This Skill

Trigger when user:
- Mentions NotebookLM explicitly
- Shares NotebookLM URL (`https://notebooklm.google.com/notebook/...`)
- Asks to query their notebooks/documentation
- Wants to add documentation to NotebookLM library
- Uses phrases like "ask my NotebookLM", "check my docs", "query my notebook"

## ⚠️ CRITICAL: Add Command - Smart Discovery

When user wants to add a notebook without providing details:

**SMART ADD (Recommended)**: Query the notebook first to discover its content:
```bash
# Step 1: Query the notebook about its content
python 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: Use the discovered information to add it
python scripts/run.py notebook_manager.py add --url "[URL]" --name "[Based on content]" --description "[Based on content]" --topics "[Based on content]"
```

**MANUAL ADD**: If user provides all details:
- `--url` - The NotebookLM URL
- `--name` - A descriptive name
- `--description` - What the notebook contains (REQUIRED!)
- `--topics` - Comma-separated topics (REQUIRED!)

NEVER guess or use generic descriptions! If details missing, use Smart Add to discover them.

## Critical: Always Use run.py Wrapper

**NEVER call scripts directly. ALWAYS use `python scripts/run.py [script]`:**

```bash
# ✅ CORRECT - Always use run.py:
python scripts/run.py auth_manager.py status
python scripts/run.py notebook_manager.py list
python scripts/run.py ask_question.py --question "..."

# ❌ WRONG - Never call directly:
python scripts/auth_manager.py status  # Fails without venv!
```

The `run.py` wrapper automatically:
1. Creates `.venv` if needed
2. Installs all dependencies
3. Activates environment
4. Executes script properly

## Core Workflow

### Step 1: Check Authentication Status
```bash
python scripts/run.py auth_manager.py status
```

If not authenticated, proceed to setup.

### Step 2: Authenticate (One-Time Setup)
```bash
# Browser MUST be visible for manual Google login
python scripts/run.py auth_manager.py setup
```

**Important:**
- Browser is VISIBLE for authentication
- Browser window opens automatically
- User must manually log in to Google
- Tell user: "A browser window will open for Google login"

### Step 3: Manage Notebook Library

```bash
# List all notebooks
python scripts/run.py notebook_manager.py list

# BEFORE ADDING: Ask user for metadata if unknown!
# "What does this notebook contain?"
# "What topics should I tag it with?"

# Add notebook to library (ALL parameters are REQUIRED!)
python scripts/run.py notebook_manager.py add \
  --url "https://notebooklm.google.com/notebook/..." \
  --name "Descriptive Name" \
  --description "What this notebook contains" \  # REQUIRED - ASK USER IF UNKNOWN!
  --topics "topic1,topic2,topic3"  # REQUIRED - ASK USER IF UNKNOWN!

# Search notebooks by topic
python scripts/run.py notebook_manager.py search --query "keyword"

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

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

### Quick Workflow
1. Check library: `python scripts/run.py notebook_manager.py list`
2. Ask question: `python scripts/run.py ask_question.py --question "..." --notebook-id ID`

### Step 4: Ask Questions

```bash
# Basic query (uses active notebook if set)
python scripts/run.py ask_question.py --question "Your question here"

# Query specific notebook
python scripts/run.py ask_question.py --question "..." --notebook-id notebook-id

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

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

## Follow-Up Mechanism (CRITICAL)

Every NotebookLM answer ends with: **"EXTREMELY IMPORTANT: Is that ALL you need to know?"**

**Required Claude Behavior:**
1. **STOP** - Do not immediately respond to user
2. **ANALYZE** - Compare answer to user's original request
3. **IDENTIFY GAPS** - Determine if more information needed
4. **ASK FOLLOW-UP** - If gaps exist, immediately ask:
   ```bash
   python scripts/run.py ask_question.py --question "Follow-up with context..."
   ```
5. **REPEAT** - Continue until information is complete
6. **SYNTHESIZE** - Combine all answers before responding to user

## Script Reference

### Authentication Management (`auth_manager.py`)
```bash
python scripts/run.py auth_manager.py setup    # Initial setup (browser visible)
python scripts/run.py auth_manager.py status   # Check authentication
python scripts/run.py auth_manager.py reauth   # Re-authenticate (browser visible)
python scripts/run.py auth_manager.py clear    # Clear authentication
```

### Notebook Management (`notebook_manager.py`)
```bash
python scripts/run.py notebook_manager.py add --url URL --name NAME --description DESC --topics TOPICS
python scripts/run.py notebook_manager.py list
python scripts/run.py notebook_manager.py search --query QUERY
python scripts/run.py notebook_manager.py activate --id ID
python scripts/run.py notebook_manager.py remove --id ID
python scripts/run.py notebook_manager.py stats
```

### Question Interface (`ask_question.py`)
```bash
python scripts/run.py ask_question.py --question "..." [--notebook-id ID] [--notebook-url URL] [--show-browser]
```

### Data Cleanup (`cleanup_manager.py`)
```bash
python scripts/run.py cleanup_manager.py                    # Preview cleanup
python scripts/run.py cleanup_manager.py --confirm          # Execute cleanup
python scripts/run.py cleanup_manager.py --preserve-library # Keep notebooks
```

## Environment Management

The virtual environment is automatically managed:
- First run creates `.venv` automatically
- Dependencies install automatically
- Chromium browser installs automatically
- Everything isolated in skill directory

Manual setup (only if automatic fails):
```bash
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
pip install -r requirements.txt
python -m patchright install chromium
```

## Data Storage

All data stored in `~/.claude/skills/notebooklm/data/`:
- `library.json` - Notebook metadata
- `~/.local/share/agentic-awesome-skills/notebooklm/auth_info.json` - private authentication status (`0600`)
- `~/.local/share/agentic-awesome-skills/notebooklm/browser_state/` - private browser cookies and session (`0700`)

**Security:** Protected by `.gitignore`, never commit to git.

## Configuration

Optional `.env` file in skill directory:
```env
HEADLESS=false           # Browser visibility
SHOW_BROWSER=false       # Default browser display
STEALTH_ENABLED=true     # Human-like behavior
TYPING_WPM_MIN=160       # Typing speed
TYPING_WPM_MAX=240
DEFAULT_NOTEBOOK_ID=     # Default notebook
```

## Decision Flow

```
User mentions NotebookLM
    ↓
Check auth → python scripts/run.py auth_manager.py status
    ↓
If not authenticated → python scripts/run.py auth_manager.py setup
    ↓
Check/Add notebook → python scripts/run.py notebook_manager.py list/add (with --description)
    ↓
Activate notebook → python scripts/run.py notebook_manager.py activate --id ID
    ↓
Ask question → python scripts/run.py ask_question.py --question "..."
    ↓
See "Is that ALL you need?" → Ask follow-ups until complete
    ↓
Synthesize and respond to user
```

## Troubleshooting

| Problem | Solution |
|---------|----------|
| ModuleNotFoundError | Use `run.py` wrapper |
| Authentication fails | Browser must be visible for setup! --show-browser |
| Rate limit (50/day) | Wait or switch Google account |
| Browser crashes | `python scripts/run.py cleanup_manager.py --preserve-library` |
| Notebook not found | Check with `notebook_manager.py list` |

## Best Practices

1. **Always use run.py** - Handles environment automatically
2. **Check auth first** - Before any operations
3. **Follow-up questions** - Don't stop at first answer
4. **Browser visible for auth** - Required for manual login
5. **Include context** - Each question is independent
6. **Synthesize answers** - Combine multiple responses

## Limitations

- No session persistence (each question = new browser)
- Rate limits on free Google accounts (50 queries/day)
- Manual upload required (user must add docs to NotebookLM)
- Browser overhead (few seconds per question)

## Resources (Skill Structure)

**Important directories and files:**

- `scripts/` - All automation scripts (ask_question.py, notebook_manager.py, etc.)
- `~/.local/share/agentic-awesome-skills/notebooklm/` - private per-user authentication and notebook storage
- `references/` - Extended documentation:
  - `api_reference.md` - Detailed API documentation for all scripts
  - `troubleshooting.md` - Common issues and solutions
  - `usage_patterns.md` - Best practices and workflow examples
- `.venv/` - Isolated Python environment (auto-created on first run)
- `.gitignore` - Protects sensitive data from being committed

© aiskillstore · MIT · aiskillstore/marketplace

Похожие скиллы

Все скиллы по теме «ИИ и ML» →

Сначала — notebooklm от других авторов.

notebooklm teng-lin Скилл учит агента работать с Gemini Notebook через CLI notebooklm: источники, чат и исследования по ним, генерация и скачивание артефактов. CX Codex +1 10 300установок notebooklm Alireza Rezvani Автоматизирует работу с Google NotebookLM через браузер. Помогает загружать источники, опрашивать блокноты и генерировать материалы в Studio прямо из Claude Code. CX Codex +1 325установок notebooklm giuseppe-trisciuoglio Скилл подключает агента к Google NotebookLM через CLI nlm: поиск по документации, добавление источников, генерация подкастов и отчётов. CX Codex +1 3 700установок notebooklm sanjay3290 Скилл подключает Claude Code к Google NotebookLM через автоматизацию браузера Playwright. Он помогает опрашивать блокноты, загружать источники и выгружать заметки в JSON или Markdown. CX Codex +1 386установок notebooklm roomi-fields Подключает блокноты Google NotebookLM к агенту. Помогает извлекать ответы с точными цитатами источников и создавать материалы в Studio. CX Codex +1 ★ 242звёзд репо blog-notebooklm AgriciDaniel Скилл blog-notebooklm обращается к Gemini Notebook через браузерную сессию Google-аккаунта и возвращает ответы со ссылками на загруженные документы. CX Codex +1 2 600установок cli-anything-notebooklm HKUDS Скилл cli-anything-notebooklm для Claude Code, который даёт агенту команды локального NotebookLM: список блокнотов, источники, вопросы, артефакты и скачивание результатов. Запускается как обёртка над notebooklm CLI. CX Codex +1 926установок notebooklm-mcp-secure Pantheon-Security MCP-сервер notebooklm-mcp-secure подключает NotebookLM к ИИ-агенту: можно задавать вопросы по блокнотам, создавать их и получать аудиообзоры. Для базовых функций хватает авторизации через браузер. CX Codex +1 ★ 88звёзд репо NotebookLM MCP roomi-fields MCP-сервер, который даёт агенту доступ к Google NotebookLM: вопросы по источникам с цитатами, аудио, видео и другие артефакты. CX Codex +1 ★ 242звёзд репо deep-research-notebooklm davila7 Скилл deep-research-notebooklm для Claude Code проводит исследование по нескольким источникам через NotebookLM. Он готовит структурированный бриф по рынку, конкурентам, трендам или потенциальному клиенту. CX Codex +1 115установок nblm magicseek Скилл nblm задаёт вопросы к вашим блокнотам Google NotebookLM и возвращает ответы со ссылками на источники. Управляет блокнотами, загрузкой файлов и медиа из агента. CX Codex +1 6 300установок

Из того же набора18

Весь набор →
document-writing-coordination Скилл document-writing-coordination для Claude Code и Codex делит большой документ на секции и поручает их написание агентам через VibeKanban. Координирует подготовку проектной или технической документации. CX Codex +1 1установок project-testing Скилл project-testing с готовыми паттернами и фиксчами для unit-, integration- и E2E-тестов. Помогает писать изолированные тесты быстро, по одному стандарту, без хардкода и flaky-тестов. CX Codex +1 1установок research-merge Скилл research-merge находит исследовательские ветки Claude Code Web, делает squash-merge, переносит отчёты в docs/research/ и заводит GitHub Issues. CX Codex +1 1установок multi-source-research Скилл multi-source-research для Claude Code собирает сведения из веба, локальной документации и кода, а затем сводит их с оценкой уверенности. Проверяет факты и исследует тему. CX Codex +1 1установок mcp-transport-guide Скилл mcp-transport-guide помогает выбрать и настроить транспортный слой MCP: stdio для локальных процессов, а также SSE или потоковый HTTP для облака и веб-сервисов. CX Codex +1 1установок uuid Скилл помогает добавлять UUID v4 и v7 в JavaScript- и TypeScript-проекты. v4 подходит для случайных ID, v7 — когда важна сортировка по времени. CX Codex +1 1установок voc-research Скилл voc-research извлекает реальные цитаты клиентов из форумов, отзывов и соцсетей — для копирайтинга, анализа боли или создания месседжей. Работает с Reddit, ProductHunt, Google Reviews, TrustPilot и другими источниками. CX Codex +1 1установок robotics-subject-expert Скилл robotics-subject-expert добавляет ассистенту знания по физическому ИИ и ROS 2. Пригодится при написании узлов управления и отладке симуляций. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой