Pantheon-Security/notebooklm-mcp-secure

Add Notebook

Добавьте блокнот NotebookLM в локальную библиотеку после явного подтверждения пользователя. Предоставьте URL NotebookLM и краткие метаданные: название, описание, темы, а также опциональные варианты использования/теги. Не додумывайте недостающие метаданные; сначала спросите пользователя.

Add Source

Добавить источник в существующий ноутбук NotebookLM. Если не указаны ни `notebook_id`, ни `notebook_url`, этот инструмент использует текущий активный ноутбук из локальной библиотеки. ## Типы источников - **url**: URL веб-страницы - **text**: Текстовое содержимое (вставка) - **file**: Путь к локальному файлу (PDF, DOCX, TXT) ## Пример ```json { "notebook_id": "my-notebook", "source": { "type": "url", "value": "https://docs.example.com/api" } } ```

Ask NotebookLM

NotebookLM: ответы на вопросы по заметкам через автоматизацию браузера. Нет активной заметки. Используйте list_notebooks и select_notebook, чтобы выбрать заметку, или передайте notebook_url. Ключ API Gemini не требуется, но авторизация в браузере должна быть действительной. Если требуется вход, используйте инструмент setup_auth и проверьте с помощью get_health (или попросите пользователя выполнить запрос notebooklm.auth-setup для пошаговой инструкции).

Batch Create

Создайте несколько блокнотов NotebookLM одной операцией. ## Что делает этот инструмент - Создаёт до 10 блокнотов за одну пакетную операцию - Сообщает о прогрессе по каждому блокноту - При необходимости продолжает работу при ошибке или останавливается при первом сбое - Автоматически добавляет созданные блокноты в вашу библиотеку ## Пример использования ```json { "notebooks": [ { "name": "React Documentation", "sources": [ { "type": "url", "value": "https://react.dev/reference" } ], "topics": ["react", "frontend"] }, { "name": "Node.js API", "sources": [ { "type": "url", "value": "https://nodejs.org/api/" } ], "topics": ["nodejs", "backend"] } ], "stop_on_error": false } ``` ## Ограничения - Максимум 10 блокнотов за одну операцию - Для каждого блокнота действуют индивидуальные ограничения на источники (50-600 в зависимости от тарифа) - Между блокнотами добавляются задержки, чтобы избежать ограничения частоты запросов ## Возвращает Сводку, содержащую: - total: количество попыток создания блокнотов - succeeded: количество успешно созданных - failed: количество неудачных - results: массив результатов по каждому блокноту

Create Notebook

Создаёт новый блокнот NotebookLM с источниками программно. ## Что делает этот инструмент - Создаёт НОВЫЙ блокнот в вашей учётной записи NotebookLM - Загружает источники (URL, текст, файлы) в блокнот - Возвращает ссылку на блокнот для немедленного использования - При необходимости добавляет в локальную библиотеку ## Поддерживаемые типы источников - **url**: URL веб-страницы (документация, статьи и т.д.) - **text**: Неформатированный текст (код, заметки и т.д.) - **file**: Путь к локальному файлу (PDF, DOCX, TXT) ## Пример использования Создать блокнот из документации API: ```json { "name": "React Docs", "sources": [ { "type": "url", "value": "https://react.dev/reference/react" } ] } ``` Создать блокнот с несколькими источниками: ```json { "name": "Security Research", "sources": [ { "type": "url", "value": "https://owasp.org/Top10" }, { "type": "file", "value": "/path/to/security-report.pdf" }, { "type": "text", "value": "Custom notes...", "title": "My Notes" } ], "description": "Security best practices and research", "topics": ["security", "owasp", "best-practices"] } ``` ## Лимиты NotebookLM (бесплатный тариф) - Максимум 100 блокнотов - 50 источников на блокнот - 500 тыс. слов на источник - 50 запросов в день ## Примечания - Требуется авторизация (сначала выполните setup_auth) - Блокнот создаётся с приватным доступом по умолчанию - Большие файлы могут обрабатываться дольше

Download Audio

