Back to Details

xiaohongshu-media-collector

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

XHS Media Collector

XHS 媒体收集工具

Follow shared release-shell rules in:
  • postplus-shared
    release-shell rules
Legacy alias: 
xhs-media-collector
.
Use this skill when the user wants to:
  • download Xiaohongshu cover images from validated datasets
  • turn normalized XHS research output into a local media manifest
  • prepare local image assets for XHS card composition or downstream review
Read these references before implementation:
  • skills/20-research/xhs-media-collector/references/validated-surfaces.md
  • skills/20-research/xhs-media-collector/references/manifest-schema.md
遵循以下共享的release-shell规则：
  • postplus-shared
    release-shell规则
旧版别名：
xhs-media-collector
。
当用户有以下需求时可使用本Skill：
  • 从经过验证的数据集中下载小红书封面图片
  • 将标准化的XHS研究输出转换为本地媒体清单
  • 为小红书卡片制作或后续审核准备本地图片资源
在实施前请阅读以下参考文档：
  • skills/20-research/xhs-media-collector/references/validated-surfaces.md
  • skills/20-research/xhs-media-collector/references/manifest-schema.md

Default posture

默认规则

Only collect asset URLs that are already exposed by a validated upstream dataset.
Supported by default:
  • coverUrl
    from normalized XHS post datasets
Not supported by default:
  • direct Xiaohongshu video downloader output
Do not pretend video collection works when the validated downloader returns 
404 Not found data
.
仅收集已通过上游验证数据集公开的资源URL。
默认支持：
  • 标准化XHS帖子数据集中的
    coverUrl
默认不支持：
  • 直接下载小红书视频的输出
当验证过的下载器返回
404 Not found data
时，请勿伪装视频收集功能可用。

What this skill is for

本Skill的适用场景

  • building a local manifest from normalized XHS datasets
  • downloading cover or image assets from remote URLs
  • verifying that downloaded files exist and are non-empty
  • 从标准化XHS数据集构建本地清单
  • 从远程URL下载封面或图片资源
  • 验证下载的文件是否存在且非空

What this skill is not for

本Skill的非适用场景

  • discovering note URLs
  • extracting post metadata
  • downloading videos from note URLs by default
  • 发现笔记URL
  • 提取帖子元数据
  • 默认从笔记URL下载视频

Failure posture

失败处理规则

  • fail if the input dataset contains no downloadable remote image URLs
  • fail if the requested asset type is 
    video
  • fail if a download returns a non-2xx response
  • keep the manifest as the single source of truth for downloaded assets
  • 如果输入数据集不包含可下载的远程图片URL，执行失败
  • 如果请求的资源类型为
    video
    ，执行失败
  • 如果下载返回非2xx响应，执行失败
  • 将清单作为已下载资源的唯一可信来源

Release-Shell Execution Contract

Release-Shell 执行约定

  • keep media manifests, download reports, and intermediate verification files under 
    <work-folder>/.postplus/xiaohongshu-media-collector/
  • keep only final downloaded user-facing assets outside 
    .postplus/
  • start with a bounded first pass, usually 
    3-10
    cover images before broader pulls
  • fail fast if a download fails or the requested asset surface is not validated instead of pretending collection succeeded
  • 将媒体清单、下载报告和中间验证文件保存在
    <work-folder>/.postplus/xiaohongshu-media-collector/
    目录下
  • 仅将最终面向用户的已下载资源保存在
    .postplus/
    目录外
  • 先进行有限次数的首次尝试，通常在进行大范围拉取前先下载
    3-10
    张封面图片
  • 如果下载失败或请求的资源未经过验证，立即终止并返回失败，而非伪装收集成功

Main scripts

主要脚本

  • scripts/build_xhs_media_manifest.mjs
  • scripts/download_xhs_media_assets.mjs
  • scripts/verify_xhs_media_manifest.mjs
  • scripts/build_xhs_media_manifest.mjs
  • scripts/download_xhs_media_assets.mjs
  • scripts/verify_xhs_media_manifest.mjs

Minimal workflow

最简工作流

bash
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
bash
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

Good output

合格输出

Return:
  • manifest path
  • downloaded file count
  • failed asset count
  • stable local file paths for downstream use
返回：
  • 清单文件路径
  • 已下载文件数量
  • 下载失败的资源数量
  • 供下游使用的稳定本地文件路径