开源小红书作品采集：从桌面到 API 的一体化本地工具

小新平时做内容整理时，经常要把平台上的图文或视频留一份在本地备份，或把链接批量交给脚本处理。纯手动逐条保存既慢又容易漏，他更希望有一款能在自己电脑上跑、又能接进自动化流程的工具。这款以 Python 为主、带图形化终端界面的小红书链接提取与作品采集程序，正好把「粘贴链接、拿详情、按需下载」串成一条线。

安装文档里写得很直白：可以下载打包好的可执行程序开箱即用，也可以用源码配合虚拟环境或容器运行。小新注意到 Cookie 并非硬性要求，但若想拿到更清晰的视频画质，按教程配置网页端 Cookie 会更稳。程序还支持把作品元数据持久化到本地数据库、记录已下载作品 ID 以免重复拉取，对长期归档的人比较友好。

核心功能

小新最常用的是把作品页或短链丢进去，让程序解析出信息与可下载地址。图文可以按序号挑选要下的图片，视频与 livePhoto 也有对应开关；断点续传和完整性处理能减少大文件下到一半失败的心累。剪贴板监听适合一边浏览一边复制链接的场景，命令行模式则方便他写成小脚本批量调用。

若配合浏览器里的用户脚本，还能在页面上批量提取账号发布、收藏、点赞、专辑或搜索结果里的链接，再推给本机程序处理。服务端形态下，本地会起一个 HTTP 接口，文档里用 FastAPI 自动生成交互式说明，POST 到详情接口即可只取 JSON 或顺带把文件落盘。另有 MCP 模式，便于和支持 MCP 的助手类工具对接。

系统技术栈

工程要求 Python 3.12 及以上。依赖侧可见 FastAPI 与 Uvicorn 承担 Web 服务，httpx 负责异步 HTTP，并启用了 HTTP/2 与 SOCKS 相关能力；终端界面由 Textual 驱动；配置与数据侧用到 PyYAML、aiosqlite、aiofiles；剪贴板读写依赖 pyperclip；另有 Click 做命令行入口、emoji 与 lxml 等配套库。容器场景采用多阶段 Dockerfile，构建阶段在完整 Python 镜像中安装依赖，运行阶段落到 slim 镜像并暴露 5556 端口，工作目录下通过 Volume 挂载持久化下载与配置。国际化方面仓库带有 locale 与中英消息资源。许可证为 GPL-3.0。

特色主要在哪里？

小新觉得这套东西把「个人桌面工具」和「可被其它程序调用的服务」放在同一个发行版里，切换成本很低：同一套逻辑，TUI 里点点、Docker 里跑 api 或 mcp、二次开发时参考 example 里的异步调用即可。用户脚本与主程序联动时，只要把配置里的脚本服务器打开并保持程序在后台，就能从浏览器一键推送下载任务。

产品说明里反复强调请求节流与风控提示，例如链接里带的时间信息过期可能触发限制，建议用较新的分享链。Docker 下剪贴板相关能力不可用，属于形态取舍，写进文档里反而让人少走冤枉路。

对我们的生活/工作有什么帮助？

对个人而言，小新可以把收藏夹里的教程、参考素材批量落到本地硬盘，离线翻看或剪辑时不必反复打开 App。对小团队，运营或剪辑可以把标准化下载交给一台内网机器上的服务实例，由内部工具 POST 链接取回文件路径或元数据，减少人工传递网盘链的中间环节。对学习者，从依赖清单到 Dockerfile 都能对照着理解「如何用现代 Python 异步栈做一个带 UI 的下载器」，比只看概念图更有抓手。

当然，任何采集与下载都要遵守平台规则与著作权法律，仅用于自己有权限的内容或已获授权的场景；工具本身不提供绕过付费或破解能力，使用者需自行把握边界。

普通人如何实现盈利？

合规前提下，小新能想到的是承接「帮客户部署私有化采集归档环境」的实施服务：在客户机器上装好程序与配置，写好备份策略与更新说明。也可以为工作室定制二次开发，例如把 API 嵌进现有工单或素材库系统。培训与文档服务适合教运营同事安全、规范地使用工具与脚本。以上路径都需要技术沟通能力和合法合同支撑，不宜夸大「自动化躺赚」，更不应涉及未授权内容的批量分发。