Загрузить сгенерированный аудиофайл обзора. ## Требования - Аудио должно быть в статусе "ready" - Перед загрузкой проверьте статус с помощью get_audio_status ## Результат Загружается в указанный путь или в ~/notebooklm-audio-{timestamp}.mp3 ## Пример ```json { "notebook_id": "my-research", "output_path": "/path/to/save/podcast.mp3" } ```

Generate Audio

Генерирует аудиообзор на основе ИИ (в стиле подкаста) для блокнота. ## Что делает этот инструмент - Запускает генерацию аудиообзора в NotebookLM - Аудиообзоры длятся 5–15 минут, стиль — подкаст - Генерация обычно занимает 2–5 минут - Возвращает статус сразу (проверять через get_audio_status) ## Требования - В блокноте должен быть хотя бы один источник - Генерация аудио может быть недоступна для некоторых блокнотов ## Пример ```json { "notebook_id": "my-research" } ```

Generate Table

Генерирует структурированную таблицу данных из источников ноутбука. ## Что делает этот инструмент - Открывает панель Studio в NotebookLM - Создаёт структурированное табличное извлечение из содержимого ноутбука - Таблицы упорядочивают ключевую информацию из источников по строкам и столбцам - Генерация обычно занимает 1-3 минуты - Возвращает результат немедленно со статусом (проверьте через get_data_table) ## Требования - Ноутбук должен содержать хотя бы один источник - Требуется аутентификация (сначала выполните setup_auth) ## Пример ```json { "notebook_id": "my-research" } ```

Generate Video

Создайте AI-видеообзор для блокнота. ## Что делает этот инструмент - Открывает панель Studio в NotebookLM - Генерирует визуальное видео-резюме содержимого блокнота - Поддерживает несколько визуальных стилей и форматов - Обычно генерация занимает 3-10 минут - Возвращает статус сразу (проверяйте с помощью get_video_status) - NotebookLM в настоящее время не предоставляет поддерживаемый путь скачивания видео через этот MCP-сервер; используйте интерфейс NotebookLM для скачивания готовых видео. ## Визуальные стили - **авто-выбор** — NotebookLM выбирает лучший стиль (по умолчанию) - **кастомный** — Пользовательский визуальный стиль - **классический** — Классический стиль презентации - **доска** — Стиль рукописной доски - **кавай** — Милый стиль кавай - **аниме** — Визуал в стиле аниме - **акварель** — Стиль акварельного рисунка - **ретро-печать** — Эстетика ретро-печати - **традиционный** — Традиционный/наследие стиль - **поделка из бумаги** — Визуальный стиль поделки из бумаги ## Форматы - **подробно** — Полное объяснение (5-15 мин, по умолчанию) - **кратко** — Быстрое резюме (1-3 мин) ## Требования - В блокноте должен быть хотя бы один источник - Требуется аутентификация (сначала выполните setup_auth) ## Пример ```json { "notebook_id": "my-research", "style": "whiteboard", "format": "brief" } ```

Audio Status

Проверяет статус генерации аудио-обзора для блокнота. ## Возвращает - status: "not_started" | "generating" | "ready" | "failed" | "unknown" - progress: Прогресс генерации (0-100), если генерируется - duration: Длительность аудио в секундах, если готов ## Пример ```json { "notebook_id": "my-research" } ```

Get Table

Извлекает содержимое созданной таблицы данных из блокнота. ## Что делает этот инструмент - Переходит к панели Studio блокнота - Извлекает данные таблицы (заголовки и строки) в виде структурированного JSON - Возвращает полное содержимое таблицы для анализа ## Возвращает - table.headers: заголовки столбцов - table.rows: массив строк (каждая строка — массив) - table.totalRows: количество строк - table.totalColumns: количество столбцов ## Требования - Сначала нужно создать таблицу данных (используйте generate_data_table) - Возвращает ошибку, если таблица ещё не готова ## Пример ```json { "notebook_id": "my-research" } ```

Health Check

