Xiaohongshu Ingest

小红书笔记采集 → 统一 frontmatter Markdown → 爆款拆解 + 衍生选题。 支持笔记链接和 xhslink 短链;爆款拆解按「人群×场景×痛点×情绪×钩子」生成可复用选题。

1,337 stars 155 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add chubbyguan/chubbyskills --skill xiaohongshu-ingest
Manual install
git clone --depth 1 https://github.com/chubbyguan/chubbyskills.git /tmp/chubbyskills
mkdir -p ~/.claude/skills
cp -r /tmp/chubbyskills/xiaohongshu-ingest ~/.claude/skills/xiaohongshu-ingest

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 小红书采集 + 爆款拆解 Skill

把小红书笔记抓成结构化 Markdown 入库,再用 DeepSeek 拆解爆款逻辑、衍生可直接写的选题。
**自动区分图文与视频笔记**:图文 → 下载图片本地嵌入;视频 → 像抖音那样转成文字稿。
补齐了仓库在「中文内容采集」上最大的平台缺口,也是「采集 → 选题」创作工作流的起点。

## 环境要求

```bash
# 图文采集零依赖(仅 Python 标准库)

# 视频笔记转录需要(与抖音/B站转录同一套依赖):
pip install funasr modelscope torch torchaudio
# macOS: brew install ffmpeg   |   Ubuntu: sudo apt install ffmpeg

# 强烈建议:配置 cookie 以规避风控(从浏览器登录后复制)
export XHS_COOKIE="你的小红书 cookie 字符串"

# 爆款拆解需要 DeepSeek API Key
export DEEPSEEK_API_KEY="your-api-key"
```

## 使用方法

```bash
# 1) 采集笔记 → 统一 frontmatter Markdown
python scripts/fetch_note.py "https://www.xiaohongshu.com/explore/xxxx" -o ./out
python scripts/fetch_note.py "http://xhslink.com/xxxx" -o ./out
python scripts/fetch_note.py "链接" -o ./out --no-images   # 图文:只留图片链接不下载
python scripts/fetch_note.py "链接" -o ./out --no-video    # 视频:不转录,只留视频链接
python scripts/fetch_note.py "链接" -o ./out --fallback-text 手动正文.txt

# 2) 爆款拆解 → 拆解报告 + 5 条衍生选题
python scripts/analyze_hook.py ./out/某笔记.md -o ./out
```

## 产出

- `fetch_note.py`:标题、正文、标签、作者、互动数据(赞/藏/评)→ 统一 frontmatter Markdown(`platform: xiaohongshu`,含 `note_type: image|video`)。**按笔记类型分流**:
  - **图文笔记**:图片下载到本地 `<标题>.assets/` 并以 `![]()` 嵌入(正文常在图里,本地化后 Obsidian 直接可见)。`--no-images` 只留链接,单张失败自动回退为链接
  - **视频笔记**:提取视频直链 → ffmpeg 抽音频 → SenseVoice 转录为文字稿写入 `## 视频文字稿`。`--no-video` 只留视频链接;缺 funasr/ffmpeg 时自动降级为存链接
- `analyze_hook.py`:目标人群 / 场景 / 痛点 / 情绪价值 / 标题钩子 / 正文结构 / 可复用模板 / 5 条衍生选题(带 `- [ ]` 勾选,可直接进选题库)

## ⚠️ 关于反爬(务必先读)
Read the full skill on GitHub

Details

Skill name
xiaohongshu-ingest
Path
xiaohongshu-ingest/SKILL.md
License
MIT
Repo updated
14 October 2026

FAQ

What does the Xiaohongshu Ingest skill do?

小红书笔记采集 → 统一 frontmatter Markdown → 爆款拆解 + 衍生选题。 支持笔记链接和 xhslink 短链;爆款拆解按「人群×场景×痛点×情绪×钩子」生成可复用选题。

How do I install the Xiaohongshu Ingest skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add chubbyguan/chubbyskills --skill xiaohongshu-ingest. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Xiaohongshu Ingest popular?

It lives in chubbyguan/chubbyskills, which has 1,337 GitHub stars and 155 forks, and is included in 1 curated skill list.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.