Xhs Data

该 Skill 提供小红书数据采集层：API 逆向引擎用于搜索笔记、笔记详情、评论与用户信息，Selenium/Playwright 浏览器引擎用于用户主页滚动抓取、单篇笔记提取和图片/视频下载，结果保存为 JSON、Markdown 与媒体文件，并给出限速、401/403、461 错误和代理等风控处理说明。

cooperiano

热度 9.68

最近更新 2026-07-10 11:47:40

分类：数据依赖：代码执行 / 联网浏览搜索 / 读写文件 / 第三方 API应用场景：数据处理 / 自动化脚本 / 研究 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add xhs-data

Metadata

name: xhs-data
description: 小红书数据采集层：笔记提取/用户主页抓取/搜索/媒体下载，Selenium+API双引擎，自动处理加密参数
user-invocable: true
metadata: {"openclaw":{"emoji":"📥","tags":["xiaohongshu","data","scraping","crawler","media"]}}

XHS Data v2.0 — 小红书数据采集层

双引擎架构

引擎	技术	适合
🔌 API引擎	RedCrack 纯Python逆向	搜索/评论/用户信息/关注点赞
🌐 浏览器引擎	Selenium/Playwright	用户主页滚动/单篇提取/媒体下载

API 引擎

pip install aiohttp loguru pycryptodome getuseragent

搜索笔记

xhs = await create_xhs_session(proxy=None, web_session=None)
res = await xhs.apis.note.search_notes("关键词")

笔记详情

res = await xhs.apis.note.note_detail(note_id, xsec_token)

res = await xhs.apis.comments.get_comments(note_id, xsec_token)

用户信息

res = await xhs.apis.user.get_user_info(user_id)

笔记元数据提取(URL→JSON)

python scripts/xiaohongshu_extract.py "<url>" --pretty --output /tmp/note.json

浏览器引擎

抓取用户主页

# Selenium + Chrome, 滚动到底部, 提取所有note_id
# 输出: note_ids.txt + note_links.json + note_links.md

抓取单篇笔记

# 保存 page.html + post_data.json + post.md

媒体下载

# 自动提取 image(jpg/png/webp) + video(mp4)
# 限制: 每篇≤10图, ≤5视频

存储路径

用户主页：~/disk/xiaohongshu/data/{userId}/
单篇笔记：~/disk/xiaohongshu/posts/{noteId}/

风控处理

461错误：降频 + sleep + 换关键词 + 用登录态
401/403：web_session过期
代理：支持 proxy="http://127.0.0.1:7890"

链接格式

笔记：xiaohongshu.com/explore/<note_id>
用户：xiaohongshu.com/user/profile/<user_id>

安全

间隔 ≥2秒, 单用户≤500篇
只抓公开内容
仅供学习研究