joeseesun/qiaomu-anything-to-notebooklm · 上手攻略

  • 仓库：joeseesun/qiaomu-anything-to-notebooklm
  • 链接：https://github.com/joeseesun/qiaomu-anything-to-notebooklm
  • 分类：academic-writing
  • 作者：Tom
  • 更新：2026-08-08

这是什么

一个 Claude Code Skill，中文名叫"巧木"——多源内容智能处理器。核心逻辑一句话：把任意内容（微信文章、付费报道、播客、YouTube、PDF、EPUB）拖进 Claude Code，自动上传到 Google NotebookLM，生成播客 / PPT / 思维导图 / Quiz 等目标格式。

典型使用场景：你刷到一篇 The Information 的付费报道，想在通勤路上听——扔给巧木，自动绕过付费墙 → 上传 NotebookLM → 生成播客，5 分钟后你就能听。

解决什么问题

  1. 信息源碎片化：微信、付费媒体、播客、YouTube、B站分散在不同平台，无法统一处理。
  2. 付费墙障碍：想读 NYT、WSJ、FT、Economist 等 300+ 付费报道，手动绕过费时费力。
  3. 格式转换繁琐：看完一篇长文想生成摘要/PPT/思维导图，要分别在多个工具里操作。
  4. NotebookLM 上传麻烦：NotebookLM 本身只接受 URL 或文件，没有智能内容获取能力。

巧木把这些步骤串联成一条全自动管道。

快速安装

# 1. 克隆到 Claude skills 目录
cd ~/.claude/skills/
git clone https://github.com/joeseesun/qiaomu-anything-to-notebooklm
cd qiaomu-anything-to-notebooklm

# 2. 一键安装所有依赖
./install.sh

# 3. 配置 MCP（微信公众号支持）
# 编辑 ~/.claude/config.json 添加：
{
  "mcpServers": {
    "weixin-reader": {
      "command": "python",
      "args": ["/Users/joe/.claude/skills/qiaomu-anything-to-notebooklm/wexin-read-mcp/src/server.py"]
    }
  }
}

# 4. 重启 Claude Code

# 5. NotebookLM 认证（只需一次）
notebooklm login
notebooklm list  # 验证认证成功

# 6. 可选：播客转写（Get笔记 API）
export GETNOTE_API_KEY="your_api_key"
export GETNOTE_CLIENT_ID="your_client_id"

# 7. 环境检查
./check_env.py  # 13 项全面检查

依赖要求：Python 3.9+、Git（macOS/Linux 自带），其余依赖一键自动安装。

如需 MCP 微信抓取，还需：

pip install -r requirements.txt
playwright install chromium

核心用法

基本命令模式

# 微信文章 → 播客
你："把这篇微信文章生成播客 https://mp.weixin.qq.com/s/abc123"
AI 自动执行：MCP 抓取 → NotebookLM → 生成播客
结果：/tmp/article_podcast.mp3

# 小宇宙播客 → PPT
你："这期小宇宙播客做成 PPT https://xiaoyuzhoufm.com/episode/xxx"
AI 自动执行：Get笔记 API 转写 → NotebookLM → 生成 PPT
结果：/tmp/podcast_slides.pdf

# EPUB 深度分析
python main.py /path/to/book.epub --deep-analysis
# 输出：/tmp/book_analysis.json（12 个递进问答，3 轮：概览→深度挖掘→综合反刍）

# EPUB → 飞书文档
python main.py /path/to/book.epub --deep-analysis --to-feishu

# 搜索关键词 → 报告
你："搜索 'AI 趋势' 并生成报告"

NotebookLM 认证后的 CLI 用法

# 深度分析模式（3 轮递进提问）
python main.py https://example.com/article --deep-analysis

# YouTube（特殊规则：直接传 URL，不下载字幕！）
# 正确：
notebooklm source add "https://youtube.com/watch?v=..."
# 错误：禁止使用 yt-dlp / whisper / 浏览器自动化

输入类型自动识别

输入特征 识别为 处理方式
https://mp.weixin.qq.com/s/ 微信公众号 MCP 浏览器模拟
https://youtube.com/... YouTube 直接传 NotebookLM（原生支持）
xiaoyuzhoufm.com 等 播客/视频 Get笔记 API 转写
x.com / twitter.com X/Twitter 内置代理级联抓取
付费网站 付费墙网页 UA 伪装 + archive.today
/path/to/file.pdf PDF markitdown 转换
/path/to/book.epub EPUB ebooklib 提取
关键词（无 URL） 搜索查询 WebSearch 汇总

NotebookLM 输出格式映射

用户意图 NotebookLM 命令
"生成播客" / "做成音频" generate audio
"做成 PPT" / "生成幻灯片" generate slide-deck
"画个思维导图" generate mind-map
"生成 Quiz" / "出题" generate quiz
"生成报告" / "写个总结" generate report
"深度分析" / "递归提问" 自动生成 10 题 + 递进提问
"写入飞书" 创建飞书文档

典型适用场景

  1. 通勤学习：把付费报道/长文章转成播客，在地铁上听。
  2. 内容研究：批量收集微信文章 + YouTube + 播客，统一生成摘要报告。
  3. 书籍消化：EPUB 上传 → 深度分析 → 输出结构化问答 → 存入飞书。
  4. 团队分享：把播客转 PPT，用于会议演示。
  5. 考试复习：PDF/文档生成 Quiz 闪卡。

坑与注意

  1. YouTube 字幕获取红线：NotebookLM 原生支持 YouTube URL，禁止使用 yt-dlp、whisper 或任何浏览器自动化下载字幕。直接传 URL 即可。

  2. 硬付费墙需要 archive.today：部分服务器端严格控制的网站（如 The Information 部分文章），即使 6 层绕过策略也可能失败，会提示 archive.ph needs human verification，需手动在浏览器完成验证。

  3. Get笔记 API 依赖：小宇宙 / 喜马拉雅 / B 站转写需要 Get笔记 API Key，需单独申请并配置环境变量。

  4. NotebookLM 认证有效期：认证令牌可能过期，如遇 notebooklm list 失败，尝试重新 notebooklm login。

  5. MCP 配置手动编辑：install.sh 不自动写入 config.json，需手动添加 MCP 服务器配置段。

  6. 内容长度限制：最短约 500 字，最长约 50 万字，推荐 1000–10000 字效果最佳。

  7. 仅限个人学习研究：工具声明 MIT License，但付费墙绕过技术建议仅用于个人学习，支持优质新闻媒体购买正式订阅。

与同类对比

工具 内容获取 NotebookLM 集成 付费墙绕过 输出格式
qiaomu-anything-to-notebooklm 微信+推特+播客+网页+PDF ✅ 原生 ✅ 6 层级联 播客/PPT/导图/Quiz/报告
markitdown 仅文件 ❌ ❌ 仅转 Markdown
Bypass Paywalls Clean 仅浏览器插件 ❌ ✅ 无格式转换
notebooklm-py 仅 API 上传 ✅ ❌ 依赖 NotebookLM
直接 Notion AI 需 Notion 页面 ❌ ❌ 摘要/问答

巧木的核心差异：多源获取 + 付费墙绕过 + NotebookLM 生成三条链路串联，一句话触发全程。

一句话推荐结论

如果你已经在用 NotebookLM 想提升内容输入效率，或者经常需要把中文付费内容转成音频/图文，巧木是当前最省心的"一键接入"方案——装好之后说一句"把这个生成播客"就够了。