JoeanAmier/XHS-Downloader

解决的问题

小红书（又称 RedNote）是一个用户分享照片、视频和文字帖子的社交平台。目前没有官方方式直接下载这些帖子。此工具通过让用户粘贴帖子链接并自动提取所有可下载内容（图片、视频、封面和实况照片）并保存到本地来解决这一问题。它还支持同时处理多个链接，并可跳过已下载的文件。

工作原理

该程序解析小红书帖子 URL（包括像 xhslink.com 这样的短链接），然后利用平台的网页数据获取帖子的信息和下载链接。它提供了多种使用方式：

• 图形用户界面（GUI）和终端用户界面（TUI）用于交互式使用。
• 命令行模式用于脚本化或批量下载。
• API 模式运行本地服务器（端口 5556），允许其他程序通过 HTTP 请求帖子数据或触发下载。
• MCP（模型上下文协议）模式，使 AI 助手和类似工具可以调用下载器。
• 浏览器用户脚本（适用于 Tampermonkey），可以从发现页、用户主页、搜索页等页面提取帖子链接，并将下载任务推送给正在运行的程序。

配置存储在 settings.json 文件中，程序可以读取 Cookie（可选，但可提高视频质量）并在需要时使用代理。它还具有延迟机制以避免对平台造成过载。

适用人群

它面向任何希望从小红书下载内容以用于个人存档、研究或其他合法目的的人。对于希望将小红书内容获取集成到自己应用程序中的开发者来说，它也很有用，因为它提供了 API 和 MCP 接口，并且源代码可以作为库使用。

亮点

• 多种运行方式：GUI、TUI、CLI、Docker、API 服务器和 MCP 服务器。
• 可以下载图片、视频（提供 Cookie 时可获得更高质量）、视频封面和实况照片。
• 批量处理：可以一次提供多个链接。
• 自动跳过已下载的文件，并记录已下载的帖子 ID。
• 可自定义文件命名和文件夹结构；可以将每位作者的帖子保存在单独的文件夹中。
• 支持通过索引列表仅下载多图帖子中的特定图片。
• 浏览器用户脚本可以从网站的许多部分提取帖子链接并将其推送到主程序。
• 包含 API 和 MCP 访问的身份验证，以防止未经授权的使用。