NotebookLM CLI

用途

当用户希望在 NotebookLM 笔记本中已存在的内容上执行搜索或提问时，使用此技能。

该技能的前提假设如下：

• nlm 已安装（即已安装 notebooklm-mcp-cli 包）。
• 认证信息已在无头（headless）运行环境中预先注入。
• NOTEBOOKLM_MCP_CLI_PATH 指向认证信息存储目录。

硬性规则（避免错误的工具选择）

当用户提及以下任意一项时，视为明确要求查询 NotebookLM，必须严格按此处理：

• "NotebookLM"、"notebooklm"
• "notebook alias"、"alias"
• 一个已知的别名（例如：tai_lieu_dien、nlm_tai_lieu_dien）

在此类情况下：

• 必须通过 Exec 执行 nlm 命令来回答问题，禁止依赖记忆作答。
• 除非用户明确要求检索网页来源，否则不得切换至网络搜索。
• 若 Notebook 中无对应答案，需如实告知（依据 nlm 的输出结果判断）。

斜杠命令（Slash command）：

• 若用户在 Telegram 中通过 /nlm ... 调用该技能，则将 /nlm 后的原始文本整体作为 nlm 的参数。
• 必须精确执行：nlm （通过 Exec），并返回相关的标准输出（stdout）。

运行时检查

执行查询前，请完成以下检查：

1. 验证认证路径是否已配置：

echo "$NOTEBOOKLM_MCP_CLI_PATH"

2. 验证登录状态：

nlm login --check

若认证检查失败，请立即中止操作，并提示用户启动认证刷新流程（禁止在 AWS 运行环境中调用浏览器登录）。

查询工作流

1. 列出笔记本：

nlm notebook list --json

2. 选择笔记本：

• 若用户已提供 notebook id，请直接使用。
• 若用户提供了标题（title），请从上一步 list 输出中解析出对应的 notebook_id（切勿将原始标题字符串直接传入 nlm notebook get/source list/query 等命令）。
• 若用户提供了别名（alias），请直接使用该别名。
• 若存在歧义（例如多个笔记本匹配），请让用户明确选择其中一个。

3. 查询笔记本：

nlm notebook query "" ""

4. 返回答案，并明确指出所查询的笔记本。

注意事项：

• nlm notebook list 返回的是用于显示的标题（title），但多数其他命令仅接受 notebook id（UUID）或别名（alias）。直接传递类似 "tài liệu điện" 的标题可能导致空结果或无响应。
• 若用户需频繁查询同一笔记本，建议为其创建并持续使用一个别名（例如：tai_lieu_dien）。

Telegram 提示模板（可直接复制粘贴）

推荐使用以下任一格式，以确保稳定触发本技能：

1. 强制 CLI 查询格式：

Chạy lệnh: nlm notebook query tai_lieu_dien "giá của A9N61500 là bao nhiêu? Nếu notebook không có thông tin giá thì trả lời: không thấy trong NotebookLM."

2. 自然语言但显式声明：

Trong NotebookLM notebook alias tai_lieu_dien: trả lời câu hỏi "giá của A9N61500 là bao nhiêu?". Bắt buộc dùng nlm để truy vấn, không tìm web, không đọc file local.

输出规范

• 须明确说明被查询笔记本的身份（如有，同时提供 title 与 id）。
• 若查询结果为空或含义模糊，请建议更精准的后续查询语句。
• 优先采用简洁、客观、基于 NotebookLM 实际响应的事实性答案。

常见错误

• Authentication expired / 401 / 403：
  • 检查 NOTEBOOKLM_MCP_CLI_PATH 是否配置正确。
  • 确认 profiles/default/cookies.json 和 profiles/default/metadata.json 文件存在。
  • 在非 AWS 环境（即具备浏览器的本地机器）中刷新 cookies，然后重新部署密钥（secret）。
• nlm: command not found：
  • 安装包：pipx install notebooklm-mcp-cli（推荐），或 uv tool install notebooklm-mcp-cli。

命令参考

# 列出笔记本
nlm notebook list --json

# 按 notebook id 或 alias 查询笔记本
nlm notebook query "" ""

# 检查认证状态
nlm login --check