xiaohongshu-content-benchmark

XHS コンテンツベンチマーク

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

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

レガシーエイリアス: xhs-content-benchmark。

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

• Xiaohongshu 上の競合アカウントやインスピレーションアカウントをベンチマークする
• Xiaohongshu で繰り返し使われているタイトルのフックやカバーのパターンを特定する
• ローカルの XHS カードに適応させる前に、有力なノート例を絞り込む
• 1 つ以上の既知の Xiaohongshu プロフィールの最近の投稿成果を比較する

実装の前に以下のリファレンスを読んでください:

• skills/20-research/xhs-content-benchmark/references/actor-selection.md
• skills/20-research/xhs-content-benchmark/references/brief-schema.md
• skills/20-research/xhs-content-benchmark/references/normalized-schema.md

デフォルトの姿勢

広範なキーワード検索ではなく、アカウントベースのベンチマークから始めてください。

デフォルトの開始サーフェス:

• 既知のプロフィール URL -> 最近の投稿ベンチマークプール

以下をデフォルトの最初のサーフェスとして使用しないでください:

• キーワードまたはトピック検索を最初の収集サーフェスとすること

サーフェス間を黙って切り替えないでください。 ユーザーがキーワード検索を求めた場合は、キーワード検索ルートを明示的に使用し、アイテムが返されなければ目に見える形で失敗させてください。

検証済みのアクターパス

このスキルのデフォルトアクター:

• rednote-xiaohongshu-user-posts-scraper

ユーザーが以下を提供した場合に使用します:

• 1 つ以上の Xiaohongshu の profileUrls
• 1 つ以上の Xiaohongshu の profileIds

これが現在のデフォルトである理由は、このベンチマークフローに必要な投稿レベルのフィールドを返すからです:

• ノート URL
• ノート ID
• タイトル
• 投稿タイプ
• いいね数
• 投稿者メタデータ
• カバー画像メタデータ

実験的ルート

キーワードルート:

• rednote-xiaohongshu-search-scraper

ユーザーがキーワードまたはトピックのベンチマークを明示的に希望する場合にのみ使用してください。

現在の運用ルール:

• maxItems >= 100 を必須とする
• アクターがゼロ件のアイテムを返した場合は失敗とする

アクターが空のデータセットを返したときに、キーワードベンチマークが成功したかのように装わないでください。

このスキルの対象外

• コメントのマイニング
• オーディエンスの言語抽出
• メディアのダウンロード
• プロフィールのヘルススナップショット
• ノートの公開またはスケジューリング

これらは後で専用の XHS スキルにルーティングしてください。

推奨ワークフロー

1. リクエストを分類する:
   • アカウントベンチマーク
   • キーワードベンチマーク
2. 小さなベンチマークブリーフをアクター入力にコンパイルする
3. 共有コレクションランナーを通じて選択したアクターを実行する
4. 1 つのローカル投稿データセットに正規化する
5. いいねシグナルとテーマ関連性でランク付けする
6. 要約する:
   • 繰り返し使われるフック
   • タイトルパターンの系統
   • カバーのアスペクトパターン
   • コンテンツタイプの内訳
   • 最も有力なベンチマーク例

コスト管理

検証済みのアカウントルート:

• プロフィールごとに最近の投稿 8〜15 件から始める
• 一度に 1〜3 プロフィールをベンチマークする

実験的キーワードルート:

• 現在、このアクターははるかに高い最小アイテム数を強制している
• その制約を隠さないこと
• キーワードバッチは狭く具体的に保つこと

パブリックスキル実行契約

• ベンチマークブリーフ、アクター入力、生データセット、正規化データセット、 ランキング、分析出力は <work-folder>/.postplus/xiaohongshu-content-benchmark/ の下に保持する
• 最終的なユーザー向けベンチマーク要約またはショートリストのみを .postplus/ の外に保持する
• 範囲を限定した最初のパスから始める:
  • 検証済みのアカウントルートでは 1-3 プロフィール
  • ユーザーが明示的に検索を要求した場合にのみ、狭いキーワードバッチ
• PostPlus Cloud サービスが利用不可、未認可、または安定したネットワーク エラーを返す場合は、その場で停止し、アドホックなシェルグルーに切り替えないこと

メインスクリプト

• scripts/build_xhs_benchmark_actor_input.mjs
• scripts/normalize_xhs_benchmark_dataset.mjs
• scripts/rank_xhs_benchmark_posts.mjs
• scripts/analyze_xhs_benchmark_dataset.mjs

アクター呼び出しには共有コレクションランナーを使用してください:

• ${CLAUDE_SKILL_DIR}/_postplus_shared/00-core/shared-collection/scripts/collection_actor_run.mjs

最小ワークフロー

アカウントベンチマーク

ブリーフからアクター入力を作成する:

node ${CLAUDE_SKILL_DIR}/scripts/build_xhs_benchmark_actor_input.mjs \
  --brief <work-folder>/.postplus/xhs-benchmark-brief.json \
  --output <work-folder>/.postplus/xhs-benchmark-actor-input.json

検証済みのアクターを実行する:

node ${CLAUDE_SKILL_DIR}/_postplus_shared/00-core/shared-collection/scripts/collection_actor_run.mjs \
  --collection-key xhs-account-posts \
  --input <work-folder>/.postplus/xhs-benchmark-actor-input.json \
  --output <work-folder>/.postplus/xhs-benchmark-raw.json

正規化、ランク付け、分析:

node ${CLAUDE_SKILL_DIR}/scripts/normalize_xhs_benchmark_dataset.mjs \
  --input <work-folder>/.postplus/xhs-benchmark-raw.json \
  --output <work-folder>/.postplus/xhs-benchmark-normalized.json

node ${CLAUDE_SKILL_DIR}/scripts/rank_xhs_benchmark_posts.mjs \
  --input <work-folder>/.postplus/xhs-benchmark-normalized.json \
  --theme "workplace,office workers,office" \
  --output <work-folder>/.postplus/xhs-benchmark-ranking.json

node ${CLAUDE_SKILL_DIR}/scripts/analyze_xhs_benchmark_dataset.mjs \
  --input <work-folder>/.postplus/xhs-benchmark-normalized.json \
  --output <work-folder>/.postplus/xhs-benchmark-analysis.json

キーワードベンチマーク

同じビルドスクリプトを使用しますが、ブリーフに keywords を指定します。

運用上の制約:

• limit >= 100 を維持してください
• アクターがゼロ件のアイテムを返した場合は、目に見える形で失敗することを想定してください

良好な出力

次を返します:

• ベンチマークのショートリスト
• 上位のノート URL
• 繰り返し現れるタイトルのフック
• タイトルパターンの内訳
• カバー形状の内訳
• 観測されたコンテンツタイプの内訳
• フィールドが欠落している場合のデータ品質に関する警告
• 後で skills/40-creative/xiaohongshu-card-notes に渡せる、提案されたカードの切り口

失敗時の姿勢

• リクエストがプロファイルベンチマークとキーワードベンチマークを混在させており、どちらを主とするかを明示していない場合は失敗とします
• profileUrls、profileIds、keywords のいずれも指定されていない場合は失敗とします
• 失敗のメッセージには、不足している入力を明記してください: Xiaohongshu のプロファイル URL、プロファイル ID、または明示的なキーワードルートのいずれかです
• キーワード検索アクターがゼロ件のアイテムを返した場合は失敗とします
• 正規化されたデータセットにノート URL が存在しない場合は失敗とします
• デバッグ用にアクターの生の出力を保持してください