@roomi-fields/notebooklm-mcp 1.5.2 → 1.5.7

package/deployment/PACKAGE-FILES.txt

@@ -1,180 +1,180 @@
-# Files Required for NotebookLM MCP HTTP Server Deployment
-# Version: 1.3.0
-
-================================================================================
-FILES TO COPY FROM MAIN PROJECT
-================================================================================
-
-## Root Files
-/package.json
-/package-lock.json
-/tsconfig.json
-/.gitignore
-/LICENSE               → MIT License (original project + HTTP wrapper)
-/README.md             → Project overview
-/CHANGELOG.md          → Version history
-/CONTRIBUTING.md       → Contribution guide
-/CREDITS.md            → Credits and acknowledgments
-
-## Source Code (src/)
-/src/**/*
-
-src/ content details:
-- /src/auth/          → Google authentication management
-- /src/config.ts      → Central configuration
-- /src/errors.ts      → Custom error classes
-- /src/http-wrapper.ts → HTTP entry point (ESSENTIAL!)
-- /src/index.ts       → MCP stdio entry point
-- /src/library/       → Notebook management
-- /src/session/       → Browser session management
-- /src/tools/         → MCP handlers
-- /src/types.ts       → TypeScript definitions
-- /src/utils/         → Utilities (logger, cleanup, etc.)
-
-## HTTP Deployment Documentation (deployment/)
-/deployment/README.md           → HTTP deployment guide
-/deployment/QUICK-START.md      → Quick start (5 min)
-/deployment/INDEX.md            → Navigation index
-/deployment/PACKAGE-FILES.txt   → This file
-/deployment/docs/01-INSTALL.md
-/deployment/docs/02-CONFIGURATION.md
-/deployment/docs/03-API.md
-/deployment/docs/04-N8N-INTEGRATION.md
-/deployment/docs/05-TROUBLESHOOTING.md
-/deployment/docs/06-NOTEBOOK-LIBRARY.md
-/deployment/docs/07-AUTO-DISCOVERY.md
-/deployment/scripts/install.ps1
-/deployment/scripts/start-server.ps1
-/deployment/scripts/stop-server.ps1
-/deployment/scripts/test-server.ps1
-
-================================================================================
-FILES GENERATED AFTER INSTALLATION (DO NOT COPY)
-================================================================================
-
-These files will be created automatically by npm install and npm run build:
-
-/node_modules/        → npm dependencies (DO NOT copy)
-/dist/                → Compiled JavaScript code (generated by npm run build)
-/Data/                → Persistent data (generated by setup-auth)
-
-================================================================================
-COMPLETE STRUCTURE AFTER DEPLOYMENT
-================================================================================
-
-D:\notebooklm-http\
-├── package.json
-├── package-lock.json
-├── tsconfig.json
-├── .gitignore
-├── LICENSE
-├── README.md
-├── CHANGELOG.md
-├── CONTRIBUTING.md
-├── CREDITS.md
-│
-├── src\
-│   ├── http-wrapper.ts
-│   ├── index.ts
-│   ├── config.ts
-│   ├── errors.ts
-│   ├── types.ts
-│   ├── auth\
-│   ├── library\
-│   ├── session\
-│   ├── tools\
-│   └── utils\
-│
-├── deployment\
-│   ├── README.md
-│   ├── QUICK-START.md
-│   ├── INDEX.md
-│   ├── PACKAGE-FILES.txt
-│   ├── docs\
-│   │   ├── 01-INSTALL.md
-│   │   ├── 02-CONFIGURATION.md
-│   │   ├── 03-API.md
-│   │   ├── 04-N8N-INTEGRATION.md
-│   │   └── 05-TROUBLESHOOTING.md
-│   └── scripts\
-│       ├── install.ps1
-│       ├── start-server.ps1
-│       ├── stop-server.ps1
-│       └── test-server.ps1
-│
-├── node_modules\      (created by npm install)
-├── dist\              (created by npm run build)
-└── Data\              (created by setup-auth)
-    ├── chrome_profile\
-    ├── browser_state\
-    └── library.json
-
-================================================================================
-COMMANDS TO CREATE A DEPLOYABLE PACKAGE
-================================================================================
-
-## Method 1: Manual Copy
-```powershell
-# Create a new folder
-mkdir D:\notebooklm-http-deploy
-
-# Copy required files
-Copy-Item package.json D:\notebooklm-http-deploy\
-Copy-Item package-lock.json D:\notebooklm-http-deploy\
-Copy-Item tsconfig.json D:\notebooklm-http-deploy\
-Copy-Item .gitignore D:\notebooklm-http-deploy\
-Copy-Item -Recurse src D:\notebooklm-http-deploy\
-Copy-Item -Recurse deployment D:\notebooklm-http-deploy\
-
-# Go to the new folder
-cd D:\notebooklm-http-deploy
-
-# Installation
-.\deployment\scripts\install.ps1
-```
-
-## Method 2: ZIP Archive (Recommended for Distribution)
-```powershell
-# Create a clean archive
-$files = @(
-    "package.json",
-    "package-lock.json",
-    "tsconfig.json",
-    ".gitignore",
-    "src",
-    "deployment"
-)
-
-Compress-Archive -Path $files -DestinationPath notebooklm-http-v1.3.0.zip
-```
-
-## Method 3: Git Clone
-```powershell
-git clone <repo-url> D:\notebooklm-http
-cd D:\notebooklm-http
-.\deployment\scripts\install.ps1
-```
-
-================================================================================
-APPROXIMATE SIZE
-================================================================================
-
-Source files + config:     ~2 MB
-node_modules/:             ~150 MB
-dist/:                     ~3 MB
-Data/ (after auth):        ~100 MB
-
-TOTAL after installation:  ~255 MB
-
-================================================================================
-SENSITIVE FILES (NEVER COMMIT)
-================================================================================
-
-/Data/chrome_profile/         → Contains Google cookies
-/Data/browser_state/state.json → Contains Google session
-.env                          → Environment variables (if used)
-node_modules/                 → Dependencies (regenerable)
-
-These files are already in .gitignore
-
-================================================================================
+# Files Required for NotebookLM MCP HTTP Server Deployment
+# Version: 1.3.0
+
+================================================================================
+FILES TO COPY FROM MAIN PROJECT
+================================================================================
+
+## Root Files
+/package.json
+/package-lock.json
+/tsconfig.json
+/.gitignore
+/LICENSE               → MIT License (original project + HTTP wrapper)
+/README.md             → Project overview
+/CHANGELOG.md          → Version history
+/CONTRIBUTING.md       → Contribution guide
+/CREDITS.md            → Credits and acknowledgments
+
+## Source Code (src/)
+/src/**/*
+
+src/ content details:
+- /src/auth/          → Google authentication management
+- /src/config.ts      → Central configuration
+- /src/errors.ts      → Custom error classes
+- /src/http-wrapper.ts → HTTP entry point (ESSENTIAL!)
+- /src/index.ts       → MCP stdio entry point
+- /src/library/       → Notebook management
+- /src/session/       → Browser session management
+- /src/tools/         → MCP handlers
+- /src/types.ts       → TypeScript definitions
+- /src/utils/         → Utilities (logger, cleanup, etc.)
+
+## HTTP Deployment Documentation (deployment/)
+/deployment/README.md           → HTTP deployment guide
+/deployment/QUICK-START.md      → Quick start (5 min)
+/deployment/INDEX.md            → Navigation index
+/deployment/PACKAGE-FILES.txt   → This file
+/deployment/docs/01-INSTALL.md
+/deployment/docs/02-CONFIGURATION.md
+/deployment/docs/03-API.md
+/deployment/docs/04-N8N-INTEGRATION.md
+/deployment/docs/05-TROUBLESHOOTING.md
+/deployment/docs/06-NOTEBOOK-LIBRARY.md
+/deployment/docs/07-AUTO-DISCOVERY.md
+/deployment/scripts/install.ps1
+/deployment/scripts/start-server.ps1
+/deployment/scripts/stop-server.ps1
+/deployment/scripts/test-server.ps1
+
+================================================================================
+FILES GENERATED AFTER INSTALLATION (DO NOT COPY)
+================================================================================
+
+These files will be created automatically by npm install and npm run build:
+
+/node_modules/        → npm dependencies (DO NOT copy)
+/dist/                → Compiled JavaScript code (generated by npm run build)
+/Data/                → Persistent data (generated by setup-auth)
+
+================================================================================
+COMPLETE STRUCTURE AFTER DEPLOYMENT
+================================================================================
+
+D:\notebooklm-http\
+├── package.json
+├── package-lock.json
+├── tsconfig.json
+├── .gitignore
+├── LICENSE
+├── README.md
+├── CHANGELOG.md
+├── CONTRIBUTING.md
+├── CREDITS.md
+│
+├── src\
+│   ├── http-wrapper.ts
+│   ├── index.ts
+│   ├── config.ts
+│   ├── errors.ts
+│   ├── types.ts
+│   ├── auth\
+│   ├── library\
+│   ├── session\
+│   ├── tools\
+│   └── utils\
+│
+├── deployment\
+│   ├── README.md
+│   ├── QUICK-START.md
+│   ├── INDEX.md
+│   ├── PACKAGE-FILES.txt
+│   ├── docs\
+│   │   ├── 01-INSTALL.md
+│   │   ├── 02-CONFIGURATION.md
+│   │   ├── 03-API.md
+│   │   ├── 04-N8N-INTEGRATION.md
+│   │   └── 05-TROUBLESHOOTING.md
+│   └── scripts\
+│       ├── install.ps1
+│       ├── start-server.ps1
+│       ├── stop-server.ps1
+│       └── test-server.ps1
+│
+├── node_modules\      (created by npm install)
+├── dist\              (created by npm run build)
+└── Data\              (created by setup-auth)
+    ├── chrome_profile\
+    ├── browser_state\
+    └── library.json
+
+================================================================================
+COMMANDS TO CREATE A DEPLOYABLE PACKAGE
+================================================================================
+
+## Method 1: Manual Copy
+```powershell
+# Create a new folder
+mkdir D:\notebooklm-http-deploy
+
+# Copy required files
+Copy-Item package.json D:\notebooklm-http-deploy\
+Copy-Item package-lock.json D:\notebooklm-http-deploy\
+Copy-Item tsconfig.json D:\notebooklm-http-deploy\
+Copy-Item .gitignore D:\notebooklm-http-deploy\
+Copy-Item -Recurse src D:\notebooklm-http-deploy\
+Copy-Item -Recurse deployment D:\notebooklm-http-deploy\
+
+# Go to the new folder
+cd D:\notebooklm-http-deploy
+
+# Installation
+.\deployment\scripts\install.ps1
+```
+
+## Method 2: ZIP Archive (Recommended for Distribution)
+```powershell
+# Create a clean archive
+$files = @(
+    "package.json",
+    "package-lock.json",
+    "tsconfig.json",
+    ".gitignore",
+    "src",
+    "deployment"
+)
+
+Compress-Archive -Path $files -DestinationPath notebooklm-http-v1.3.0.zip
+```
+
+## Method 3: Git Clone
+```powershell
+git clone <repo-url> D:\notebooklm-http
+cd D:\notebooklm-http
+.\deployment\scripts\install.ps1
+```
+
+================================================================================
+APPROXIMATE SIZE
+================================================================================
+
+Source files + config:     ~2 MB
+node_modules/:             ~150 MB
+dist/:                     ~3 MB
+Data/ (after auth):        ~100 MB
+
+TOTAL after installation:  ~255 MB
+
+================================================================================
+SENSITIVE FILES (NEVER COMMIT)
+================================================================================
+
+/Data/chrome_profile/         → Contains Google cookies
+/Data/browser_state/state.json → Contains Google session
+.env                          → Environment variables (if used)
+node_modules/                 → Dependencies (regenerable)
+
+These files are already in .gitignore
+
+================================================================================

