内容
# 🔬 Penny NotebookLM 研究
研究 YouTube 根据正确流程： **Brave Search 查找视频 → 抓取转录 → 添加到 NotebookLM → Gemini 分析转录 → 建议创意 → 编写脚本。**
结果不是从 Claude 自己猜测 — 而是从 Gemini 读取每个视频的实际转录。
---
## 必备要求
需要安装 **以下两项**：
1. **MCP** (Node.js 服务器运行本地) — 用于调用 Brave Search、Apify、控制 NotebookLM
2. **Skill** (`.skill` 文件) — 让 Claude Cowork 知道如何协调流程
缺少其中一项则无法运行。
---
## 步骤 1：安装 MCP（仅需一次）
**自动脚本 — 复制到终端：**
```bash
curl -fsSL https://raw.githubusercontent.com/pennydinh/penny-notebooklm-research/main/install.sh | bash
```
脚本将自动克隆仓库、`npm install`、构建并将 MCP 注册到 Claude。
**要求：** Node.js ≥ 18 和 Chrome 已安装。
运行完成后 → 在 `.env` 文件中填写 API 密钥：
- [`BRAVE_API_KEY`](https://brave.com/search/api/) — 免费，2000 次查询/月
- [`APIFY_TOKEN`](https://www.apify.com?fpr=get-api) — 可选，准确抓取浏览量（$5 免费积分/月）
然后 **重启 Claude**。
---
## 步骤 2：安装 Skill（仅需一次）
1. 下载 [`penny-notebooklm-research.skill`](https://github.com/pennydinh/penny-notebooklm-research/raw/main/penny-notebooklm-research.skill) 文件
2. 打开 Claude desktop → 设置 → 功能 → 安装 Skill → 选择下载的文件
---
## 步骤 3：Claude 初次设置
输入：`setup_auth` → Chrome 打开 → 登录 **辅助** Google 账户（不使用主账户）。
进入 [notebooklm.google.com](https://notebooklm.google.com) → 创建笔记本 → 分享 → "任何有链接的人" → 复制 URL。
---
## 从第二次开始
在 Claude Cowork 中正常输入：
```
研究 YouTube 关于 AI 代理，浏览量 >50k，上周
```
Claude 自动运行整个流程：查找视频 → 添加到 NotebookLM → Gemini 分析转录 → 提出 5 个创意 → 选择后编写脚本。
---
## 实际流程
```
Brave Search / Apify
→ 根据主题 + 浏览量 + 时间查找病毒视频
→ 将每个 URL 添加到 NotebookLM
→ NotebookLM/Gemini 读取实际转录
→ 分析：趋势、关键词、缩略图模式、钩子样式
→ 建议 5 个创意
→ 选择创意后编写完整脚本
```
---
## 🔧 手动安装（代替 install.sh）
### 要求
- Node.js ≥ 18
- Chrome
- [Brave Search API 密钥](https://brave.com/search/api/) （免费，2000 次查询/月）
- *(可选)* [Apify token](https://www.apify.com?fpr=get-api) — 准确抓取浏览量（$5 免费积分/月）
### 安装
```bash
git clone https://github.com/pennydinh/penny-notebooklm-research
cd penny-notebooklm-research
npm install
cp .env.example .env
# 打开 .env，填写 BRAVE_API_KEY
npm run build
claude mcp add penny-research -- node $(pwd)/dist/index.js
```
### 初次：Google 登录
打开 Claude Code，输入：
```
setup_auth
```
Chrome 打开 → 登录单独的 Google 账户（不使用主账户）→ 自动保存 cookies。
### 创建笔记本
1. 进入 [notebooklm.google.com](https://notebooklm.google.com) → 创建新笔记本
2. 分享 → "任何有链接的人" → 复制 URL
### 运行整个流程的命令
```
research_workflow(
topic="AI 代理",
min_views=100000,
freshness="pm",
notebook_url="https://notebooklm.google.com/notebook/..."
)
```
### 或分步操作
```
# 1. 查找病毒视频
brave_search_videos(query="AI 代理 2025", freshness="pm", min_views=100000)
# 2. 添加到 NotebookLM
add_source(type="url", content="https://youtube.com/watch?v=...", notebook_url="...")
# 3. 分析
ask_question(question="分析趋势、关键词、建议 5 个视频创意", source_format="footnotes")
# 4. 编写脚本
ask_question(question="为创意 2 编写 1000 字脚本")
```
---
## MCP 包含的工具
| 工具 | 描述 |
|------|-------|
| `brave_search_videos` | 根据主题和时间查找 YouTube 病毒视频 |
| `brave_search_news` | 查找新闻来源混合 |
| `apify_scrape_youtube` | 抓取详细信息：实际浏览量、转录（[注册 Apify](https://www.apify.com?fpr=get-api)） |
| `research_workflow` | 运行整个流程的命令 |
| `add_source` | 将 URL/文本添加到 NotebookLM |
| `ask_question` | 通过 NotebookLM 向 Gemini 提问 |
| `setup_auth` | 初次 Google 登录 |
| `get_health` | 检查状态 |
---
## 常见问题
**使用哪个 Google 账户？**
创建单独的账户。不使用主 Google 账户，因为 cookies 保存在本地。
**Brave API 是否收费？**
免费 2000 次查询/月。[在此注册](https://brave.com/search/api/)。
**Apify 是否必需？**
不是。Brave Search 足以查找 URL。需要 Apify 时想要准确的浏览量。
---
MIT License · [pennydinh](https://github.com/pennydinh)
