当前位置：首页 > news >正文

小红书数据采集工具 xhs：从复制粘贴到一键取数，只差这一条命令

news 2026/8/14 19:51:29

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

xhs是一款基于小红书 Web 端请求封装的开源 Python 库，专治"想分析数据却拿不到结构化结果"的尴尬：笔记详情、用户资料、评论层级，一条命令就能落成 Python 字典。这篇指南不背功能清单，我们从你真实遇到的痛处讲起，再带你三分钟跑通第一条数据获取命令。

回想一下你上一次想做小红书内容分析：打开网页版，翻到某条爆款笔记，手动复制标题、数点赞、抄评论。一条还好，十条开始烦躁，一百条直接劝退——而你需要的数据，往往是一千条起。

更要命的是，复制下来的只是碎片：点赞数、评论数、发布时间散落在页面不同位置，拼进 Excel 又是一场噩梦。你缺的不是数据，是一条能把网页变成结构化 JSON 的通道。

更别提那些更隐蔽的诉求：想监控竞品账号更新、想统计某关键词下所有笔记的互动分布、想把评论区按热度排个序……靠人工？时间不允许。

小红书数据采集工具 xhs干的正是这件事：把小红书的网页请求封装成一个个直觉化的方法，让"取数"从体力活变成一行代码。

note = client.get_note_by_id("笔记ID", "xsec_token")

上面这一行，返回的就是一条笔记的完整字典：标题、正文、标签、图片链接、点赞收藏评论数，全在里面。💡 记住这行的感觉，后面所有功能都是同一套逻辑。

它有 3 个让人记住的记忆点：

不需要你会逆向、不需要懂签名算法，它已经帮你把最难啃的骨头啃完了。

别被"签名"两个字吓到，跟着走就行。

第一步，安装。Python 3.7+ 即可：

pip install xhs playwright playwright install

第二条命令是给签名服务装浏览器内核，第一次运行会下载一会儿，耐心等。

第二步，取 cookie。打开小红书网页版并登录，在开发者工具里复制 cookie 字符串，重点确认包含a1、web_session、webId三个字段。

第三步，跑第一条数据。参考项目里的 example/basic_usage.py，把 cookie 填进XhsClient(cookie, sign=sign)，然后：

note = client.get_note_by_id("6505318c000000001f03c5a6", "笔记的xsec_token") print(note["title"], note["liked_count"], note["comment_count"])

看到标题和互动数据打印出来的那一刻，你就已经打通了整条取数链路——之后的任何功能，都只是换一个方法名而已。🚀

基础跑通只是开始，这 3 个能力才是它真正"能干活"的证明：

整号批量抓取：get_user_all_notes(用户ID)会循环翻页把某个作者的全部笔记拉下来，配合crawl_interval参数控制节奏，一个账号的历史内容几分钟内全部到手。
全量评论 + 图片落盘：get_note_all_comments()把一级评论和楼中楼一起捞干净；save_files_from_note_id()则能把笔记里的所有图片直接下载到本地文件夹，做素材收集极方便。
签名服务化：签名的活可以交给一个独立的 Flask 服务（参考 example/basic_sign_server.py），主程序只发请求。多账号协同、长期挂机时，这个架构能显著降低签名失败率。

也就是说，它不只是"能玩"，批量采集这种生产级需求，它同样接得住。