Навык агента НоутбукЛМ для Клод Код

Навык БлокнотLM Клод Код

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

Используйте этот навык, чтобы запрашивать ваши записные книжки Google БлокнотLM напрямую из Клод Кода для получения обоснованных источниками ответов от Близнецов с указанием источников. Автоматизация браузера, управление библиотекой, постоянная аутентификация. Значительно сниженные галлюцинации — ответы только из ваших загруженных документов.

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

⚠️ Важно: Только локальный Клод Код

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

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

Проблема

Когда вы говорите Клод Коду "ищи в моей локальной документации", вот что происходит:

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

Решение

Этот навык Клод Код позволяет Клод Коду общаться напрямую с БлокнотLM — источниковой базой знаний Google, основанной на Близнецах 2.5, которая предоставляет интеллектуальные, синтезированные ответы исключительно из ваших загруженных документов.

Ваша задача → Клод спрашивает БлокнотLM → Близнецы синтезируют ответ → Клод пишет правильный код

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

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

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

1. Предварительно обработано Близнецами: Загрузите документы один раз, получите мгновенные экспертные знания
2. Естественно-языковые вопросы и ответы: Не просто извлечение — реальное понимание и синтез
3. Многоисточниковая корреляция: Связывает информацию из более чем 50 документов
4. С указанием источников: Каждый ответ включает ссылки на источники
5. Без инфраструктуры: Не нужны векторные базы данных, векторизация или стратегии разбиения на чанки

Установка

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

# 1. Создайте каталог навыков (если его нет)
mkdir -p ~/.claude/skills

# 2. Клонируйте этот репозиторий
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

# 3. Вот и всё! Откройте Клод Код и скажите:
"Какие у меня навыки?"

При первом использовании навыка он автоматически:

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

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

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

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

Скажите в Клод Коде:

"Какие у меня есть навыки?"

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

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

"Настроить аутентификацию БлокнотLM"

Откроется окно Chrome → войдите в свою учётную запись Google

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

Перейдите на notebooklm.google.com → Создайте записную книжку → Загрузите ваши документы:

• 📄 PDF-файлы, Google Документы, markdown-файлы
• 🔗 Веб-сайты, репозитории GitHub
• 🎥 Видео YouTube
• 📚 Несколько источников на одну записную книжку

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

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

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

"Запроси эту записную книжку о её содержании и добавь в мою библиотеку: [ваша-ссылка]"

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

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

"Добавь этот БлокнотLM в мою библиотеку: [ваша-ссылка]"

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

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

"Что моя документация React говорит о хуках?"

Клод автоматически выберет нужную записную книжку и получит ответ напрямую от БлокнотLM.

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

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

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

Архитектура

~/.claude/skills/notebooklm/
├── SKILL.md              # Инструкции для Клода
├── scripts/              # Скрипты автоматизации Python
│   ├── ask_question.py   # Запрос к БлокнотLM
│   ├── notebook_manager.py # Управление библиотекой
│   └── auth_manager.py   # Аутентификация Google
├── .venv/                # Изолированное окружение Python (автосоздаётся)
└── data/                 # Локальная библиотека записных книжек

Когда вы упоминаете БлокнотLM или отправляете URL записной книжки, Клод:

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

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

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

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

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

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

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

Сохраняйте ссылки БлокнотLM с тегами и описаниями. Клод автоматически выбирает нужную записную книжку для вашей задачи.

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

Однократный вход в Google, затем аутентификация сохраняется между сессиями.

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

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

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

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

Общие команды

Примеры из реальной жизни

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

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

Клод автоматически:

• Аутентифицируется в БлокнотLM
• Задаёт исчерпывающие вопросы по каждой характеристике
• Задаёт уточняющие вопросы при появлении запроса "Это ВСЁ, что вам нужно знать?"
• Предоставляет точные характеристики: тормозная жидкость DOT 4, масло SAE 10W-40, момент затяжки задней оси 100 Н·м

Пример 2: Создание без галлюцинаций

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

Внутренний процесс Клода:

→ Загружает навык БлокнотLM
→ Активирует записную книжку n8n
→ Задаёт исчерпывающие вопросы с уточнениями
→ Синтезирует полный ответ из нескольких запросов

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

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

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

• Patchright: Библиотека автоматизации браузера (на основе Playwright)
• Python: Язык реализации для этого навыка
• Стелс-техники: Человекоподобный набор текста и шаблоны взаимодействия

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

Зависимости

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

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

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

~/.claude/skills/notebooklm/data/
├── library.json       - Ваша библиотека записных книжек с метаданными
├── auth_info.json     - Информация о статусе аутентификации
└── browser_state/     - Куки браузера и данные сессии

Важное замечание по безопасности:

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

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

В отличие от MCP-сервера, этот навык использует модель без сохранения состояния:

• Каждый вопрос открывает новый браузер
• Задаёт вопрос, получает ответ
• Добавляет побуждающий вопрос, чтобы побудить Клода задать больше вопросов
• Немедленно закрывает браузер

Это означает:

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

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

Ограничения

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

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

БлокнотLM

• Ограничения по частоте - Бесплатный уровень имеет дневные лимиты запросов
• Ручная загрузка - Вы должны сначала загрузить документы в БлокнотLM
• Требование общего доступа - Записные книжки должны быть общедоступными

Часто задаваемые вопросы

Почему это не работает в веб-интерфейсе Клода? Веб-интерфейс запускает навыки в песочнице без доступа к сети. Автоматизация браузера требует доступа к сети для подключения к БлокнотLM.

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

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

Что делать, если Chrome вылетает? Выполните: "Очистить данные браузера БлокнотLM" и попробуйте снова.

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

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

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

# Убедитесь, что он находится в правильном месте
ls ~/.claude/skills/notebooklm/
# Должно показать: SKILL.md, scripts/ и т.д.

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

Скажите: "Сбросить аутентификацию БлокнотLM"

Сбои браузера

Скажите: "Очистить данные браузера БлокнотLM"

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

# При необходимости переустановите вручную
cd ~/.claude/skills/notebooklm
rm -rf .venv
python -m venv .venv
source .venv/bin/activate  # или .venv\Scripts\activate в Windows
pip install -r requirements.txt

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

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

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

Об инструментах CLI и AI-агентах: Инструменты командной строки, такие как Клод Код, Codex и подобные AI-ассистенты, невероятно мощны, но они могут ошибаться. Пожалуйста, используйте их с осторожностью и осознанностью:

• Всегда проверяйте изменения перед коммитом или развёртыванием
• Сначала тестируйте в безопасных средах
• Делайте резервные копии важной работы
• Помните: AI-агенты — это помощники, а не непогрешимые оракулы

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

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

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

Этот навык вдохновлён моим MCP-сервером БлокнотLM и предоставляет альтернативную реализацию в виде навыка Клод Код:

• Оба используют Patchright для автоматизации браузера (TypeScript для MCP, Python для навыка)
• Версия навыка работает напрямую в Клод Коде без протокола MCP
• Дизайн без сохранения состояния, оптимизированный под архитектуру навыков

Если вам нужно:

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

Итог

Без этого навыка: БлокнотLM в браузере → Копировать ответ → Вставить в Клод → Копировать следующий вопрос → Обратно в браузер...

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

Прекратите танец копирования-вставки. Начните получать точные, обоснованные ответы напрямую в Клод Коде.

# Начните за 30 секунд
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# Откройте Клод Код: "Какие у меня навыки?"

Создано как адаптация навыка Клод Код моего MCP-сервера БлокнотLM

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