用途:把小红书单篇笔记沉淀到 Obsidian vault,便于长期检索。抓取标题、正文、作者、发布时间、互动数据、话题标签,并把视频/图片下载到本地;vault 内只生成一份带 frontmatter 的轻量 Markdown 笔记,二进制文件不进 vault。
主要能力:解析笔记详情页的 window.INITIAL_STATE 获取数据;按 note_id 去重,默认跳过已归档笔记;--metadata-only 只写元数据与正文、不下载媒体;--force 覆盖已归档笔记并保留已有 topics/people/摘要;媒体存到 ~/Downloads/soia-pkm-clip-rednote/<note_id>/,笔记 media_local_path 字段记录本地路径。
使用方式:从小红书 App「分享」→「复制链接」获取含 xsec_token 的完整链接,然后运行 python3 scripts/archive_rednote.py <URL>,可用 --vault、--articles-dir、--metadata-only、--force 等参数。安装:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-clip-rednote -y。依赖 Python 3(纯 stdlib)与已存在的 Obsidian vault;vault 定位优先级为 --vault、OBSIDIAN_VAULT、从 cwd 向上自动发现。
限制:仅接受 xiaohongshu.com/xhslink.com 域名链接;缺 xsec_token 或手打短链可能拿到不完整页面;找不到 INITIAL_STATE 时报错退出且不写文件;登录限定内容需配置 XHS_COOKIE(仅放私有 config.yml 或进程环境);视频直链带时效签名,下载失败会跳过但仍写入笔记与候选直链;互动数据未公开时标注而非记为 0。