# 🔬 Penny NotebookLM Research

Nghiên cứu YouTube theo đúng luồng: **Brave Search tìm video → scrape transcript → add vào NotebookLM → Gemini phân tích transcript thực → gợi ý ideas → viết script.**

Kết quả không phải từ Claude tự đoán — mà từ Gemini đọc transcript thực của từng video.

---

## Yêu cầu bắt buộc

Cần cài **cả 2 thứ**:
1. **MCP** (Node.js server chạy local) — để gọi Brave Search, Apify, điều khiển NotebookLM
2. **Skill** (file `.skill`) — để Claude Cowork biết cách điều phối luồng

Thiếu một trong hai thì không chạy được.

---

## Bước 1: Cài MCP (làm 1 lần)

**Script tự động — dán vào Terminal:**

```bash
curl -fsSL https://raw.githubusercontent.com/pennydinh/penny-notebooklm-research/main/install.sh | bash
```

Script sẽ tự clone repo, `npm install`, build, và đăng ký MCP vào Claude.

**Yêu cầu:** Node.js ≥ 18 và Chrome đã cài.

Sau khi chạy xong → điền API key vào file `.env`:
- [`BRAVE_API_KEY`](https://brave.com/search/api/) — miễn phí, 2000 queries/tháng
- [`APIFY_TOKEN`](https://www.apify.com?fpr=get-api) — tùy chọn, scrape view count chính xác ($5 free credit/tháng)

Sau đó **restart Claude**.

---

## Bước 2: Cài Skill (làm 1 lần)

1. Tải file [`penny-notebooklm-research.skill`](https://github.com/pennydinh/penny-notebooklm-research/raw/main/penny-notebooklm-research.skill)
2. Mở Claude desktop → Settings → Capabilities → Install Skill → chọn file vừa tải

---

## Bước 3: Setup lần đầu trong Claude

Gõ: `setup_auth` → Chrome mở → đăng nhập Google account **phụ** (không dùng tài khoản chính).

Vào [notebooklm.google.com](https://notebooklm.google.com) → tạo notebook → Share → "Anyone with the link" → copy URL.

---

## Từ lần 2 trở đi

Gõ bình thường trong Claude Cowork:
```
nghiên cứu YouTube về AI agent, views >50k, tuần qua
```

Claude tự chạy toàn bộ: tìm video → add vào NotebookLM → Gemini phân tích transcript → ra 5 ideas → viết script khi chọn.

---

## Luồng thực tế

```
Brave Search / Apify
  → tìm video viral theo chủ đề + views + thời gian
  → add từng URL vào NotebookLM
  → NotebookLM/Gemini đọc transcript thực
  → phân tích: trend, keywords, thumbnail pattern, hook style
  → gợi ý 5 ideas
  → viết script hoàn chỉnh khi chọn idea
```

---

## 🔧 Cài thủ công (thay cho install.sh)



### Yêu cầu
- Node.js ≥ 18
- Chrome
- [Brave Search API key](https://brave.com/search/api/) (miễn phí, 2000 queries/tháng)
- *(Tuỳ chọn)* [Apify token](https://www.apify.com?fpr=get-api) — scrape view count chính xác ($5 free credit/tháng)

### Cài đặt

```bash
git clone https://github.com/pennydinh/penny-notebooklm-research
cd penny-notebooklm-research
npm install
cp .env.example .env
# Mở .env, điền BRAVE_API_KEY
npm run build
claude mcp add penny-research -- node $(pwd)/dist/index.js
```

### Lần đầu: Đăng nhập Google

Mở Claude Code, gõ:
```
setup_auth
```
Chrome mở ra → đăng nhập Google account riêng (không dùng tài khoản chính) → tự động lưu cookies.

### Tạo notebook

1. Vào [notebooklm.google.com](https://notebooklm.google.com) → tạo notebook mới
2. Share → "Anyone with the link" → copy URL

### Chạy toàn bộ luồng trong 1 lệnh

```
research_workflow(
  topic="AI agent",
  min_views=100000,
  freshness="pm",
  notebook_url="https://notebooklm.google.com/notebook/..."
)
```

### Hoặc từng bước

```
# 1. Tìm video viral
brave_search_videos(query="AI agent 2025", freshness="pm", min_views=100000)

# 2. Add vào NotebookLM
add_source(type="url", content="https://youtube.com/watch?v=...", notebook_url="...")

# 3. Phân tích
ask_question(question="Phân tích trend, keywords, gợi ý 5 ideas video", source_format="footnotes")

# 4. Viết script
ask_question(question="Viết script 1000 từ cho ý tưởng số 2")
```

---

## Tools có trong MCP

| Tool | Mô tả |
|------|-------|
| `brave_search_videos` | Tìm video YouTube viral theo chủ đề & thời gian |
| `brave_search_news` | Tìm tin tức để source mixing |
| `apify_scrape_youtube` | Scrape chi tiết: views thực, transcript ([Đăng ký Apify](https://www.apify.com?fpr=get-api)) |
| `research_workflow` | Chạy toàn bộ luồng 1 lệnh |
| `add_source` | Add URL/text vào NotebookLM |
| `ask_question` | Hỏi Gemini qua NotebookLM |
| `setup_auth` | Đăng nhập Google lần đầu |
| `get_health` | Kiểm tra trạng thái |

---

## FAQ

**Dùng Google account nào?**
Tạo account riêng. Không dùng tài khoản Google chính vì cookies lưu local.

**Brave API có mất phí không?**
Free 2000 queries/tháng. [Đăng ký tại đây](https://brave.com/search/api/).

**Apify có bắt buộc không?**
Không. Brave Search đủ để tìm URLs. Apify cần khi muốn view count chính xác.

---

MIT License · [pennydinh](https://github.com/pennydinh)