package/deployment/docs/03-API.md

@@ -14,7 +14,7 @@ Or for network access: `http://<SERVER-IP>:3000`
 
 ---
 
-## Available Endpoints (31 total)
+## Available Endpoints (33 total)
 
 ### Authentication
 
@@ -34,18 +34,20 @@ Or for network access: `http://<SERVER-IP>:3000`
 
 ### Notebooks
 
-| Method   | Endpoint                   | Description                          |
-| -------- | -------------------------- | ------------------------------------ |
-| `GET`    | `/notebooks`               | List all notebooks                   |
-| `POST`   | `/notebooks`               | Add a notebook manually              |
-| `POST`   | `/notebooks/create`        | Create a new notebook in NotebookLM  |
-| `POST`   | `/notebooks/auto-discover` | Auto-generate notebook metadata      |
-| `GET`    | `/notebooks/search`        | Search notebooks by query            |
-| `GET`    | `/notebooks/stats`         | Get library statistics               |
-| `GET`    | `/notebooks/:id`           | Get notebook details                 |
-| `PUT`    | `/notebooks/:id`           | Update notebook metadata             |
-| `DELETE` | `/notebooks/:id`           | Delete a notebook                    |
-| `PUT`    | `/notebooks/:id/activate`  | Activate a notebook (set as default) |
+| Method   | Endpoint                        | Description                          |
+| -------- | ------------------------------- | ------------------------------------ |
+| `GET`    | `/notebooks`                    | List all notebooks                   |
+| `POST`   | `/notebooks`                    | Add a notebook manually              |
+| `POST`   | `/notebooks/create`             | Create a new notebook in NotebookLM  |
+| `POST`   | `/notebooks/auto-discover`      | Auto-generate notebook metadata      |
+| `GET`    | `/notebooks/scrape`             | Scrape notebooks from NotebookLM     |
+| `POST`   | `/notebooks/import-from-scrape` | Bulk import scraped notebooks        |
+| `GET`    | `/notebooks/search`             | Search notebooks by query            |
+| `GET`    | `/notebooks/stats`              | Get library statistics               |
+| `GET`    | `/notebooks/:id`                | Get notebook details                 |
+| `PUT`    | `/notebooks/:id`                | Update notebook metadata             |
+| `DELETE` | `/notebooks/:id`                | Delete a notebook                    |
+| `PUT`    | `/notebooks/:id/activate`       | Activate a notebook (set as default) |
 
 ### Sessions
 
