小红书批量下载实战一条命令把作品存成本地文件【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一款开源的小红书采集工具解决的核心问题是作品怎么从网页变成你硬盘上的文件。它把小红书下载拆成两步——先在浏览器里提取作品链接再交给本地程序存成高清图文或视频单条、批量、接口调用都支持。下面按三个问题递进讲你可以直接照做。❓ 一条作品链接能不能直接存成本地文件两条命令装好运行环境项目要求 Python 3.12 及以上版本。如果你装了uv准备过程只有两条命令git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py第一条把仓库拉到本地第二条依次完成装依赖、启动程序。不想碰命令行的话可以去 Releases 页面拿现成的压缩包解压后双击main即可Windows 和 macOS 都有。单链接下载与图集挑图复制一条作品链接https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX这类格式都支持然后python main.py --url https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX链接必须整体放在引号里。程序会自己解析信息、下载文件并在终端打印作品标题、类型和保存位置。图文默认存 JPEG视频会挑分辨率最高的源。图集里只要其中几张用--index挑python main.py --url 图文作品链接 --index 1 3 5 # 只下第 1、3、5 张 python main.py --url 链接A 链接B 链接C # 不设 index 时可批量传多个链接注意一旦设置了--index一次命令只处理一个作品链接不设它才可以一条命令塞多个链接程序会自动过滤出有效部分。视频不高清补一个 Cookie 配置如果你发现视频总是糊的多半是没配 Cookie。不配也能下但视频会被限制在低分辨率配上之后能拿到高清源文件而且整个过程不需要登录账号。获取路径浏览器打开小红书 → 按F12进开发者工具 → 切到网络选项卡并勾选保留日志 → 过滤cookie-name:web_session→ 点开任意作品从请求里复制完整 Cookie。拿到后写进Volume/settings.json首次运行自动生成之后每次下载自动带上。这个文件还能改下载格式image_format支持 JPEG、WEBP、PNG、HEIC、AUTO改完重启生效。 账号的发布/收藏/点赞作品能不能整体搬下来用浏览器用户脚本两分钟提取链接手动复制几百条链接不现实仓库里现成备好了用户脚本static/XHS-Downloader.js。装法浏览器安装 Tampermonkey篡改猴扩展扩展面板选从 URL 安装填入脚本地址刷新小红书页面装好后在任意小红书页面点脚本菜单提取发布作品链接提取点赞作品链接提取收藏作品链接都在里面。点一下脚本滚动加载并把全部链接整理进剪贴板。批量下载命令与文件命名规则把剪贴板里的链接整段交给程序再指定存哪、怎么命名python main.py --url 链接A 链接B ... --work_path ./my_downloads --name_format 发布时间 作者昵称 作品标题--work_path定保存根目录--name_format支持按发布时间、作者、标题、作品 ID、点赞数等字段自由拼文件名整理素材库很好用。想让每个作品单独占一个文件夹加--folder_mode true想让每位作者各自一个文件夹加--author_archive true。脚本直连推送后台省掉手动复制嫌复制—粘贴—跑命令还是麻烦可以把脚本和程序串起来在Volume/settings.json里把script_server设为true让程序在后台常驻浏览器里点脚本菜单的推送下载任务链接就直接进程序开下。命名、格式全部按程序配置走你只管点一下。 不想敲命令行或想接进自己的工具链图形界面粘贴即下载uv run main.py默认进入图形界面。粘贴链接、点下载作品文件就完事内置读取剪贴板复制好链接回来按一下即可读取。底部快捷键Q退出、U检查更新、S设置、R查看下载记录设置项与settings.json一一对应不习惯改 JSON 的人可以直接点选。API 模式把下载能力变成本地接口想脚本化调用跑python main.py api然后访问http://127.0.0.1:5556/docs看自动生成的交互式文档。核心接口是POST /xhs/detail最小示例from httpx import post data { url: https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX, # 必填 download: True, # 是否同时下载文件 index: [1, 3, 5], # 图集只下这几张可选 } post(http://127.0.0.1:5556/xhs/detail, jsondata, timeout30)仓库里的example.py则是跳过服务、直接在代码里调XHS类的写法参数注释齐全定制逻辑可以从它改起。请求与下载的核心逻辑在 source/application/想看实现可以顺进去。MCP 模式让 AI 助手替你采集跑python main.py mcp在支持 MCP 的客户端里加一个 streamable HTTP 服务地址填http://127.0.0.1:5556/mcp/配好后AI 助手就能直接帮你查这篇作品的信息下载这个作品的文件采集能力变成对话里的一个工具。 先回答你可能想问的不配置 Cookie 真的能用吗能大部分功能不依赖它。差别主要在视频清晰度——不配只给低分辨率版本。下载过的作品会重复下吗默认不会。成功的作品 ID 会记进Volume/ExploreID.db再遇到同链接自动跳过想强制重下去这个数据库里删掉对应记录即可。批量下几百条会被平台盯上吗程序内置请求延时会控制频率正常使用问题不大。提醒作品链接里带日期信息隔太久再用旧链接可能触发风控建议用最新提取的链接。另外脚本里的自动滚动页面默认是关闭的开启后快速滚动加载的行为可能被平台判定为自动化操作风险自担。和长截图、录屏比差别在哪截图是像素级的放大就糊这里下的是服务器原始文件图片按你指定的格式存视频取高清源还支持 livePhoto 这类动图格式。 适合谁用第一步做什么需要持续沉淀小红书素材的人——内容创作者、盯竞品的运营、要样本数据的分析师以及只想把收藏夹搬回本地的普通用户——都绕不开提取链接 落盘文件这两步。建议你先别研究全部参数从收藏夹挑一条笔记用命令行下下来感受一下一条命令换一个本地文件的流程跑顺之后再回头配批量提取和后台推送。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
