SuperAPI AI 工具集

xiaohongshu-media-collector

数据与分析

查看项目

更新于 10-16 09:51

技能介绍

用途:本技能用于从小红书(XHS)规范化数据集中收集已验证的封面图片资源,生成本地媒体清单并下载文件,适合需要可复现本地封面图资产的场景,例如为小红书卡片合成或下游审阅准备素材。

主要能力:仅收集上游验证数据集已暴露的资源 URL,默认支持规范化 XHS 帖子数据集中的 coverUrl;可构建本地清单、从规范化数据中已有的远程 URL 下载封面图,并校验下载文件存在且非空。

不支持的默认能力:从笔记页面提取非封面图片、直接下载小红书视频。若验证过的下载器返回 404 Not found,不得假称视频收集可用。接受媒体请求前应告知用户:发布路径仅支持上游数据集中已验证的封面图,不支持小红书视频下载。

失败姿态:输入数据集无可下载 coverUrl、请求资源类型为视频、请求资源角色非封面、下载返回非 2xx 时均失败;清单作为已下载资源的唯一事实来源。

使用方式:媒体清单、下载报告和中间校验文件保存在 <work-folder>/.postplus/xiaohongshu-media-collector/ 下,最终用户资产放在 .postplus/ 外。先进行有界首轮,通常 3-10 张封面图。主要脚本包括 scripts/build_xhs_media_manifest.mjs、scripts/download_xhs_media_assets.mjs、scripts/verify_xhs_media_manifest.mjs。最小工作流命令:

node ${CLAUDE_SKILL_DIR}/scripts/build_xhs_media_manifest.mjs --input <work-folder>/.postplus/xhs-normalized.json --limit 3 --output <work-folder>/.postplus/xhs-media-manifest.json

node ${CLAUDE_SKILL_DIR}/scripts/download_xhs_media_assets.mjs --manifest <work-folder>/.postplus/xhs-media-manifest.json --output-dir <work-folder>/.postplus/xhs-media-assets --output <work-folder>/.postplus/xhs-media-download-report.json

node ${CLAUDE_SKILL_DIR}/scripts/verify_xhs_media_manifest.mjs --manifest <work-folder>/.postplus/xhs-media-download-report.json

输出应包含清单路径、已下载文件数、失败资源数及供下游使用的本地稳定文件路径。实施前需阅读 references/validated-surfaces.md 与 references/manifest-schema.md。旧别名:xhs-media-collector。遵循 postplus-shared 公共技能规则。适用场景为从已验证数据集下载小红书封面图、把规范化研究输出转为本地媒体清单、准备本地封面图资产。限制:不发现笔记 URL、不提取帖子元数据、不提取任意笔记图片、默认不从笔记 URL 下载视频。