SuperAPI AI 工具集

soia-pkm-clip-rednote

通用与其它

查看项目

更新于 10-16 08:46

技能介绍

用途:把小红书(rednote)单篇笔记沉淀进 Obsidian vault,便于长期检索。视频/图片二进制不进 vault,只在笔记里记录本地路径。

主要能力:解析分享链接、抓取笔记详情(标题、正文、作者、发布时间、互动数据、话题标签),下载视频/图片到本地,在 vault 生成带 frontmatter 的 Markdown 笔记;按 note_id 去重,默认跳过已归档笔记;支持 --metadata-only 只写元数据与正文、--force 覆盖并保留已有 topics/people/摘要。

使用方式:从 App「分享」→「复制链接」获取含 xsec_token 的完整链接,对 Agent 说触发词,或运行 python3 scripts/archive_rednote.py <URL>;不在 vault 内时加 --vault <path>,也可用 --articles-dir 指定文章子目录。

依赖与安装:需 Python 3(仅 stdlib)与已存在的 Obsidian vault。整体插件安装:claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-pkm-vault@soia;单技能安装:npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-clip-rednote -y。二者建议二选一,避免同一技能出现两份索引。

配置:vault 定位优先 --vault、OBSIDIAN_VAULT,其次从 cwd 向上发现;文章目录可用 --articles-dir、OBSIDIAN_ARTICLES,否则退回默认 Articles 并告警。可选 XHS_COOKIE 放私有 config.yml(~/.config/soia-skills/soia-pkm-clip-rednote/config.yml 或用 SOIA_PKM_CLIP_REDNOTE_CONFIG_FILE 指定),仅登录态门槛笔记需要。

限制:脚本只接受 xiaohongshu.com/xhslink.com 域名链接(避免登录态外泄);缺 xsec_token 或手打短链可能拿到不完整页面;找不到 window.INITIAL_STATE 时报错退出、不写半成品;视频直链带时效签名,失败则跳过下载但写入候选直链;vault 不存媒体二进制,无法确定未说明的平台、价格与额度信息暂未提供。