小红书数据采集卡壳了5分钟用xhs工具跑通第一条数据流水线【免费下载链接】xhs基于小红书 Web 端进行的请求封装。https://reajason.github.io/xhs/项目地址: https://gitcode.com/gh_mirrors/xh/xhsxhs 是一款基于小红书 Web 端封装的 Python 数据采集工具能稳定抓取笔记、用户资料与评论等公开数据。如果你正被想分析却拿不到数据困住这篇文章会用一个真实场景讲透它的用法并附上一份新手必看的避坑清单。早上九点的运营后台数据为什么总是拿不到想象一下这个画面早上九点你刚打开电脑准备给上周的笔记做复盘。结果发现——想统计竞品账号最近 30 篇笔记的点赞数只能一篇篇手动点开、复制、粘贴想看看平价防晒这个话题下到底哪些笔记在爆后台没有批量导出功能一上午过去了Excel 表格才整理到第十行眼睛已经花了。这不是你不够努力而是工具选错了。手动复制粘贴的本质是你在替机器干活。而 xhs 这类数据采集工具存在的意义就是把打开网页→翻页→复制→粘贴这套重复劳动压缩成几行代码。先搞懂一件事xhs 工具到底替你做了什么一句话概括xhs 是一个给小红书 Web 端接口做的 Python 封装层你只要传入自己的登录 Cookie就能像调用普通函数一样拿到笔记、用户、评论等数据。打个比方小红书网页版就像一家大型仓库数据都锁在货架上。xhs 相当于给你发了一张合法取货凭证签名与 Cookie并把取货流程打包成一个个标准按钮——你按下获取笔记信息它就把整篇笔记的标题、正文、点赞数、收藏数原样端给你。它的核心优势有三个轻量纯 Python 封装不需要维护复杂的爬虫框架全面覆盖笔记、用户、评论、搜索、互动操作等常见取数需求有样板项目里带了多个可直接运行的示例脚本抄作业就行。最快上手路径两条命令让第一条数据跑起来很多新手以为采集工具门槛很高其实 xhs 的最少启动步骤只有两步。第一步安装依赖。确保你的 Python 版本在 3.7 及以上然后执行pip install xhs pip install playwright playwright install第二步跑通示例。把项目里的 example/basic_usage.py 拿过来填入你自己的 Cookie直接运行就能打印出指定笔记的完整 JSON 数据。整个过程不超过五分钟。想体验源码安装、跟踪最新功能的话可以克隆仓库到本地git clone https://gitcode.com/gh_mirrors/xh/xhs cd xhs python setup.py installxhs 采集工具核心能力清单一张表看懂能采什么不需要记 API先对这张能力地图有个整体印象即可数据维度对应能力典型用途 笔记详情按笔记 ID 获取完整信息标题、正文、点赞、收藏、封面图 关键词搜索按关键词批量获取笔记话题热度、选品调研 用户数据获取用户主页、粉丝与作品列表竞品账号监控 评论体系获取一级评论与子评论用户反馈、口碑分析❤️ 互动操作点赞、收藏、关注、评论账号自动化运营辅助 登录辅助二维码登录、扫码状态检测免输入密码、多账号切换✍️ 创作者能力笔记发布测试用例中有示例定时发布、批量发笔记这套能力基本覆盖了内容运营和电商选品的绝大多数取数需求。一个真实场景用关键词搜索做选品分析说一个发生在我朋友身上的真实案例。他做美妆类目电商想判断平价防晒这个细分方向值不值得入场。按老办法他需要手动翻几百篇笔记、记录每篇的互动数据预估要花整整三天。后来他改用 xhs 的get_note_by_keyword接口写了一个不到 50 行的小脚本搜索平价防晒关键词自动翻页拉取笔记列表逐篇获取笔记详情提取点赞、收藏、评论三个指标按收藏/点赞比排序筛出互动质量最高的前 20 篇笔记。结果如何整个采集过程只花了 40 分钟从三天压缩到一顿午饭的时间。他还发现了一个有意思的规律互动率高的平价防晒笔记标题里普遍带学生党通勤这类词直接成了后续内容选题的依据。这就是数据采集带来的从感觉驱动到数据驱动的转变。新手使用 xhs 最容易踩的 5 个坑这部分是原文没有、但几乎所有新手都会遇到的坑提前看完能省下大把调试时间。坑 1Cookie 没给全。采集依赖登录态Cookie 里的a1、web_session、webId三个字段是必需的缺一个就可能返回空数据或报错。坑 2签名环境没配好。小红书接口有 x-s 签名校验xhs 通过 playwright 模拟浏览器来生成签名。如果没装playwright浏览器环境或缺少stealth.min.js签名会反复失败。解决方案是把环境补全签名失败时加个重试示例代码里已有模板。坑 3请求太频繁被限制。采集是细水长流的活建议在循环里加sleep控制节奏别一次性把接口打满。多账号场景下把 playwright 封装成统一签名服务参考 example/basic_sign_server.py能让请求更稳定。坑 4把采集工具当黑魔法。xhs 只适合采集公开可访问的数据。请合理控制频率避免对平台服务器造成压力使用数据时遵守相关法律法规与平台规则。坑 5文档没看就开写。项目文档已经写得很清楚很多疑难杂症在文档里都有答案别跳过它直接 debug。想再进阶这三份文档按需取用xhs 的文档就在项目docs/目录下全部是中文读起来没有负担docs/basic.rst快速入门指南讲清环境安装、Cookie 获取和基础用法新手必读docs/crawl.rst主页爬取 API 大全笔记、评论、搜索、互动操作的方法都在这里进阶必读docs/creator.rst创作者笔记发布说明想批量发文可以看这里。示例脚本放在 example/ 目录其中 example/login_qrcode.py 演示扫码登录example/login_phone.py 演示手机号登录example/basic_sign_usage.py 演示配合签名服务的使用方式都是可以直接借鉴的完整代码。下一步行动今天就把第一条数据拿到手读到这里你离数据自由只差动手这一步了。建议按这个顺序执行装环境pip install xhs跑通安装命令跑示例复制 example/basic_usage.py填入自己的 Cookie打印出第一篇笔记做小目标试着搜索一个你关心的关键词把结果存成 CSV 或 JSON。不需要一开始就追求大而全的系统。先让第一条数据从终端里打印出来那种原来这么简单的成就感会推着你走完剩下的路。数据不会自己跑到你面前但有了趁手的采集工具它离你只有五分钟的距离。现在就打开终端试试吧。【免费下载链接】xhs基于小红书 Web 端进行的请求封装。https://reajason.github.io/xhs/项目地址: https://gitcode.com/gh_mirrors/xh/xhs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考