@roomi-fields/notebooklm-mcp 1.3.6 → 1.5.1

package/LICENSE

@@ -1,22 +1,22 @@
-MIT License
-
-Copyright (c) 2025 Please Prompto! (Original NotebookLM MCP Server)
-Copyright (c) 2025 Romain Peyrichou - HTTP REST API Wrapper (Developed with Claude Code - Anthropic Claude Sonnet 4.5)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Please Prompto! (Original NotebookLM MCP Server)
+Copyright (c) 2025 Romain Peyrichou - HTTP REST API Wrapper (Developed with Claude Code - Anthropic Claude Sonnet 4.5)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,7 +4,7 @@
 
 > **Forked from** [PleasePrompto/notebooklm-mcp](https://github.com/PleasePrompto/notebooklm-mcp)
 
-**Chat directly with NotebookLM for zero-hallucination answers based on your own notebooks**
+**Full automation of Google NotebookLM: Q&A, audio podcasts, and source management**
 
 <!-- Badges -->
 
@@ -18,33 +18,75 @@
 
 ---
 
-## Why NotebookLM?
+## Features
 
-| Approach            | Token Cost  | Hallucinations                | Answer Quality       |
-| ------------------- | ----------- | ----------------------------- | -------------------- |
-| Feed docs to Claude | Very high   | Yes - fills gaps              | Variable             |
-| Web search          | Medium      | High - unreliable sources     | Hit or miss          |
-| Local RAG           | Medium-High | Medium - retrieval gaps       | Depends on setup     |
-| **NotebookLM MCP**  | **Minimal** | **Zero** - refuses if unknown | **Expert synthesis** |
+### Q&A with Citations
 
-NotebookLM is pre-indexed by Gemini, provides citation-backed answers, and requires no infrastructure.
+- **Ask questions** to NotebookLM and get accurate, citation-backed answers
+- **Source citation extraction** with 5 formats: none, inline, footnotes, json, expanded
+- **Session management** for multi-turn conversations
+
+### Content Generation
+
+Generate multiple content types from your notebook sources:
+
+| Content Type       | Formats                  | Options                                        |
+| ------------------ | ------------------------ | ---------------------------------------------- |
+| **Audio Overview** | Podcast-style discussion | Language (80+), custom instructions            |
+| **Video**          | Brief, Explainer         | 6 visual styles, language, custom instructions |
+| **Infographic**    | Horizontal, Vertical     | Language, custom instructions                  |
+| **Report**         | Summary, Detailed        | Language, custom instructions                  |
+| **Presentation**   | Overview, Detailed       | Language, custom instructions                  |
+| **Data Table**     | Simple, Detailed         | Language, custom instructions                  |
+
+**Video Visual Styles**: classroom, documentary, animated, corporate, cinematic, minimalist
+
+### Content Download
+
+- **Download Audio** — WAV audio files
+- **Download Video** — MP4 video files
+- **Download Infographic** — PNG image files
+- Text-based content (report, presentation, data_table) is returned in the API response
+
+### Source Management
+
+- **Add sources**: Files (PDF, TXT, DOCX), URLs, Text, YouTube videos, Google Drive
+- **List sources**: View all sources in a notebook
+
+### Notebook Library
+
+- **Multi-notebook management** with validation and smart selection
+- **Auto-discovery**: Automatically generate metadata via NotebookLM queries
+- **Search notebooks** by keyword in name, description, or topics
+
+### Integration Options
+
+- **MCP Protocol** — Claude Code, Cursor, Codex, any MCP client
+- **HTTP REST API** — n8n, Zapier, Make.com, custom integrations
 
 ---
 
 ## Quick Start
 
+> ⚠️ **npm registry temporarily unavailable** - Install from GitHub instead (see below)
+
 ### Option 1: MCP Mode (Claude Code, Cursor, Codex)
 
 ```bash
+# Clone and build locally
+git clone https://github.com/roomi-fields/notebooklm-mcp.git
+cd notebooklm-mcp
+npm install && npm run build
+
 # Claude Code
-claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
+claude mcp add notebooklm node /path/to/notebooklm-mcp/dist/index.js
 
 # Cursor - add to ~/.cursor/mcp.json
 {
   "mcpServers": {
     "notebooklm": {
-      "command": "npx",
-      "args": ["-y", "@roomi-fields/notebooklm-mcp@latest"]
+      "command": "node",
+      "args": ["/path/to/notebooklm-mcp/dist/index.js"]
     }
   }
 }
@@ -82,36 +124,27 @@ curl -X POST http://localhost:3000/ask \
 | [Troubleshooting](./deployment/docs/05-TROUBLESHOOTING.md)   | Common issues and solutions               |
 | [Notebook Library](./deployment/docs/06-NOTEBOOK-LIBRARY.md) | Multi-notebook management                 |
 | [Auto-Discovery](./deployment/docs/07-AUTO-DISCOVERY.md)     | Autonomous metadata generation            |
-| [Chrome Limitation](./docs/CHROME_PROFILE_LIMITATION.md)     | HTTP/MCP simultaneous mode issue          |
-
----
-
-## Core Features
-
-- **Zero Hallucinations** — NotebookLM refuses to answer if info isn't in your docs
-- **Multi-Notebook Library** — Manage multiple notebooks with validation and smart selection
-- **Auto-Discovery** — Automatically generate metadata via NotebookLM queries
-- **HTTP REST API** — Use from n8n, Zapier, Make.com, or any HTTP client
-- **Daemon Mode** — Run as background process with PM2 (`npm run daemon:start`)
-- **Cross-Tool** — Works with Claude Code, Cursor, Codex, and any MCP client
+| [Multi-Interface](./deployment/docs/09-MULTI-INTERFACE.md)   | Run Claude Desktop + HTTP simultaneously  |
+| [Chrome Limitation](./docs/CHROME_PROFILE_LIMITATION.md)     | Profile locking (solved in v1.3.6+)       |
+| [Adding a Language](./docs/ADDING_A_LANGUAGE.md)             | i18n system for multilingual UI support   |
 
 ---
 
-## Architecture
+## Roadmap
 
-```
-Your Task → Agent/n8n → MCP/HTTP Server → Chrome Automation → NotebookLM → Gemini 2.5 → Your Docs
-                                                                    ↓
-                                                            Accurate Output
-```
+See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
 
----
+**Latest releases:**
 
-## Roadmap
+- **v1.5.1** — Multilingual UI support (FR/EN) with i18n selector system + E2E tests (76 tests)
+- **v1.5.0** — Complete Studio content generation (video, infographic, presentation, data_table) + Notes management + Delete sources
+- **v1.4.0** — Content management (sources, audio, generation) + Multi-account
+- **v1.3.7** — Source citation extraction (5 formats)
 
-See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
+**Not yet implemented:**
 
-**Next up (v1.4.0):** Separate Chrome profiles to enable HTTP + MCP modes simultaneously.
+- Discover sources (Web/Drive search with Fast/Deep modes)
+- Edit notes (create, delete, and convert are implemented)
 
 ---
 
@@ -133,6 +166,10 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
 
 MIT — Use freely in your projects. See [LICENSE](./LICENSE).
 
+## Author
+
+**Romain Peyrichou** — [@roomi-fields](https://github.com/roomi-fields)
+
 ---
 
 <details>

package/deployment/INDEX.md

@@ -0,0 +1,292 @@
+# Complete Index - NotebookLM MCP HTTP Deployment Package
+
+> Your navigation guide through the deployment documentation
+
+---
+
+## 📚 Overview
+
+This package contains **everything you need** to deploy NotebookLM MCP in HTTP REST API mode.
+
+**Package contents:**
+
+- ✅ 10 documentation files
+- ✅ 4 automated PowerShell scripts
+- ✅ Step-by-step installation guide
+- ✅ Complete API documentation
+- ✅ n8n integration guide
+- ✅ Auto-discovery feature documentation
+
+---
+
+## 🗂️ Directory Structure
+
+```
+deployment/
+├── README.md                       ← Start here!
+├── QUICK-START.md                  ← For the impatient (5 min)
+├── INDEX.md                        ← This file
+├── LICENSE                         ← MIT License
+├── CONTRIBUTING.md                 ← Contribution guide
+├── CHANGELOG.md                    ← Version history
+├── CREDITS.md                      ← Credits and acknowledgments
+├── PACKAGE-FILES.txt               ← List of files to copy
+│
+├── docs/
+│   ├── 01-INSTALL.md              ← Detailed installation guide
+│   ├── 02-CONFIGURATION.md        ← Advanced configuration
+│   ├── 03-API.md                  ← API documentation
+│   ├── 04-N8N-INTEGRATION.md      ← n8n integration
+│   ├── 05-TROUBLESHOOTING.md      ← Problem resolution
+│   ├── 06-NOTEBOOK-LIBRARY.md     ← Multi-notebook management
+│   └── 07-AUTO-DISCOVERY.md       ← Auto-discovery pattern
+│
+└── scripts/
+    ├── install.ps1                ← Automatic installation
+    ├── start-server.ps1           ← Server startup
+    ├── stop-server.ps1            ← Server shutdown
+    └── test-server.ps1            ← Validation tests
+```
+
+---
+
+## 🎯 Where to Start?
+
+### I'm in a HURRY (5 minutes)
+
+→ **[QUICK-START.md](./QUICK-START.md)**
+Installation and testing in 5 quick steps
+
+### I want a COMPLETE installation
+
+→ **[README.md](./README.md)** then **[docs/01-INSTALL.md](./docs/01-INSTALL.md)**
+Detailed guide with explanations
+
+### I want to AUTOMATE the installation
+
+→ **[scripts/install.ps1](./scripts/install.ps1)**
+PowerShell script that does everything
+
+---
+
+## 📖 Available Documentation
+
+### 📄 Main Guides
+
+| File                                         | Description                  | Reading time |
+| -------------------------------------------- | ---------------------------- | ------------ |
+| **[README.md](./README.md)**                 | Package overview             | 5 min        |
+| **[QUICK-START.md](./QUICK-START.md)**       | Quick start in 5 steps       | 2 min        |
+| **[INDEX.md](./INDEX.md)**                   | This file - navigation guide | 3 min        |
+| **[PACKAGE-FILES.txt](./PACKAGE-FILES.txt)** | List of required files       | 2 min        |
+
+### 📚 Detailed Documentation (docs/)
+
+| File                                                        | Description                                 | Reading time |
+| ----------------------------------------------------------- | ------------------------------------------- | ------------ |
+| **[01-INSTALL.md](./docs/01-INSTALL.md)**                   | Complete installation from scratch          | 15 min       |
+| **[02-CONFIGURATION.md](./docs/02-CONFIGURATION.md)**       | Advanced configuration, variables, security | 12 min       |
+| **[03-API.md](./docs/03-API.md)**                           | Complete REST API documentation             | 15 min       |
+| **[04-N8N-INTEGRATION.md](./docs/04-N8N-INTEGRATION.md)**   | Integration with n8n, workflows             | 20 min       |
+| **[05-TROUBLESHOOTING.md](./docs/05-TROUBLESHOOTING.md)**   | Complete problem resolution                 | 15 min       |
+| **[06-NOTEBOOK-LIBRARY.md](./docs/06-NOTEBOOK-LIBRARY.md)** | Multi-notebook library management           | 12 min       |
+| **[07-AUTO-DISCOVERY.md](./docs/07-AUTO-DISCOVERY.md)**     | Autonomous resource discovery pattern       | 15 min       |
+
+### 🤝 Contribution and Project
+
+| File                                     | Description                       | Reading time |
+| ---------------------------------------- | --------------------------------- | ------------ |
+| **[LICENSE](./LICENSE)**                 | MIT License with attributions     | 3 min        |
+| **[CONTRIBUTING.md](./CONTRIBUTING.md)** | Detailed contribution guide       | 10 min       |
+| **[CHANGELOG.md](./CHANGELOG.md)**       | Complete version history          | 8 min        |
+| **[CREDITS.md](./CREDITS.md)**           | Credits, technologies, philosophy | 8 min        |
+
+### 🔧 PowerShell Scripts (scripts/)
+
+| Script                                             | Description                     | Usage                        |
+| -------------------------------------------------- | ------------------------------- | ---------------------------- |
+| **[install.ps1](./scripts/install.ps1)**           | Complete automatic installation | `.\scripts\install.ps1`      |
+| **[start-server.ps1](./scripts/start-server.ps1)** | HTTP server startup             | `.\scripts\start-server.ps1` |
+| **[stop-server.ps1](./scripts/stop-server.ps1)**   | Clean server shutdown           | `.\scripts\stop-server.ps1`  |
+| **[test-server.ps1](./scripts/test-server.ps1)**   | Validation tests                | `.\scripts\test-server.ps1`  |
+
+---
+
+## 🚀 Recommended Workflow
+
+### 1️⃣ Initial Installation
+
+```powershell
+# 1. Read the overview
+cat deployment\README.md
+
+# 2. Run automatic installation
+cd deployment
+.\scripts\install.ps1
+
+# 3. Configure authentication (one time only)
+npm run setup-auth
+```
+
+### 2️⃣ Daily Usage
+
+```powershell
+# Start the server
+cd deployment
+.\scripts\start-server.ps1
+
+# In another terminal: test
+.\scripts\test-server.ps1
+
+# Stop the server
+.\scripts\stop-server.ps1
+```
+
+### 3️⃣ Integration with n8n
+
+1. Read: **[04-N8N-INTEGRATION.md](./docs/04-N8N-INTEGRATION.md)** (TODO)
+2. Configure the HTTP Request node in n8n
+3. Test from n8n
+
+---
+
+## 🎓 Usage Scenarios
+
+### Scenario 1: First Deployment
+
+```
+1. README.md → Overview
+2. 01-INSTALL.md → Detailed installation
+3. scripts/install.ps1 → Automation
+4. scripts/test-server.ps1 → Validation
+```
+
+### Scenario 2: Quick Deployment (Already familiar with Node.js)
+
+```
+1. QUICK-START.md → 5 quick steps
+2. scripts/install.ps1 → Installation
+3. npm run setup-auth → Auth
+4. scripts/start-server.ps1 → Startup
+```
+
+### Scenario 3: n8n Integration
+
+```
+1. 01-INSTALL.md → Server installation
+2. 04-N8N-INTEGRATION.md → n8n configuration
+3. scripts/test-server.ps1 → Tests
+4. n8n Workflow → Production
+```
+
+### Scenario 4: Troubleshooting
+
+```
+1. 05-TROUBLESHOOTING.md → Common solutions
+2. Server logs → Diagnostics
+3. scripts/test-server.ps1 → Validation
+4. GitHub Issues → Community support
+```
+
+---
+
+## 📊 Progress Status
+
+| Document               | Status      | Notes                    |
+| ---------------------- | ----------- | ------------------------ |
+| README.md              | ✅ Complete | Overview updated         |
+| QUICK-START.md         | ✅ Complete | 5 min quick guide        |
+| INDEX.md               | ✅ Complete | This file - navigation   |
+| PACKAGE-FILES.txt      | ✅ Complete | File list                |
+| LICENSE                | ✅ Complete | MIT with attributions    |
+| CONTRIBUTING.md        | ✅ Complete | Contribution guide       |
+| CHANGELOG.md           | ✅ Complete | Version 1.1.2-http       |
+| CREDITS.md             | ✅ Complete | Complete credits         |
+| 01-INSTALL.md          | ✅ Complete | Detailed installation    |
+| 02-CONFIGURATION.md    | ✅ Complete | Variables, security, PM2 |
+| 03-API.md              | ✅ Complete | 12 documented endpoints  |
+| 04-N8N-INTEGRATION.md  | ✅ Complete | 3 example workflows      |
+| 05-TROUBLESHOOTING.md  | ✅ Complete | Complete solutions       |
+| 06-NOTEBOOK-LIBRARY.md | ✅ Complete | Multi-notebook library   |
+| 07-AUTO-DISCOVERY.md   | ✅ Complete | Auto-discovery pattern   |
+| install.ps1            | ✅ Complete | Automatic installation   |
+| start-server.ps1       | ✅ Complete | Startup with checks      |
+| stop-server.ps1        | ✅ Complete | Clean shutdown           |
+| test-server.ps1        | ✅ Complete | Validation tests         |
+
+**Overall status:** ✅ 100% Complete - Ready for Git publication
+
+---
+
+## 🆘 Need Help?
+
+### Quick Support
+
+1. **Installation problem?** → [01-INSTALL.md](./docs/01-INSTALL.md)
+2. **Startup error?** → [05-TROUBLESHOOTING.md](./docs/05-TROUBLESHOOTING.md)
+3. **API question?** → [03-API.md](./docs/03-API.md)
+4. **n8n integration?** → [04-N8N-INTEGRATION.md](./docs/04-N8N-INTEGRATION.md)
+
+### Community Support
+
+- **GitHub Issues:** [To be configured upon repository publication]
+- **Discussions:** [To be configured upon repository publication]
+
+---
+
+## 📝 Release Notes
+
+**Current version:** 1.3.1
+
+**Included in this version:**
+
+- ✅ MCP Auto-Discovery Tool: `auto_discover_notebook` for Claude Desktop
+- ✅ Critical fix: Claude Desktop compatibility (disabled CompleteRequestSchema)
+- ✅ HTTP Auto-Discovery: POST `/notebooks/auto-discover` endpoint
+- ✅ Progressive disclosure inspired by Claude Skills
+- ✅ Automatic metadata validation and generation
+- ✅ Orchestrators can discover documentation autonomously
+- ✅ Fix persistent authentication Windows
+- ✅ Fix NotebookLM streaming detection
+- ✅ Removal of "EXTREMELY IMPORTANT" system phrase
+- ✅ Server listens on 0.0.0.0 (network accessible)
+- ✅ PowerShell automation scripts
+- ✅ Complete deployment documentation
+- ✅ Chrome profile limitation documented
+
+**Possible future improvements (1.4.0+):**
+
+- 🔥 Separate Chrome profiles by mode (HTTP vs stdio) - HIGH PRIORITY
+- ⏳ Smart metadata refresh endpoint
+- ⏳ Semantic matching with embeddings
+- ⏳ Usage analytics for notebooks
+- ⏳ Optional Docker support
+- ⏳ Web administration interface
+- ⏳ Automated tests (unit + integration)
+- ⏳ JWT/OAuth authentication support
+
+---
+
+## 📄 License
+
+**MIT License** - See [LICENSE](./LICENSE) for complete details.
+
+- Original project © 2025 Please Prompto!
+- HTTP Wrapper © 2025 (Developed with Claude Code - Anthropic Claude Sonnet 4.5)
+
+---
+
+## 🤝 Contribution
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for:
+
+- Reporting bugs
+- Proposing improvements
+- Submitting code
+- Standards and Git workflow
+
+---
+
+**Last updated:** January 23, 2025
+**Version:** 1.3.1
+**Status:** ✅ Production-ready - Complete documentation

package/deployment/PACKAGE-FILES.txt

@@ -0,0 +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
+
+================================================================================