小红书数据采集完整指南：用 xhs 三步拿到笔记、评论与用户数据-平芜编程栈

小红书数据采集完整指南：用 xhs 三步拿到笔记、评论与用户数据

【免费下载链接】xhs基于小红书 Web 端进行的请求封装。https://reajason.github.io/xhs/项目地址: https://gitcode.com/gh_mirrors/xh/xhs

每晚盯着竞品品牌的新品笔记：逐条打开、手动记下点赞和收藏数、再翻评论区看用户吐槽，忙完一晚上快过完了。开源工具 xhs 把小红书 Web 端请求封装成 Python 接口：想取什么，调用对应方法，笔记、评论、用户数据都能拿到。

xhs 是基于小红书 Web 端请求封装的开源爬虫，在 PyPI 上发布，一条命令就能装好。初始化客户端后，你只需要调用对应方法就能拿到结构化数据，不用自己啃签名算法。

核心接口全封装：笔记详情、用户资料、主页推荐、关键词搜索，公开数据一次拿全
多级评论支持：一级评论、子评论都能取，讨论现场完整还原，口碑分析不用靠猜
交互功能内置：点赞、收藏、关注、发评论都支持，一套接口"读"和"写"都管
两种签名方案：纯 Python 签名与浏览器模拟签名任选，防伪算法不用自己研究
文档示例齐全：basic、crawl、creator 三份文档（docs/basic.rst、docs/crawl.rst、docs/creator.rst），example 目录还有多份可直接运行的脚本

第一步：安装依赖

需要 Python 3.7 及以上版本。除了 xhs 本体，还要装 playwright 和浏览器内核，用来模拟浏览器生成签名：

pip install xhs pip install playwright playwright install

第二步：准备"入场券"（Cookie）

小红书接口每次请求都要求带 x-s 签名，相当于给请求盖上的"防伪章"；同时还得带上你自己的登录 Cookie，也就是"入场券"。在已登录的小红书网页版里打开浏览器开发者工具，从请求头里复制 Cookie，确认a1、web_session、webId三个字段都在，缺一个都跑不起来。

第三步：运行第一个示例

example/basic_usage.py 是最佳起点，把文件里的 cookie 换成你自己的，运行python example/basic_usage.py，就能打印出指定笔记的完整 JSON——标题、正文、点赞、收藏、评论数、图片链接全在里面。想自己调接口，核心就这几行：

from xhs import XhsClient client = XhsClient(cookie="your_cookie", sign=sign) note = client.get_note_by_id("笔记ID", "xsec_token")

跑通之后，去 docs/crawl.rst 里对着接口清单挑功能就行。

定内容方向之前，先看看市场。get_note_by_keyword()按关键词搜笔记，支持按热度、时间排序；再配合get_note_by_id()拉出每篇的详情，标题和封面套路就摸清了，动手之前心里已有底。适合内容创作者、新媒体小编做选题调研。

想知道对手多久发一篇、哪类内容最容易爆。get_user_info()拿用户资料，get_user_notes()批量拉取笔记列表，get_user_all_notes()自动翻页。按天定时跑一遍，对手的更新节奏和内容规律就一目了然。适合品牌运营、电商从业者。

评论区才是最真实的口碑现场。get_note_comments()取一级评论，get_note_sub_comments()往下钻子评论，get_note_all_comments()一次自动拉完。这是你零成本能拿到的最真实的产品反馈。适合做产品口碑分析、用户画像研究的团队。

签名失败了怎么办？浏览器签名偶发抽风，示例已内置重试逻辑，直接重跑即可；总不行就把页面加载后的等待时间调长一点，也可以改用 xhs.help 内置的纯 Python 签名试试。
提示 IP 风控或封禁？高频请求最容易触发风控，请求之间加上几秒间隔，慢一点反而更稳。
多账号共用签名服务？进阶用法是把签名部署成独立服务（见 example/basic_sign_server.py），多账号共用时务必让各账号 Cookie 里的a1 保持一致，否则会一直签名报错。
合规提醒：只采集公开可访问的数据，不给目标网站施压，遵守法律法规与平台规则；项目为个人学习用途的开源作品，使用风险请自行评估。

让代码替你做重复劳动，你的精力留给业务本身。运行git clone https://gitcode.com/gh_mirrors/xh/xhs拿到源码，今晚就能跑通 example 里的第一个示例。

【免费下载链接】xhs基于小红书 Web 端进行的请求封装。https://reajason.github.io/xhs/项目地址: https://gitcode.com/gh_mirrors/xh/xhs

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考