Agent skill

Xiaohongshu Ingest

by chubbyguan in chubbyguan/chubbyskills

小红书笔记采集 → 统一 frontmatter Markdown → 爆款拆解 + 衍生选题. An agent skill from chubbyguan/chubbyskills.

MITAuto-check: notesMedia & Creative

Install Xiaohongshu Ingest

skills CLI
$ npx skills add chubbyguan/chubbyskills --skill xiaohongshu-ingest -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install chubbyguan/chubbyskills xiaohongshu-ingest --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/chubbyguan/chubbyskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/xiaohongshu-ingest .claude/skills/xiaohongshu-ingest && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
xiaohongshu-ingest
GitHub stars
1.2k
Token cost
~613 tokens
SKILL.md length
102 words
Files
4 (incl. scripts)
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

小红书笔记采集 → 统一 frontmatter Markdown → 爆款拆解 + 衍生选题. An agent skill from chubbyguan/chubbyskills.

  • Works in 3 steps: 优先解析页面内嵌的 INITIAL_STATE 结构化数据 → 失败则回退到 og: 元标签 → 仍失败时给出明确提示——此时可手动复制笔记正文存成 .txt,用…
  • Media & Creative work in your project
  • SKILL.md covers 环境要求, 使用方法, 产出 and ⚠️ 关于反爬(务必先读), plus 3 more sections
  • Runs Python scripts from its folder; calls python and pip; reaches xiaohongshu.com and xhslink.com; needs DEEPSEEK_API_KEY

