xiaohongshu-search-summarizer

Xiaohongshu の検索と要約

このスキルは、Xiaohongshu（小红书）から高品質なマルチモーダルコンテンツ（テキスト＋画像）を抽出するプロセスを自動化し、ユーザー向けに深く統合された分析的な最終レポートを作成する作業を積極的に支援します。Xiaohongshu はスクレイピング対策が厳しいため、直接 HTTP リクエストを送信したり、単純なスクレイピングを行ったりすると、404 エラーやブロックが発生することがよくあります。このスキルでは、画面表示モードのブラウザーウィンドウで playwright-cli を使って実際のユーザーを模倣し、こうした対策をネイティブに回避します。

処理は、次の 2 つのフェーズで行われます。

フェーズ 1：サブエージェントによるデータ収集

1. 画面表示モードのブラウザーで Xiaohongshu のキーワード検索をシミュレートします。
2. 画像スライダーを進め、上位 N 件の投稿に含まれる遅延読み込み画像をすべて読み込みます。
3. タイトル、説明、トップコメント、高解像度画像をすべて抽出します。
4. 画像をローカルディレクトリにダウンロードし、生データ文書（[keyword]_raw_data.md）を生成します。

フェーズ 2：AI によるマルチモーダル統合（あなたの作業）

5. あなたはファイル読み取り機能を使って、[keyword]_raw_data.md ファイルを必ず読み込んでください。
6. 生データの Markdown には画像ファイルへのパスが記載されています。必ずファイル読み取り機能または画像認識機能を使い、これらの画像ファイルのパスから実際に画像を取り込んで「見て」ください。この手順を省略すると、画像そのものではなくファイル名しか読んでいないことになります。
7. あなたはテキストを分析し、本当に役立つコメントを要約し（「DM してください」のようなノイズは除外）、実際に確認した画像の意味内容（図、ガイドライン、段階的な UI 操作の流れなど）を解釈します。
8. あなたは投稿を単に時系列で並べるのではなく、すべての内容を統合した、読みやすい包括的なレポートを作成します。

依存関係

• playwright-cli（パス上で利用できること）
• python3（画像のダウンロードと生データ Markdown の結合に必要）
• Python パッケージ requests（pip install requests） — parse.py が画像をダウンロードするために使用

---

使用方法

ステップ 1：抽出スクリプトを実行する

scripts/run.sh のラッパースクリプトを実行します。次の引数を指定できます。

/bin/bash <skill_dir>/scripts/run.sh "YOUR KEYWORD" <MAX_POSTS> <OUTPUT_DIRECTORY>

• YOUR KEYWORD：Xiaohongshu で検索するキーワードです。
• <MAX_POSTS>：（省略可能、デフォルト = 10）スキャンする上位投稿の件数です。
• <OUTPUT_DIRECTORY>：（省略可能、デフォルト = ./）生データと画像の保存先ディレクトリです。

実行例：

/bin/bash ~/.claude/skills/xiaohongshu-search-summarizer/scripts/run.sh "openclaw使用场景" 10 "./xhs_report_openclaw_scenarios"

ステップ 2：生データと画像を読み込む

bash スクリプトが正常に完了したら、OUTPUT_DIRECTORY に移動し、ファイル読み取り機能を使って生成された [keyword]_raw_data.md ファイルを取り込んでください。

このファイルには、説明、コメント、post_X_img_Y.webp または post_X_img_Y.jpg を指すファイルパスが記載されています。

ステップ 3：統合と要約

これは最も重要なステップです。 生の Markdown ファイルをそのままユーザーに返さないでください。代わりに、情報を論理的に再構成し、詳細さを十分に保った、洗練された包括的な Markdown レポートを作成してください。

以下の厳格な編集ルールに従ってください。

• 投稿を個別に列挙しないでください（例：「投稿 1：… 投稿 2：…」のような形式は避けてください）。
• 画像を確認する： 生データディレクトリ内にある .webp または .jpg 画像ファイルを、ファイル読み取り機能と画像認識機能を使って必ず確認し、内容を解釈してください。
• 詳細かつ包括的に統合する： 複数の投稿に見られる多様な視点、ニュアンス、具体例を含めた、詳細な要約を作成してください。過度な要約や重要な文脈の欠落を避け、情報の豊かさと多様性を保ってください。
• テーマを抽出して統合する： 考え方を、概念、手順、繰り返し現れるテーマ、長所と短所などに基づいてグループ化してください。
• コメントを評価する： 有益なコメントから得られた洞察を、本文の説明に直接統合してください。役に立たないコメントや繰り返しのコメントは省きつつ、コメント欄にある多様な意見や役立つ反論は残してください。
• 画像を文脈に沿って組み込む： 特に関連性が高く品質のよい画像を最終レポートの本文に組み込み、分析の根拠として活用してください。実際に画像を確認して把握した内容に基づき、その視覚的な意味を説明してください。
• OUTPUT_DIRECTORY に保存する： ファイル書き込み機能を使って、作成した完成度の高い Markdown レポートを、生データと同じ <OUTPUT_DIRECTORY>（例：<OUTPUT_DIRECTORY>/[keyword]_synthesis.md）に直接保存し、保存先のパスをユーザーに伝えてください。

エラー処理

ブラウザーの操作中に 404 Not Found または「element not visible」エラーが発生した場合：

• Xiaohongshu ではログイン確認が求められることがあります。サイトがログイン待ちの状態になった場合は、ユーザーに playwright-cli のブラウザーウィンドウを確認し、必要な認証を手動で行ってから、スクリプトを再度実行するよう案内してください。