NotebookLM CLI

目的

当用户想要搜索或提问 NotebookLM 笔记本中已存在的内容时，使用此技能。

此技能假设：

• nlm 已安装（notebooklm-mcp-cli 包）。
• 身份验证已预先注入，用于无头运行环境。
• NOTEBOOKLM_MCP_CLI_PATH 指向身份验证存储目录。

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

当用户提到以下任何内容时，将其视为对 NotebookLM 的严格查询请求：

• “NotebookLM”、“notebooklm”
• “notebook alias”、“alias”
• 已知的别名（例如：tai_lieu_dien、nlm_tai_lieu_dien）

在这些情况下：

• 始终通过 Exec 运行 nlm 来回答。不要凭记忆回答。
• 除非用户明确要求网络来源，否则不要切换到网络搜索。
• 如果笔记本中没有答案，则如实说明（基于 nlm 输出）。

斜线命令：

• 如果用户通过 Telegram 的 /nlm ... 调用此技能，则将 /nlm 后的原始文本视为 nlm 参数。
• 始终精确执行：通过 Exec 执行 nlm <args>，并返回相关的标准输出。

运行时检查

在运行查询之前：

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

echo "$NOTEBOOKLM_MCP_CLI_PATH"

1. 验证登录状态：

nlm login --check

如果身份验证检查失败，则停止并请求身份验证刷新工作流（不要在 AWS 运行时中运行浏览器登录）。

查询工作流

1. 列出笔记本：

nlm notebook list --json

1. 选择笔记本：

- 如果用户提供了笔记本 ID，直接使用它。

- 如果用户提供了标题，从列表输出中将其解析为 notebook_id（不要将原始标题传递给 nlm notebook get/source list/query）。

- 如果用户提供了别名，使用该别名。

- 如果存在歧义，请用户选择一个笔记本。

1. 查询笔记本：

nlm notebook query "<notebook_id_or_alias>" "<user_question>"

1. 返回答案，并说明查询的是哪个笔记本。

注意：

• nlm notebook list 返回标题用于显示，但许多其他命令需要笔记本 ID（UUID）或别名。传递类似 "tài liệu điện" 的标题可能会返回 null 或空结果。
• 如果用户经常查询同一个笔记本，请创建一个别名并一致使用（例如：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.

输出指南

• 明确说明笔记本身份（标题 + ID，如果有）。
• 如果查询结果为空或模糊，建议进行精炼的后续查询。
• 优先使用简洁、基于事实的答案，这些答案源自 NotebookLM 的响应。

常见错误

• Authentication expired / 401 / 403：

- 检查 NOTEBOOKLM_MCP_CLI_PATH。

- 确保 profiles/default/cookies.json 和 profiles/default/metadata.json 存在。

- 在 AWS 外部（带有浏览器的机器）刷新 cookie，然后重新部署密钥。

• nlm: command not found：

- 安装包：pipx install notebooklm-mcp-cli（推荐），或 uv tool install notebooklm-mcp-cli。

命令参考

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

# 按 ID 或别名查询笔记本
nlm notebook query "<notebook_id_or_alias>" "<question>"

# 检查身份验证状态
nlm login --check