NotebookLM Claude Code Skill

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

Используйте этот навык, чтобы обращаться к своим блокнотам Google NotebookLM напрямую из Claude Code и получать от Gemini ответы с опорой на источники и цитатами. Автоматизация браузера, управление библиотекой, сохраняемая аутентификация. Радикально меньше галлюцинаций — ответы только из ваших загруженных документов.

Установка • Быстрый старт • Почему NotebookLM • Как это работает • Альтернатива через MCP

⚠️ Важно: только локальный Claude Code

Этот навык работает ТОЛЬКО с локальной установкой Claude Code, НЕ в веб-интерфейсе.

Веб-интерфейс запускает навыки в песочнице без доступа к сети, которая необходима этому навыку для автоматизации браузера. Вы должны использовать Claude Code локально на своём компьютере.

Проблема

Когда вы просите Claude Code «поискать в моей локальной документации», происходит следующее: - Огромный расход токенов: поиск по документации означает многократное чтение множества файлов - Неточный поиск: ищет по ключевым словам, упуская контекст и связи между документами - Галлюцинации: когда не может что-то найти, выдумывает правдоподобно звучащие API - Ручное копирование: постоянное переключение между браузером с NotebookLM и вашим редактором

Решение

Этот навык Claude Code позволяет Claude Code напрямую общаться с NotebookLM — базой знаний с опорой на источники от Google на базе Gemini 2.5, которая выдаёт интеллектуальные синтезированные ответы исключительно по вашим загруженным документам.

Your Task → Claude asks NotebookLM → Gemini synthesizes answer → Claude writes correct code

Больше никаких «танцев» с копипастом: Claude задаёт вопросы напрямую и получает ответы сразу в CLI. Он выстраивает глубокое понимание с помощью автоматических уточняющих вопросов, получая конкретные детали реализации, граничные случаи и лучшие практики.

Почему NotebookLM, а не локальный RAG?

Что делает NotebookLM превосходным?

1. Предварительная обработка силами Gemini: загрузите документы один раз — получите мгновенные экспертные знания
2. Вопросы и ответы на естественном языке: не просто поиск — настоящее понимание и синтез
3. Корреляция нескольких источников: связывает информацию между 50+ документами
4. Ответы со ссылками на источники: каждый ответ содержит ссылки на источники
5. Никакой инфраструктуры: не нужны векторные базы данных, эмбеддинги или стратегии чанкинга

Установка

Самая простая установка в истории:

# 1. Create skills directory (if it doesn't exist)
mkdir -p ~/.claude/skills

# 2. Clone this repository
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

# 3. That's it! Open Claude Code and say:
"What are my skills?"

При первом использовании навыка он автоматически: - Создаёт изолированное окружение Python (.venv) - Устанавливает все зависимости, включая Google Chrome - Настраивает автоматизацию браузера с Chrome (не Chromium) для максимальной надёжности - Всё остаётся внутри папки навыка

Примечание: при настройке используется настоящий Chrome вместо Chromium ради кроссплатформенной надёжности, стабильного отпечатка браузера и лучшей защиты от обнаружения со стороны сервисов Google

Быстрый старт

1. Проверьте свои навыки

Скажите в Claude Code:

"What skills do I have?"

Claude перечислит ваши доступные навыки, включая NotebookLM.

2. Аутентификация в Google (один раз)

"Set up NotebookLM authentication"

Открывается окно Chrome → войдите в свой аккаунт Google

3. Создайте свою базу знаний

Перейдите на notebooklm.google.com → Создать блокнот → Загрузите свои документы: - 📄 PDF-файлы, Google Документы, markdown-файлы - 🔗 Веб-сайты, репозитории GitHub - 🎥 Видео на YouTube - 📚 Несколько источников в одном блокноте

Поделиться: ⚙️ Поделиться → Все, у кого есть ссылка → Копировать

4. Добавьте в свою библиотеку

Вариант A: Пусть Claude разберётся сам (умное добавление)

"Query this notebook about its content and add it to my library: [your-link]"

Claude автоматически опросит блокнот, чтобы определить его содержимое, а затем добавит его с соответствующими метаданными.

Вариант B: Ручное добавление

"Add this NotebookLM to my library: [your-link]"

Claude запросит название и темы, а затем сохранит их для использования в будущем.

5. Начните исследования

"What does my React docs say about hooks?"

Claude автоматически выбирает нужный блокнот и получает ответ напрямую из NotebookLM.

Как это работает

Это навык (Skill) для Claude Code — локальная папка с инструкциями и скриптами, которые Claude Code может использовать при необходимости. В отличие от версии в виде MCP-сервера, этот вариант работает напрямую в Claude Code и не требует отдельного сервера.