What it does

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

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/analyze_hook.py` and `scripts/fetch_note.py`).

It sits in Media & Creative. It works with Xiaohongshu and Obsidian. The repository describes itself as: 把中文全渠道内容(抖音 / B站 / 小红书 / 公众号 / X / 播客)采集进个人知识库的 14 个 AI Skill:图文存图、视频转文字稿、字幕优先免 GPU、RSS/YouTube 订阅调度与每日情报简报,附带知识库 MCP server。| Ingest Chinese content into your personal knowledge… The licence is MIT.

When your agent uses it

  • Media & Creative work in your project

Example prompts

  • “/xiaohongshu-ingest”

Requirements

  • Python 3
  • A credential in DEEPSEEK_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 优先解析页面内嵌的 INITIAL_STATE 结构化数据
  2. 失败则回退到 og: 元标签
  3. 仍失败时给出明确提示——此时可手动复制笔记正文存成 .txt,用 --fallback-text 继续生成统一 Markdown,或直接走 analyze_hook.py 拆解(拆解环节不依赖抓取)

What it can do on your machine

Read from SKILL.md and the folder at commit 1b759b1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • xiaohongshu.com
    • xhslink.com

    Also links to:

    • platform.deepseek.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • DEEPSEEK_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Xiaohongshu Ingest loads about 613 tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 102 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~613

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:26
    macOS: brew install ffmpeg   |   Ubuntu: sudo apt install ffmpeg

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from chubbyguan/chubbyskills at commit 1b759b1, republished under its MIT licence (© chubbyguan). 102 words, ~613 tokens.

Download SKILL.mdSave it as .claude/skills/xiaohongshu-ingest/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
xiaohongshu-ingest
description
小红书笔记采集 → 统一 frontmatter Markdown → 爆款拆解 + 衍生选题。 支持笔记链接和 xhslink 短链;爆款拆解按「人群×场景×痛点×情绪×钩子」生成可复用选题。
metadata.category
content
metadata.triggers
["用户发送小红书笔记链接", "采集这篇小红书笔记", "拆解这个爆款笔记", "帮我做小红书选题"]
metadata.version
1.0.0
metadata.tags
["content", "xiaohongshu", "ingest", "hook-analysis", "topic"]

小红书采集 + 爆款拆解 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 条衍生选题(带 - [ ] 勾选,可直接进选题库)

⚠️ 关于反爬(务必先读)

小红书风控严格,未登录的纯脚本访问经常被拦。本 skill 的策略:

  1. 优先解析页面内嵌的 __INITIAL_STATE__ 结构化数据
  2. 失败则回退到 og: 元标签
  3. 仍失败时给出明确提示——此时可手动复制笔记正文存成 .txt,用 --fallback-text 继续生成统一 Markdown,或直接走 analyze_hook.py 拆解(拆解环节不依赖抓取)

提供 XHS_COOKIE 能显著提高采集成功率。页面结构若调整,需更新 fetch_note.py 里的选择器。

合规声明

仅供个人学习与研究使用。请遵守小红书用户协议与 robots 规则,控制请求频率,不要用于批量抓取、商用爬取或侵犯他人权益的场景。

衔接工作流

  • 采集产物 → knowledge-base-management 入库(统一 frontmatter,按 platform 聚合)
  • 衍生选题 → 创作者选题流(采集 → 拆解 → 选题库 → 初稿)
  • 多篇拆解 → 沉淀「爆款选题库」,对接 industry-intelligence-radar 的趋势信号

参考

  • 小红书爆款方法论:人群 × 场景 × 痛点 + 情绪价值
  • DeepSeek — 拆解用 LLM

© chubbyguan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in xiaohongshu-ingest of chubbyguan/chubbyskills.

  • SKILL.md
  • requirements.txt
  • scripts/analyze_hook.py
  • scripts/fetch_note.py

Open the folder on GitHubat commit 1b759b1

Compare with similar skills

Xiaohongshu Ingest next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Xiaohongshu Ingest compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xiaohongshu Ingest this skillchubbyguan/chubbyskills1.2k—~613Automated safety check: NotesMIT
Xiaohongshu Cover Generatorchenxiachan/xhs-claude-skills421—~1.1kAutomated safety check: NotesMIT
WwudJamailar/Beav1.8k—~1.6kAutomated safety check: PassCustom licence
Xhs Visual Directorziguishian/xhs-visual-director-skill1.4k—~2.2kAutomated safety check: PassMIT
Video To NotesKIRVO-REPORTING/video-to-notes105—~1.5kAutomated safety check: PassMIT
Lingzaoatian-create/lingzao-skill2961 repos~8.8kAutomated safety check: PassMIT

Similar skills

  • Xiaohongshu Cover Generator

    chenxiachan/xhs-claude-skills

    Creates a Xiaohongshu-style 3:4 cover image from a title by building an HTML page in one of six visual styles and capturing it with Playwright.

    421 GitHub stars~1.1k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: notes
  • Wwud

    Jamailar/Beav

    What Would User Do for RedConvert. An agent skill from Jamailar/Beav.

    1.8k GitHub stars~1.6k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Xhs Visual Director

    ziguishian/xhs-visual-director-skill

    A skill your agent uses when planning, redesigning, or reviewing Xiaohongshu carousel visuals, covers, 3:4 image posts, page-by-page visual direction, image-generation prompts, style selection…

    1.4k GitHub stars~2.2k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Video To Notes

    KIRVO-REPORTING/video-to-notes

    Use immediately for any bare YouTube or YouTube Shorts URL, youtu.be link, Bilibili or b23.tv link, or other video URL; do not ask what the user wants.

    105 GitHub stars~1.5k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Lingzao

    atian-create/lingzao-skill

    Use Lingzao creator-content tools for Xiaohongshu/XHS, Douyin, and WeChat official-account public content.

    296 GitHub starsUsed in 1 repo~8.8k tokens
    Media & CreativeAuto-check passed
  • Image Director

    Jamailar/Beav

    A skill your agent uses when the user wants to做一整套图片、组图、卡片图、轮播图、配图包或电商套图.

    1.8k GitHub stars~3.6k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed

More from chubbyguan/chubbyskills

All 14 skills in this repo
  • Bilibili Transcribe

    chubbyguan/chubbyskills

    哔哩哔哩视频 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.

    1.2k GitHub stars~578 tokensUpdated 3 days ago
    Auto-check: notes
  • Douyin Transcribe

    chubbyguan/chubbyskills

    抖音视频 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.

    1.2k GitHub stars~551 tokensUpdated 3 days ago
    Auto-check: notes
  • Industry Intelligence Radar

    chubbyguan/chubbyskills

    行业情报雷达:多源扫描(X/即刻/V2EX/HN) → 关键词过滤 → 趋势检测 → 每日情报简报。触发词:行业情报、竞品监控、热点扫描、情报雷达

    1.2k GitHub stars~806 tokensUpdated 3 days ago
    Auto-check passed
  • Knowledge Base Management

    chubbyguan/chubbyskills

    管理本地 Markdown/Obsidian 知识库:素材入库、健康检查、增量索引、关键词与 semantic-lite 检索、逐字原文资料包、归档和 MCP 连接。用于搜索知识库、整理资料及为 Agent 准备可定位的引用。

    1.2k GitHub stars~3.3k tokensUpdated 3 days ago
    Auto-check passed
  • Learning Notes Automation

    chubbyguan/chubbyskills

    学习笔记自动化:视频/播客转录 → 知识点提取 → 闪卡生成 → 知识图谱更新。触发词:学习笔记、闪卡、Anki、知识提取、视频学习

    1.2k GitHub stars~898 tokensUpdated 3 days ago
    Auto-check passed
  • Podcast Transcribe

    chubbyguan/chubbyskills

    播客/小宇宙 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.

    1.2k GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check: notes

Questions about Xiaohongshu Ingest

What does Xiaohongshu Ingest do?

小红书笔记采集 → 统一 frontmatter Markdown → 爆款拆解 + 衍生选题. An agent skill from chubbyguan/chubbyskills. Xiaohongshu Ingest is an agent skill from chubbyguan/chubbyskills.

When should I use Xiaohongshu Ingest?

Xiaohongshu Ingest fits situations like: media & Creative work in your project.

How do I install Xiaohongshu Ingest in Claude Code?

Run `npx skills add chubbyguan/chubbyskills --skill xiaohongshu-ingest -a claude-code`. Or copy the skill folder (xiaohongshu-ingest in chubbyguan/chubbyskills) into .claude/skills/xiaohongshu-ingest in your project. Claude Code loads it when a task matches its description.

How do I install Xiaohongshu Ingest in Codex?

Run `npx skills add chubbyguan/chubbyskills --skill xiaohongshu-ingest -a codex`. Or copy the skill folder (xiaohongshu-ingest in chubbyguan/chubbyskills) into .agents/skills/xiaohongshu-ingest in your project. Codex loads it when a task matches its description.

Can I use Xiaohongshu Ingest in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add chubbyguan/chubbyskills --skill xiaohongshu-ingest -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xiaohongshu-ingest, .gemini/skills/xiaohongshu-ingest, .github/skills/xiaohongshu-ingest and .opencode/skills/xiaohongshu-ingest in your project.

What does Xiaohongshu Ingest need to run?

Going by SKILL.md and its folder, Xiaohongshu Ingest needs Python for the scripts in its folder, the command-line tools its instructions call (python and pip) and credentials named DEEPSEEK_API_KEY. Our summary lists: Python 3; A credential in DEEPSEEK_API_KEY.

Does Xiaohongshu Ingest access the network?

SKILL.md names 3 domains. In commands or code: xiaohongshu.com and xhslink.com; the agent is likely to contact these when it follows the instructions. As links in the text: platform.deepseek.com. This is read from the text; nothing was executed.

Is Xiaohongshu Ingest safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Xiaohongshu Ingest use?

Xiaohongshu Ingest is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Xiaohongshu Ingest use?

About 613 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Xiaohongshu Ingest?

Skills that share tags, products or a category with Xiaohongshu Ingest: Xiaohongshu Cover Generator (chenxiachan/xhs-claude-skills, 421 stars), Wwud (Jamailar/Beav, 1.8k stars), Xhs Visual Director (ziguishian/xhs-visual-director-skill, 1.4k stars) and Video To Notes (KIRVO-REPORTING/video-to-notes, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xiaohongshu Ingest?

chubbyguan (a GitHub user) maintains it in chubbyguan/chubbyskills, which has 1,217 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 8, 2026.

Source: chubbyguan/chubbyskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.