XHS Media Collector

• postplus-shared

  release-shell rules

xhs-media-collector

• 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

• skills/20-research/xhs-media-collector/references/validated-surfaces.md

• skills/20-research/xhs-media-collector/references/manifest-schema.md

Default posture

• coverUrl

  from normalized XHS post datasets

• direct Xiaohongshu video downloader output

404 Not found data

What this skill is for

• 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

What this skill is not for

• discovering note URLs
• extracting post metadata
• downloading videos from note URLs by default

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

Release-Shell Execution Contract

• 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

Main scripts

• scripts/build_xhs_media_manifest.mjs

• scripts/download_xhs_media_assets.mjs

• scripts/verify_xhs_media_manifest.mjs

Minimal workflow

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

• manifest path
• downloaded file count
• failed asset count
• stable local file paths for downstream use