Ключевые отличия от MCP-сервера

Архитектура

~/.claude/skills/notebooklm/
├── SKILL.md              # Instructions for Claude
├── scripts/              # Python automation scripts
│   ├── ask_question.py   # Query NotebookLM
│   ├── notebook_manager.py # Library management
│   └── auth_manager.py   # Google authentication
├── .venv/                # Isolated Python environment (auto-created)
└── data/                 # Local notebook library

Когда вы упоминаете NotebookLM или отправляете URL блокнота, Claude: 1. Загружает инструкции навыка 2. Запускает соответствующий Python-скрипт 3. Открывает браузер и задаёт ваш вопрос 4. Возвращает ответ напрямую вам 5. Использует эти знания, чтобы помочь с вашей задачей

Основные возможности

Ответы, основанные на источниках

NotebookLM значительно снижает риск галлюцинаций, отвечая исключительно на основе загруженных вами документов. Если информации нет, он указывает на неопределённость, а не выдумывает содержание.

Прямая интеграция

Не нужно ничего копировать между браузером и редактором. Claude задаёт вопросы и получает ответы программно.

Умное управление библиотекой

Сохраняйте ссылки на блокноты NotebookLM с тегами и описаниями. Claude автоматически выбирает подходящий блокнот для вашей задачи.

Автоматическая аутентификация

Достаточно один раз войти в Google — аутентификация сохраняется во всех последующих сессиях.

Автономность

Всё работает внутри папки навыка с изолированным окружением Python. Никаких глобальных установок.

Человекоподобная автоматизация

Использует реалистичную скорость печати и паттерны взаимодействия, чтобы избежать обнаружения.

Часто используемые команды

Примеры из реальной практики

Пример 1: Запрос к руководству по ремонту

Пользователь спрашивает: «Проверь в моём руководстве по ремонту Suzuki GSR 600 тип тормозной жидкости, характеристики моторного масла и момент затяжки задней оси».

Claude автоматически: - Проходит аутентификацию в NotebookLM - Задаёт развёрнутые вопросы по каждой характеристике - Уточняет детали, когда ему говорят: «Это ВСЁ, что тебе нужно знать?» - Предоставляет точные характеристики: тормозная жидкость DOT 4, масло SAE 10W-40, момент затяжки задней оси 100 Н·м

Пример 2: Разработка без галлюцинаций

Вы: «Мне нужно собрать n8n-воркфлоу для фильтрации спама в Gmail. Используй мой блокнот по n8n».

Внутренний процесс Claude:

→ Loads NotebookLM skill
→ Activates n8n notebook
→ Asks comprehensive questions with follow-ups
→ Synthesizes complete answer from multiple queries

Результат: Рабочий воркфлоу с первой попытки — не нужно отлаживать выдуманные API.

Технические детали

Основные технологии

• Patchright: библиотека для автоматизации браузера (на основе Playwright)
• Python: язык реализации этого навыка
• Техники скрытности: человекоподобная скорость печати и паттерны взаимодействия

Примечание: MCP-сервер использует ту же библиотеку Patchright, но через экосистему TypeScript/npm.

Зависимости

• patchright==1.55.2: автоматизация браузера
• python-dotenv==1.0.0: Конфигурация окружения
• Автоматически устанавливается в .venv при первом использовании

Хранение данных

Все данные хранятся локально внутри директории навыка:

~/.claude/skills/notebooklm/data/
├── library.json       - Your notebook library with metadata
├── auth_info.json     - Authentication status info
└── browser_state/     - Browser cookies and session data

Важное примечание о безопасности: - Директория data/ содержит конфиденциальные данные аутентификации и личные блокноты - Она автоматически исключается из git через .gitignore - НИКОГДА не коммитьте вручную и не делитесь содержимым директории data/

Модель сессий

В отличие от MCP-сервера, этот навык использует бессостоянийную модель (stateless): - Каждый вопрос открывает новый браузер - Задаёт вопрос, получает ответ - Добавляет дополнительный запрос (follow-up), чтобы побудить Claude задавать больше вопросов - Немедленно закрывает браузер

Это означает: - Отсутствие постоянного контекста чата - Каждый вопрос независим - Но ваша библиотека блокнотов сохраняется - Механизм уточняющих вопросов: каждый ответ включает фразу «Это ВСЁ, что вам нужно знать?», чтобы побудить Claude задавать исчерпывающие уточняющие вопросы

Для многоэтапных исследований Claude автоматически задаёт уточняющие вопросы при необходимости.

Ограничения

Специфичные для навыка

• Только локальный Claude Code — не работает в веб-интерфейсе (ограничения песочницы)
• Нет сохранения сессии — каждый вопрос независим
• Нет контекста уточнений — невозможно сослаться на «предыдущий ответ»