Получить статус сервера: состояние аутентификации, активные сессии и конфигурацию. Используйте это, чтобы убедиться, что сервер готов перед запуском исследовательских процессов. **Deep Check Mode (v2026.1.1)** Установите `deep_check: true`, чтобы по-настоящему проверить, загружается ли чат-интерфейс NotebookLM. Это ловит устаревшие сессии, когда куки есть, но интерфейс не грузится. Возвращает `chat_ui_accessible: true/false`. Если authenticated=false и проблемы не проходят: Предложите пользователю, что чистый старт (cleanup_data с preserve_library=true, а затем setup_auth) может помочь, и попросите его подтверждения перед запуском очистки, так как cleanup_data удаляет данные браузера/сессии.

Get Notebook

Получить подробную информацию о конкретном блокноте по ID.

Get Quota

Получить текущий статус квоты, включая уровень лицензии, использование и лимиты. Возвращает: - tier: 'free', 'pro', 'ultra' или 'unknown' - notebooks: использовано/лимит/осталось/процент - sources: лимит источников на блокнот - queries: использовано/лимит/осталось/процент/should_stop/время_сброса - warnings: массив предупреждающих сообщений Лимиты квот по уровням: - Free: 100 блокнотов, 50 источников/блокнот, 50 запросов/день - Pro: 500 блокнотов, 300 источников/блокнот, 500 запросов/день - Ultra: 500 блокнотов, 600 источников/блокнот, 5000 запросов/день Используйте sync=true, чтобы получить актуальную квоту из интерфейса Google NotebookLM (требуется браузер). Без sync возвращаются локально отслеживаемые счётчики, которые могут отличаться, если вы использовали NotebookLM напрямую в браузере. Счётчики запросов сбрасываются ежедневно в полночь.

Video Status

Проверить статус генерации видео-обзора для блокнота. ## Возвращает - status: "not_started" | "generating" | "ready" | "failed" | "unknown" - progress: прогресс генерации (0-100), если статус "generating" - duration: длительность видео в секундах, если статус "ready" ## Пример ```json { "notebook_id": "my-research" } ```

List Notebooks

Выведите список всех библиотечных ноутбуков с метаданными (название, темы, варианты использования, URL). Используйте это, чтобы представить варианты, затем спросите, какой ноутбук использовать для задачи.

List Sources

Выводит список источников в блокноте. Укажите notebook_id или notebook_url; если не указано ни то, ни другое, используется активный блокнот из локальной библиотеки. Возвращает id источника, название, тип и статус.

Re-authenticate

Переключиться на другой аккаунт Google или пройти повторную аутентификацию. Используй это, когда: - Достигнут лимит запросов NotebookLM (50 запросов в день для бесплатных аккаунтов) - Нужно переключиться на другой аккаунт Google - Аутентификация сломалась и требуется начать заново Это: 1. Закроет все активные сессии браузера 2. Удалит все сохранённые данные аутентификации (куки, профиль Chrome) 3. Откроет браузер для новой авторизации в Google После завершения используй get_health, чтобы проверить аутентификацию. УСТРАНЕНИЕ НЕИСПРАВНОСТЕЙ при постоянных проблемах с аутентификацией: Если re_auth повторно не срабатывает, предложи пользователю следующие шаги и спроси его подтверждение перед выполнением любой очистки (cleanup_data удаляет данные браузера/сессии и установки): 1. Попроси пользователя закрыть ВСЕ экземпляры Chrome/Chromium 2. Запусти cleanup_data(confirm=false, preserve_library=true) для предпросмотра файлов, которые будут удалены 3. Только после того, как пользователь просмотрит предпросмотр и подтвердит, запусти cleanup_data(confirm=true, preserve_library=true) — очистит всё, кроме библиотеки 4. Снова запусти re_auth для полностью чистого старта Это удалит старые данные установки и сессии браузера, которые могут вызывать конфликты.

Remove Notebook

Опасно: требует явного подтверждения пользователя. ## Процедура подтверждения 1) Пользователь запрашивает удаление (например: «Удали React notebook») 2) Уточни полное название для подтверждения 3) Спроси: «Удалить „[notebook_name]“ из вашей библиотеки? (Это не удаляет сам NotebookLM-ноутбук)» 4) Только после явного «Да» — вызывай remove_notebook Никогда не удаляй без разрешения или на основе предположений. Пример: Пользователь: «Удалить старый React notebook» Вы: «Удалить „React Best Practices“ из вашей библиотеки?» Пользователь: «Да» → вызывать remove_notebook