@@ -1640,6 +1642,90 @@ curl -X POST "http://localhost:3000/content/notes/My%20Research%20Note/to-source
 
 ---
 
+## 23. Scrape Notebooks from NotebookLM
+
+### `GET /notebooks/scrape`
+
+Scrape all notebooks from the user's NotebookLM account.
+
+**Request:**
+
+```bash
+curl "http://localhost:3000/notebooks/scrape?show_browser=true"
+```
+
+**Query Parameters:**
+
+| Parameter      | Type    | Description                   |
+| -------------- | ------- | ----------------------------- |
+| `show_browser` | boolean | Show browser window for debug |
+
+**Success Response (200):**
+
+```json
+{
+  "success": true,
+  "data": {
+    "notebooks": [
+      {
+        "id": "89e31c61-63f9-480d-b0ad-92ed60bd1834",
+        "name": "Internal Family Systems",
+        "url": "https://notebooklm.google.com/notebook/89e31c61-63f9-480d-b0ad-92ed60bd1834"
+      }
+    ],
+    "total": 16,
+    "message": "Found 16 notebooks in NotebookLM account"
+  }
+}
+```
+
+---
+
+## 24. Bulk Import Scraped Notebooks
+
+### `POST /notebooks/import-from-scrape`
+
+Scrape notebooks from NotebookLM and bulk import them into the library.
+
+**Request:**
+
+```bash
+curl -X POST http://localhost:3000/notebooks/import-from-scrape \
+  -H "Content-Type: application/json" \
+  -d '{"auto_discover": false}'
+```
+
+**Body Parameters:**
+
+| Parameter       | Type     | Required | Description                            |
+| --------------- | -------- | -------- | -------------------------------------- |
+| `notebook_ids`  | string[] | No       | Filter: only import these notebook IDs |
+| `auto_discover` | boolean  | No       | Use AI to generate metadata (slower)   |
+| `show_browser`  | boolean  | No       | Show browser window for debug          |
+
+**Success Response (200):**
+
+```json
+{
+  "success": true,
+  "data": {
+    "imported": [{ "id": "89e31c61-...", "name": "Internal Family Systems", "status": "imported" }],
+    "errors": [],
+    "total_scraped": 16,
+    "total_imported": 16,
+    "total_errors": 0
+  }
+}
+```
+
+**Use Cases:**
+
+- Initial library setup: import all existing notebooks at once
+- Sync new notebooks: re-run to import newly created notebooks
+- Selective import: use `notebook_ids` to import specific notebooks only
+
+---
+
 ## 📊 Limits and Quotas
 
 | Limit                     | Value     | Configurable               |