NotebookLM

• Лимиты запросов — бесплатный тариф имеет дневные ограничения на количество запросов
• Ручная загрузка — сначала необходимо загрузить документы в NotebookLM
• Требование общего доступа — блокноты должны быть открыты для публичного доступа

FAQ

Почему это не работает в веб-интерфейсе Claude? Веб-интерфейс запускает навыки в песочнице без доступа к сети. Для автоматизации браузера требуется сетевой доступ, чтобы связаться с NotebookLM.

Чем это отличается от MCP-сервера? Это более простая реализация на Python, которая работает напрямую как навык Claude. MCP-сервер более функциональный, с постоянными сессиями, и работает с несколькими инструментами (Codex, Cursor и т.д.).

Можно ли использовать одновременно и этот навык, и MCP-сервер? Да! Они служат разным целям. Используйте навык для быстрой интеграции с Claude Code, а MCP-сервер — для постоянных сессий и поддержки нескольких инструментов.

Что делать, если Chrome аварийно завершает работу? Выполните: «Очистить данные браузера NotebookLM» и попробуйте снова.

Безопасен ли мой аккаунт Google? Chrome запускается локально на вашем компьютере. Ваши учётные данные никогда не покидают ваш компьютер. Если вы обеспокоены, используйте отдельный аккаунт Google.

Устранение неполадок

Навык не найден

# Make sure it's in the right location
ls ~/.claude/skills/notebooklm/
# Should show: SKILL.md, scripts/, etc.

Проблемы с аутентификацией

Скажите: «Сбросить аутентификацию NotebookLM»

Аварийное завершение работы браузера

Скажите: «Очистить данные браузера NotebookLM»

Проблемы с зависимостями

# Manual reinstall if needed
cd ~/.claude/skills/notebooklm
rm -rf .venv
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install -r requirements.txt

Отказ от ответственности

Этот инструмент автоматизирует взаимодействие с браузером с NotebookLM, чтобы сделать ваш рабочий процесс более эффективным. Однако несколько дружеских напоминаний:

Об автоматизации браузера: Хотя я встроил функции гуманизации (реалистичная скорость набора текста, естественные задержки, движения мыши), чтобы автоматизация вела себя более естественно, я не могу гарантировать, что Google не обнаружит и не пометит автоматизированное использование. Я рекомендую использовать для автоматизации отдельный аккаунт Google, а не основной — думайте об этом как о веб-скрейпинге: скорее всего всё нормально, но лучше перестраховаться!

О CLI-инструментах и ИИ-агентах: CLI-инструменты вроде Claude Code, Codex и подобных ИИ-ассистентов невероятно мощны, но они могут ошибаться. Пожалуйста, используйте их осторожно и осознанно: - Всегда проверяйте изменения перед коммитом или развёртыванием - Сначала тестируйте в безопасных средах - Делайте резервные копии важной работы - Помните: ИИ-агенты — это помощники, а не непогрешимые оракулы

Я создал этот инструмент для себя, потому что устал от танцев с копированием и вставкой между NotebookLM и моим редактором. Я делюсь им в надежде, что он поможет и другим, но не могу взять на себя ответственность за возможные проблемы, потерю данных или проблемы с аккаунтом. Используйте его на своё усмотрение и по собственному суждению.

Тем не менее, если вы столкнётесь с проблемами или у вас возникнут вопросы, не стесняйтесь открыть issue на GitHub. Я с радостью помогу разобраться!

Благодарности

Этот навык вдохновлён моим NotebookLM MCP Server и представляет собой альтернативную реализацию в виде навыка Claude Code: - Оба используют Patchright для автоматизации браузера (TypeScript для MCP, Python для навыка) - Версия навыка работает напрямую в Claude Code без протокола MCP - Бессостоянийный дизайн, оптимизированный под архитектуру навыков

Если вам нужно: - Постоянные сессии → Используйте MCP Server - Поддержка нескольких инструментов (Codex, Cursor) → Используйте MCP Server - Быстрая интеграция с Claude Code → Используйте этот skill

Итог

Без этого skill: NotebookLM в браузере → Скопировать ответ → Вставить в Claude → Скопировать следующий вопрос → Вернуться в браузер...

С этим skill: Claude исследует напрямую → Мгновенно получает ответы → Пишет корректный код

Хватит танцевать с копированием и вставкой. Начните получать точные, основанные на источниках ответы прямо в Claude Code.

# Get started in 30 seconds
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# Open Claude Code: "What are my skills?"

Создано как адаптация Claude Code Skill моего NotebookLM MCP Server

Для исследований, основанных на источниках и документах, прямо в Claude Code