Remove Source

Удаляет источник из записной книжки NotebookLM. Если не указаны ни `notebook_id`, ни `notebook_url`, этот инструмент использует активную записную книжку из локальной библиотеки. ## Использование 1. Сначала вызовите list_sources, чтобы получить идентификаторы источников 2. Затем вызовите remove_source с идентификатором источника ## Пример ```json { "notebook_id": "my-notebook", "source_id": "source-0" } ```

Search Notebooks

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

Select Notebook

Устанавливает блокнот как активный по умолчанию (используется, когда ask_question вызывается без notebook_id). ## Когда использовать - Пользователь меняет контекст: «Давай теперь поработаем с React» - Пользователь явно просит активировать блокнот - Очевидная смена задачи требует другого блокнота ## Автоматическое переключение - Можно безопасно переключать, если контекст понятен, и ты сообщаешь об этом: «Переключаю на блокнот React для этой задачи...» - Если неоднозначно, спроси: «Переключить на [блокнот] для этой задачи?» ## Пример Пользователь: «Теперь давай соберём фронтенд на React» Ты: «Переключаю на блокнот React...» (вызов select_notebook)

Setup Auth

Google-аутентификация для доступа к NotebookLM — открывает окно браузера для ручного входа в ваш аккаунт Google. Возвращает результат сразу после открытия браузера. На завершение входа у вас есть до 10 минут. Затем используйте инструмент 'get_health', чтобы убедиться, что аутентификация сохранена успешно. Используйте этот способ для первой аутентификации или если нет учетных данных для автоматического входа. Для смены аккаунта или обхода ограничений по количеству запросов используйте инструмент 're_auth'. УСТРАНЕНИЕ НЕИСПРАВНОСТЕЙ для постоянных проблем с аутентификацией: Если setup_auth не срабатывает или возникают проблемы с браузером/сессией, предложите пользователю следующие шаги и получите его подтверждение перед любыми действиями по очистке (cleanup_data удаляет данные браузера/сессии): 1. Попросите пользователя закрыть ВСЕ экземпляры Chrome/Chromium 2. Спросите пользователя перед запуском cleanup_data(confirm=true, preserve_library=true) для очистки старых данных 3. Снова запустите setup_auth для нового старта Это помогает устранить конфликты от старых сессий браузера и данных установки.

Sync Library

Синхронизируйте свою локальную библиотеку с реальными блокнотами NotebookLM. ## Что делает этот инструмент - Переходит в NotebookLM и извлекает все ваши блокноты - Сравнивает с записями локальной библиотеки - Обнаруживает устаревшие записи (блокноты удалены или изменились URL) - Определяет блокноты, которых нет в вашей библиотеке - Опционально автоматически удаляет устаревшие записи ## Когда использовать - Библиотека выглядит рассинхронизированной с NotebookLM - После удаления блокнотов в NotebookLM - Чтобы найти новые блокноты для добавления - Перед настройкой автоматизированных рабочих процессов ## Результат Возвращает отчёт о синхронизации с: - **matched**: Записи библиотеки, соответствующие реальным блокнотам - **staleEntries**: Записи библиотеки без совпадающего блокнота (кандидаты на удаление) - **missingNotebooks**: Блокноты NotebookLM, отсутствующие в библиотеке (кандидаты на добавление) - **suggestions**: Рекомендуемые действия ## Пример использования ```json { "auto_fix": false } ``` С авто-исправлением (удаление устаревших записей): ```json { "auto_fix": true } ```

Update Notebook

Обновить метаданные блокнота на основе намерения пользователя. ## Шаблон 1) Определить целевой блокнот и поля (topics, description, use_cases, tags, url) 2) Предложить точное изменение пользователю 3) После явного подтверждения вызвать этот инструмент ## Примеры - Пользователь: "React notebook also covers Next.js 14" Вы: "Добавить 'Next.js 14' в topics для React?" Пользователь: "Да" → вызывать update_notebook - Пользователь: "Include error handling in n8n description" Вы: "Обновить описание n8n, чтобы упоминалась обработка ошибок?" Пользователь: "Да" → вызывать update_notebook Подсказка: Если нужно, можно обновить несколько полей одновременно.