mcpField
X
xiaohongshu-tools

xiaohongshu-tools

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

xiaohongshu-tools について

小紅書スキル群のローカルデータ処理スクリプトを実行するためのサポートスキルです。指定された収集キーを使い、データの正規化、アカウント・投稿・商品のランキング、コメントのクラスタリング、トピックマップや事業者レポートの作成を扱います。

主な機能

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

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

同梱ファイル

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

_postplus_shared/00-core/shared-collection/scripts/
collection_actor_run.mjs
_postplus_shared/00-core/shared-collection/scripts/lib/
hosted_collection_bridge.mjs
_postplus_shared/00-core/shared-runtime/scripts/
download_videos_from_manifest_with_ytdlp.mjs
_postplus_shared/00-core/shared-runtime/scripts/lib/
execution_approval.mjs
hosted_billing_summary.mjs
hosted_execution_protocol.mjs
hosted_media_generation_bridge.mjs
local_skill_cli.mjs
network_runtime.mjs
postplus_cli_config.mjs
postplus_cloud_client.mjs
skill_runtime.mjs
scripts/
build_xhs_merchant_report.mjs
build_xhs_topic_map.mjs
cluster_xhs_comments.mjs
extract_xhs_vendor_page_products.mjs
normalize_xhs_dataset.mjs
rank_xhs_accounts.mjs
rank_xhs_posts.mjs
rank_xhs_products.mjs
run_xhs_actor.mjs
scripts/lib/
xhs_common.mjs

詳細

Xiaohongshu ツール

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

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

このスキルは、Xiaohongshu スキルファミリーのローカル実行レイヤーを実装または実行するときに使用します。

主要スクリプト：

  • scripts/run_xhs_actor.mjs
  • scripts/normalize_xhs_dataset.mjs
  • scripts/extract_xhs_vendor_page_products.mjs
  • scripts/rank_xhs_accounts.mjs
  • scripts/rank_xhs_posts.mjs
  • scripts/cluster_xhs_comments.mjs
  • scripts/rank_xhs_products.mjs
  • scripts/build_xhs_topic_map.mjs
  • scripts/build_xhs_merchant_report.mjs

共有ヘルパー：

  • scripts/lib/xhs_common.mjs

参照コントラクト：

  • ../xiaohongshu-references/tool-contracts.md
  • ../xiaohongshu-references/normalized-schema.md

実行ルール

スキーマが本当に必要としない限り、actor 固有のダウンストリームワークフローを勝手に考案しないでください。

優先するもの：

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

このスキルは、生データが収集された後の安定したローカルコントラクトに集中し続けるべきです。

サポートされるコレクションキー

このサポートスキルは、次の PostPlus パブリックコレクションキーのみを実行できます：

  • xhs-account-posts
  • xhs-search

最小限のランナー例：

node ${CLAUDE_SKILL_DIR}/scripts/run_xhs_actor.mjs \
  --collection-key xhs-account-posts \
  --input <work-folder>/.postplus/xiaohongshu-tools/xhs-account-posts-input.json \
  --output <work-folder>/.postplus/xiaohongshu-tools/xhs-account-posts-raw.json

node ${CLAUDE_SKILL_DIR}/scripts/run_xhs_actor.mjs \
  --collection-key xhs-search \
  --input <work-folder>/.postplus/xiaohongshu-tools/xhs-search-input.json \
  --output <work-folder>/.postplus/xiaohongshu-tools/xhs-search-raw.json

プロバイダー固有のコレクション名や未公開のキーを渡さないでください。

パブリックスキル実行コントラクト

  • actor の入力、生データセット、正規化データセット、ランキング出力、 クラスタリングされたコメント、商品ランキング、トピックマップを <work-folder>/.postplus/xiaohongshu-tools/ の下に保持してください
  • 最終的なユーザー向けのショートリストまたはレポートのみを .postplus/ の外に保持してください
  • 広範な収集の前に、まず範囲を限定した最初のパスから始めてください
  • PostPlus Cloud サービスが利用不可、未認可、または安定した ネットワークエラーを返す場合は、その場しのぎのシェルグルーに切り替えるのではなく、直ちに停止してください

コメント

Markdown 対応