Skip to content
Conduit

skill

xhs-note-reader

把小红书图文笔记完整地读进 Claude Code 当上下文 — 标题 + 正文 + 全部图片 + 互动数据 + 评论区。一条链接就够。

teemoweng/xhs-note-readercommunitylistedunreviewed
Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/teemoweng/xhs-note-reader itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 23, 2026

xhs-note-reader

把小红书图文笔记完整地"读"进 Claude Code 当上下文——标题 + 正文 + 全部图片 + 互动数据 + 评论区，一条链接就够。

这是一个 Claude Code skill：放进 ~/.claude/skills/ 后，扔个小红书链接给 Claude 就能用，不需要额外配置或 slash command。

它解决什么问题

小红书图文笔记的核心内容在图里，不在正文。直接把链接给 Claude 它只能看到正文 + 标签——图里讲了什么、有哪些梗、配的什么图标、决策树长什么样，全看不到。

这个 skill 让 Claude：

  1. 抓笔记的标题、正文、所有原图（多模态 Read 进上下文）、互动数
  2. 按固定 6 段格式输出（标题 / 正文 verbatim / 图意提炼 / 互动数据 / 评论区 / 一句话总结）
  3. （可选）调用 Claude in Chrome 扩展抓评论区
  4. （可选）把所有内容打包成 .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 33.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 登录态去拿。

三步安装

  1. 装 Chrome 扩展：https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn
  2. 在 Claude Code 里跑 /chrome 命令——会自动写 native messaging 配置
  3. 完全退出 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 为准

License

MIT

Contributing

欢迎 issue / PR。常见可改进方向：

  • Windows 支持（open → start，Chrome MCP 路径）
  • 把脚本改成 argparse（加 --help、--out、--version）
  • 缩略图 / 视频笔记的优雅降级
↑↓ navigate openesc close