# NotebookLM MCP Suite (Unified CLI & Multi-Browser MCP Server)

Bộ công cụ toàn diện gộp từ [jacob-bd/gemini-notebook-mcp-cli](https://github.com/jacob-bd/gemini-notebook-mcp-cli) và [evolialexwing34/notebooklm-auth-helper](https://github.com/evolialexwing34/notebooklm-auth-helper).

Công cụ này cung cấp **MCP Server** và **CLI Tool (`nlm`)** đầy đủ cho Google NotebookLM, đồng thời hỗ trợ **xác thực tự động trên mọi trình duyệt Chromium** (Cốc Cốc, Microsoft Edge, Brave, Vivaldi, Google Chrome).

---

## 🌟 Tính Năng Nổi Bật

- 🚀 **MCP Server & CLI Đầy Đủ:** Hỗ trợ đầy đủ các lệnh `nlm notebook list`, `nlm query`, `nlm source`, `nlm note`, `nlm audio`, v.v.
- 🌐 **Xác Thực Đa Trình Duyệt (Multi-Browser Auth):** Tự động trích xuất cookie & CSRF token từ profile trình duyệt có sẵn (**Cốc Cốc, Edge, Brave, Vivaldi, Chrome**).
- 🔑 **Domain Resolution Chuẩn:** Hỗ trợ chính xác domain mới `notebook.google.com` và lưu cookie dạng LIST bảo toàn thông tin domain (khắc phục hoàn toàn lỗi 401 Unauthorized).
- 🔄 **Auto Auth Refresh:** Tự động làm mới phiên làm việc khi hết hạn mà không cần đăng nhập lại từ đầu.

---

## 📥 Cài Đặt

```bash
# Cài đặt qua uv (khuyên dùng)
uv tool install notebooklm-mcp-suite

# Hoặc clone repository và cài đặt
git clone https://github.com/evolialexwing34/notebooklm-mcp-suite.git
cd notebooklm-mcp-suite
uv sync
```

---

## 🔑 Hướng Dẫn Xác Thực (Authentication)

### Cách 1: Xác thực tự động từ Trình duyệt (Cốc Cốc, Edge, Brave, Chrome)

1. Đăng nhập Google trên trình duyệt của bạn → truy cập [notebook.google.com](https://notebook.google.com).
2. **Đóng hoàn toàn trình duyệt.**
3. Chạy lệnh trích xuất:

```bash
# Cốc Cốc (tự động phát hiện)
uv run auth_helper.py

# Hoặc chỉ định trình duyệt:
uv run auth_helper.py --browser edge
uv run auth_helper.py --browser brave
uv run auth_helper.py --browser coccoc
```

### Cách 2: Kiểm tra danh sách Notebook

```bash
# Đặt biến môi trường domain mới
set NOTEBOOKLM_BASE_URL=https://notebook.google.com

# Kiểm tra
nlm notebook list
```

---

## ⚙️ Cấu Hình MCP Server (Cho Antigravity / Claude Desktop)

Thêm cấu hình sau vào file `mcp_config.json`:

```json
{
  "mcpServers": {
    "gemini-notebook-mcp": {
      "command": "notebooklm-mcp.exe",
      "args": [],
      "env": {
        "NOTEBOOKLM_BASE_URL": "https://notebook.google.com"
      }
    }
  }
}
```

---

## 📋 Tóm Tắt Lệnh CLI Thường Dùng

| Lệnh | Mô tả |
|---|---|
| `nlm notebook list` | Liệt kê danh sách tất cả các Notebook |
| `nlm query notebook <ID> "<Câu hỏi>"` | Truy vấn trực tiếp kho tri thức của Notebook |
| `nlm source list <ID>` | Liệt kê danh sách các tài liệu nguồn |
| `nlm notebook get <ID>` | Xem thông tin chi tiết Notebook |

---

## 📄 Giấy Phép (License)

MIT License - Tự do sử dụng và phát triển.