JoeanAmier/XHS-Downloader

解决的问题

XHS-Downloader 是一款旨在从社交媒体平台小红书 (RedNote) 提取并下载内容的工具。它通过提供自动收集工作信息和批量下载文件的方法，解决了手动保存帖子、图片和视频的问题。

工作原理

该项目通过三种主要界面运行：

1. 独立应用程序： 一个 TUI（终端用户界面）程序，可以通过可执行文件或通过 Python/Docker 运行。它可以监控剪贴板中的链接并自动下载内容。
2. 用户脚本： 在浏览器中运行的 Tampermonkey 脚本，用于从推荐页面、用户个人资料、收藏夹和搜索结果中提取链接，然后将其推送到主程序进行下载。
3. 服务器模式： 可以部署为 API 服务器或 MCP（模型上下文协议）服务器，允许其他应用程序或 AI 代理请求帖子详情并触发下载。

适用对象

• 内容创作者和研究人员： 需要为分析或备份而存档小红书帖子、图片和视频的人员。
• 开发者： 希望通过 API 或 MCP 将小红书数据提取集成到自己工作流中的用户。
• 普通用户： 希望无需手动操作即可从该平台下载高质量媒体的用户。

亮点

• 全面的提取功能： 支持从已发布的作品、收藏、点赞、相册和搜索结果中提取链接。
• 灵活的下载功能： 支持图片、视频和 LivePhotos，并具有可自定义的文件命名和格式（PNG, WEBP, JPEG, HEIC）。
• 集成就绪： 提供 API 模式和 MCP 模式用于程序化访问。
• 自动化： 具有剪贴板监控和浏览器脚本集成功能，实现一键推送任务。
• 智能管理： 包括跳过已下载文件的机制，以及按作者将文件整理到不同文件夹的能力。