把小红书图文笔记完整地"读"进 Claude Code 当上下文——标题 + 正文 + 全部图片 + 互动数据 + 评论区，一条链接就够。
这是一个 Claude Code skill：放进
~/.claude/skills/后，扔个小红书链接给 Claude 就能用，不需要额外配置或 slash command。
小红书图文笔记的核心内容在图里，不在正文。直接把链接给 Claude 它只能看到正文 + 标签——图里讲了什么、有哪些梗、配的什么图标、决策树长什么样，全看不到。
这个 skill 让 Claude：
- 抓笔记的标题、正文、所有原图（多模态 Read 进上下文）、互动数
- 按固定 6 段格式输出（标题 / 正文 verbatim / 图意提炼 / 互动数据 / 评论区 / 一句话总结）
- （可选）调用 Claude in Chrome 扩展抓评论区
- （可选）把所有内容打包成
.md+ 图片归档到本地
效果是你不打开原笔记也能搞懂这篇在讲什么。
扔一条小红书图文笔记链接（不带任何动词），Claude 会给三选项：
👀 看了一眼，这是一条小红书图文笔记，标题《...》（作者：...）。想让我：
a) 读一下，给你讲讲这篇在说什么
b) 抓下来整理成 .md 文档存到本地
c) 别的（告诉我）
选 a 之后输出长这样：
🔍 这是一篇小红书图文笔记。
📌 标题
<原标题>
✍️ 正文（原文）
> <作者原文，verbatim>
🖼️ 图里讲了什么（N 张图）
<整体叙事逻辑 + 逐图功能 takeaway>
📊 互动
👍 X ⭐ Y 💬 Z 🔁 W
（一句话热度信号解读）
💬 评论区
N 条评论。
🧭 一句话总结
<整篇浓缩成一句>
接下来想让我：
a) 要不要下载所有图片，打包到一个文件夹？
b) 抓一下评论区（用 Claude in Chrome 扩展走你浏览器的登录态拿）
c) 归档成 .md 文档存到本地（和图片放同一个文件夹）
d) 别的？
git clone https://github.com/teemoweng/xhs-note-reader ~/.claude/skills/xhs-note-reader就这一行。Claude Code 启动时会自动扫 ~/.claude/skills/ 加载 skill。
验证安装（在 Claude Code 里随便开个会话）：
> 扔一条 xhs 链接，看 Claude 是不是按上面那个 3 选项菜单回你
或者命令行直接调脚本：
python3 ~/.claude/skills/xhs-note-reader/scripts/xhs-fetch.py 'https://xhslink.com/o/XXXXX'| 项 | 要求 | 必装？ |
|---|---|---|
| Claude Code | 任意版本 | ✅ |
| Python 3 | 3.8+ | ✅（macOS/Linux 自带） |
| 操作系统 | macOS / Linux | ✅（Windows 未测试） |
| Claude in Chrome 扩展 | Max 订阅 + Chrome/Edge |
完全不需要：
- ❌ 任何 API key
- ❌ 第三方账号
- ❌ MCP server 配置（除非要用评论区功能）
- ❌ 小红书登录态（除评论外，其他抓取走公开 web 渲染）
| 功能 | 依赖 | 默认 |
|---|---|---|
| 抓标题 / 正文 / 标签 / 互动数 | 只需 Python 3 | ✅ |
| 抓所有原图（多模态读图） | 同上 | ✅ |
| 6 段格式输出 | 同上 | ✅ |
下载图片到 ~/Downloads/xhs-<slug>/ |
同上 | 选项触发 |
归档成 .md 文件 |
同上 | 选项触发 |
| 抓评论区 | Claude in Chrome 扩展 + Max 订阅 | 选项触发 |
| 视频笔记 | ❌ 不支持（脚本会退出码 2 提示用其他工具） | — |
xhs 评论 API 需要登录态，无法纯爬虫抓取。skill 借 Claude in Chrome 扩展，用你浏览器自己的 xhs 登录态去拿。
- 装 Chrome 扩展：https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn
- 在 Claude Code 里跑
/chrome命令——会自动写 native messaging 配置 - 完全退出 Chrome 重开 + 重启 Claude Code 会话
skill 会自动检测这个扩展是否就绪，没装会主动给你引导文案，不会让你摸黑。
- Claude Max 订阅（Pro 不支持 Claude in Chrome）
- Chrome 或 Edge（Arc / Brave / WSL 不支持）
- 临时数据：
$TMPDIR/xhs-<note-id>-<random>/（图片 CDN 链接几小时内有效，临时目录系统会清） - 持久归档：
~/Downloads/xhs-<title-slug>/（用户主动选择"下载图片"或"归档 .md"时落到这里）
- ❌ 视频笔记（图文专用）
- ❌ 需要登录才能看的笔记（私密 / 仅好友可见）
- ❌ Windows / WSL（理论上 Python 部分能跑，但
open/ Claude in Chrome 都装不上）
xsec_token是鉴权参数：从小红书分享口令里复制 URL 时必须保留全串，否则鉴权失败拿不到内容- CDN 图片有时效：临时目录里的图片几小时后会 403——所以用完即弃模式是默认。需要长期保留请用"下载图片"选项主动落到
~/Downloads/ - 评论显示数 ≥ 实抓数：xhs 显示的"评论 N 条"可能 > 实际能抓到的，差额来自更深嵌套 / 折叠 / 被删评论
- 作者署名 vs 图片水印：frontmatter 里的
author是发帖账号；图片水印里的署名可能是原创插画师/工作室——以 frontmatter 为准
欢迎 issue / PR。常见可改进方向：
- Windows 支持（
open→start，Chrome MCP 路径） - 把脚本改成
argparse（加--help、--out、--version） - 缩略图 / 视频笔记的优雅降级