mcpField
X
xiaohongshu-media-collector

xiaohongshu-media-collector

github.com/postplusaiデータ・データベース27138 回インストール1 日前に更新
リポジトリ

xiaohongshu-media-collector について

正規化された小紅書データセットを基にローカルマニフェストを作成し、参照されたカバー画像をダウンロードするスキルです。検証済みのカバー画像URLのみを扱い、動画や任意の投稿画像の取得には対応しません。

主な機能

  1. 01正規化データセットからマニフェストを作成
  2. 02検証済みカバー画像のダウンロード
  3. 03ダウンロードファイルの検証
  4. 04非対応の動画要求を拒否
  5. 05マニフェストで素材を管理

活用シーン

  1. 01小紅書カード作成用のカバー素材を準備
  2. 02後続レビュー用にカバーを収集
  3. 03ダウンロードしたカバー画像を検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/postplusai/postplus-skills --skill xiaohongshu-media-collector

インストール後、Claude Code で/xiaohongshu-media-collectorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

_postplus_shared/scripts/lib/
campaign-report-manifest.mjs
references/
manifest-schema.md
validated-surfaces.md
scripts/
build_xhs_media_manifest.mjs
download_xhs_media_assets.mjs
verify_xhs_media_manifest.mjs
scripts/lib/
media_common.mjs

詳細

XHS Media Collector

次の共有パブリックスキルルールに従ってください：

  • postplus-shared パブリックスキルルール

レガシーエイリアス：xhs-media-collector。

このスキルは、ユーザーが次のことを望む場合に使用します：

  • 検証済みデータセットから Xiaohongshu のカバー画像をダウンロードする
  • 正規化された XHS リサーチ出力をローカルメディアマニフェストに変換する
  • XHS カードの合成や後続のレビュー用にローカルのカバー画像アセットを準備する

実装前に次のリファレンスを読んでください：

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

デフォルトの姿勢

検証済みの上流データセットによってすでに公開されているアセット URL のみを収集します。

デフォルトでサポート：

  • 正規化された XHS 投稿データセットからの coverUrl

デフォルトでサポートしない：

  • ノートページからのカバー以外の画像抽出
  • Xiaohongshu 動画ダウンローダーの直接出力

検証済みダウンローダーが 404 Not found data を返す場合、動画収集が機能すると偽ってはいけません。 メディアリクエストを受け入れる前に、リリースされたパスが上流データセットからの 検証済みカバー画像のみをサポートすることをユーザーに伝えてください。Xiaohongshu 動画のダウンロードは サポートしていません。サポートされているパスはカバー画像の収集であり、Xiaohongshu 動画の直接ダウンロードではありません。

このスキルの用途

  • 正規化された XHS データセットからローカルマニフェストを構築する
  • 正規化データにすでに存在するリモート URL からカバー画像をダウンロードする
  • ダウンロードされたファイルが存在し、空でないことを検証する

このスキルの対象外

  • ノート URL の discovery
  • 投稿メタデータの抽出
  • 任意のノート画像の抽出
  • デフォルトでのノート URL からの動画ダウンロード

失敗時の姿勢

  • 入力データセットにダウンロード可能な coverUrl 画像 URL が含まれていない場合は失敗する
  • 要求されたアセットタイプが video の場合は失敗する
  • 要求されたアセットロールが cover でない場合は失敗する
  • ダウンロードが非 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

良い出力

次を返します：

  • マニフェストパス
  • ダウンロードされたファイル数
  • 失敗したアセット数
  • 後続で使用するための安定したローカルファイルパス

コメント

Markdown 対応