linkfox-jiimore-get-niche-review-from-keyword

キーワードから Jiimore のニッチ市場レビューを取得

このスキルでは、Jiimore が提供する Amazon のニッチ市場レビューのデータを取得・分析する方法を説明します。Amazon の出品者が、ニッチ市場の商品のレビューから消費者の感情、悩み、実際の需要を示すシグナルを把握できるよう支援します。

主な概念

ニッチ市場レビュー分析では、Amazon のニッチ市場にある複数の商品について、顧客レビューを集約して分類します。キーワードを指定すると、システムは関連するニッチ市場を特定し、レビューのトピックを抽出して肯定的または否定的に分類し、各トピックが言及された頻度を示します。これにより、顧客が気に入っている点、不満に感じている点、商品の改善機会がある箇所を把握できます。

レビューの種類：各レビュー項目は、そのレビューのトピック全体の感情を反映して、「positive」または「negative」に分類されます。

言及率：percentOfMentions の値（0～1 のスケールで、0～100％を表します）は、ニッチ市場の全レビューのうち、特定のトピックがどの程度の頻度で登場するかを示します。割合が高いほど、そのトピックについて言及する顧客が多いことを意味します。

対応マーケットプレイス

US（米国）、JP（日本）、DE（ドイツ）

デフォルトのマーケットプレイスは US です。ユーザーがマーケットプレイスを指定しない場合は、US を使用してください。

呼び出し方法

• API エンドポイント：POST /jiimore/getNicheReviewFromKeyword（完全なパラメーター／レスポンス／エラーコードについては references/api.md を参照）
• Python スクリプト：python scripts/jiimore_get_niche_review.py '<JSON パラメーター>' [--inline]
• コスト制約：このツールは計算リソースを消費します。同一セッションでは、同一のパラメーターの組み合わせに対する呼び出しはデフォルトで 1 回のみとし、スクリプトは 24 時間のローカルキャッシュを使用します。失敗または結果が空の場合、キーワードの変更、ページ移動、郵便番号の変更を自動で繰り返してはいけません。検索を続ける必要がある場合は、追加のコストが発生することを先にユーザーに説明してください。

出力方法（スクリプトのデフォルトの動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-review-from-keyword-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリにあたります。<session> は環境変数 SESSION_ID から取得され、ユーザーのタスクごとに自動集約されます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
• レスポンス本文が 8 KB 以下の場合：ファイルに保存した後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える場合：ファイルに保存した後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken などの一般的なカウント、最大のリストフィールドの長さと先頭 3 件のサンプル）
• --inline を指定すると、完全なデータを stdout に強制出力します（同様にファイルにも保存されます）

データの読み取りに関する推奨事項：まず要約を確認し、必要な情報が得られるか判断してください。具体的なフィールドが必要な場合は、保存した JSON ファイルから jq または ConvertFrom-Json を使って必要なデータを抽出し、JSON 全体がコンテキストに取り込まれるのを避けてください。

認証と計算リソースの問題の解決

以下の異常が発生した場合は、references/onboarding.md に記載されている手順に従って問題を解決してください。

異常な状況

• API Key が未設定：環境変数に LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高が不足している旨のレスポンス：メッセージに「算力余额不足／计费不足／余额不足／quota exceeded／insufficient balance／套餐到期／需充值／请充值」または同様の意味の内容が含まれている場合。

パラメーターガイド

必須パラメーター

パラメーター	型	説明
keyword	string	検索キーワード（最大 1000 文字）。対象のマーケットプレイスの言語で入力してください（US は英語、DE はドイツ語、JP は日本語）

マーケットプレイスとページネーション

パラメーター	型	デフォルト	説明
countryCode	string	US	国コード：US、JP、または DE
page	integer	1	ページ番号（1 から開始）
pageSize	integer	50	1 ページあたりの結果数（10～100）

並べ替え

パラメーター	型	デフォルト	説明
sortField	string	unitsSoldT7	並べ替えの基準にするフィールド（下記の並べ替え可能なフィールドを参照）
sortType	string	desc	並べ替え順：desc（降順）または asc（昇順）

並べ替え可能なフィールド：

フィールド	説明
unitsSoldT7	販売数（7日間）
searchVolumeT7	検索ボリューム（7日間）
searchVolumeGrowthT7	検索ボリュームの増加率（7日間）
clickConversionRateT7	クリックコンバージョン率（7日間）
searchConversionRateT7	検索コンバージョン率（7日間）
clickCountT7	クリック数（7日間）
demand	需要スコア
avgPrice	平均価格
maximumPrice	最高価格
minimumPrice	最低価格
productCount	商品数
brandCount	ブランド数
top5BrandsClickShare	上位5ブランドのクリックシェア
top5ProductsClickShare	上位5商品のクリックシェア
clickCountT90	クリック数（90日間）
clickConversionRateT90	クリックコンバージョン率（90日間）
searchConversionRateT90	検索コンバージョン率（90日間）
searchVolumeT90	検索ボリューム（90日間）
unitsSoldT90	販売数（90日間）
unitsSoldGrowthT90	販売数の増加率（90日間）
searchVolumeGrowthT90	検索ボリュームの増加率（90日間）
returnRateT360	返品率（360日間）
newProductsLaunchedT180	新製品の発売数（180日間）
successfulLaunchesT180	成功した製品発売数（180日間）
launchRateT180	製品発売成功率（180日間）
acos	ACOS
profitRate50	オーガニック注文率50％での利益率

ニッチのフィルターパラメーター

すべてのフィルターパラメーターは、最小値／最大値の範囲パターンに従います。割合に基づくフィールドの値は、0〜1 のスケールを使用します（例：0.05 = 5％）。

商品・ブランド指標：

パラメーター	型	説明
productCountMin / productCountMax	integer	商品数の範囲
brandCountMin / brandCountMax	integer	ブランド数の範囲
avgPriceMin / avgPriceMax	number	平均価格の範囲

販売数・検索ボリューム：

パラメーター	型	説明
unitsSoldT7Min / unitsSoldT7Max	integer	販売数（7日間）の範囲
searchVolumeT7Min / searchVolumeT7Max	integer	検索ボリューム（7日間）の範囲
clickCountT7Min / clickCountT7Max	integer	クリック数（7日間）の範囲

コンバージョン率・クリック率（0〜1 スケール）：

パラメーター	型	説明
clickConversionRateT7Min / clickConversionRateT7Max	number	クリックコンバージョン率（7日間）の範囲

市場の集中度（0〜1 スケール）：

パラメーター	型	説明
top5BrandsClickShareMin / top5BrandsClickShareMax	number	上位5ブランドのクリックシェアの範囲
top5ProductsClickShareMin / top5ProductsClickShareMax	number	上位5商品のクリックシェアの範囲
sponsoredProductsPercentageMin / sponsoredProductsPercentageMax	number	SP 広告の割合の範囲

ブランド・販売者の年数：

パラメーター	型	説明
avgBrandAgeMin / avgBrandAgeMax	number	ブランドの平均年数（現在）の範囲
avgBrandAgeQoqMin / avgBrandAgeQoqMax	number	ブランドの平均年数（90日間）の範囲
avgBrandAgeYoyMin / avgBrandAgeYoyMax	number	ブランドの平均年数（360日間）の範囲
avgSellingPartnerAgeMin / avgSellingPartnerAgeMax	number	販売者の平均年数（現在）の範囲
avgSellingPartnerAgeQoqMin / avgSellingPartnerAgeQoqMax	number	販売者の平均年数（90日間）の範囲
avgSellingPartnerAgeYoyMin / avgSellingPartnerAgeYoyMax	number	販売者の平均年数（360日間）の範囲

新商品・返品指標（0〜1 スケール）：

パラメーター	型	説明
launchRateT180Min / launchRateT180Max	number	発売成功率（180日間）の範囲
newProductRateT180	number	新商品の割合（180日間）の最小値
returnRateT360Min / returnRateT360Max	number	返品率（360日間）の範囲

広告：

パラメーター	型	説明
cpcMediumMin / cpcMediumMax	number	CPC（現在）の範囲

使用例

1. キーワードの基本的なニッチレビュー検索

Analyze customer reviews in niche markets related to "yoga mat" on the US marketplace.

パラメーター：{"keyword": "yoga mat", "countryCode": "US"}

2. 検索ボリュームの多いニッチレビューを検索

Show me niche market reviews for "wireless earbuds" where 7-day search volume is above 10000.

パラメーター：{"keyword": "wireless earbuds", "countryCode": "US", "searchVolumeT7Min": 10000}

3. レビューのインサイトを参考に、競争率の低いニッチを検索

Find review insights for "pet bed" niches where top 5 brands hold less than 30% click share.

パラメーター：{"keyword": "pet bed", "countryCode": "US", "top5BrandsClickShareMax": 0.3}

4. 日本市場のニッチレビュー

Analyze niche reviews for wireless earbuds on the Japan marketplace.

パラメーター：{"keyword": "wireless earbuds", "countryCode": "JP"}

5. 需要スコアで並べ替え

Show niche reviews for "kitchen organizer" sorted by demand score in descending order.

パラメーター：{"keyword": "kitchen organizer", "sortField": "demand", "sortType": "desc"}

6. 新商品の成功率でフィルター

Find niches for "phone case" where the 180-day new product launch success rate is above 20%.

パラメーター：{"keyword": "phone case", "launchRateT180Min": 0.2}

7. 返品率の低いニッチ

Show review topics for "water bottle" niches with return rates below 5%.

パラメーター：{"keyword": "water bottle", "returnRateT360Max": 0.05}

表示ルール

1. データを明確に提示する：レビューのトピックを整理された表で示します。ニッチ名、レビューの種類（ポジティブ／ネガティブ）、トピック、言及率、レビュー例を含めます
2. パーセンテージの書式：表示時に0～1の値をパーセンテージに変換します（例：0.15 → 15%）
3. センチメントの分離：結果を提示する際は、ユーザーが機会と課題をすぐに把握できるよう、ポジティブレビューとネガティブレビューをグループ化するか、明確にラベル付けします
4. 実行可能なインサイトとして提示する：データを客観的に示しながら、言及率の高いネガティブレビューは製品改善の機会として、言及率の高いポジティブレビューは商品リストで強調する特長として取り上げます
5. 件数に関する注意：結果が多い場合は、関連性の高いデータを先に表示し、ページネーションを利用できることをユーザーに伝えます
6. エラー処理：クエリが失敗した場合は、その理由を説明し、キーワードまたはフィルター条件を調整するよう提案します
7. 言語に関する注意：ユーザーが対象マーケットプレイスに適さない言語でキーワードを入力した場合は、マーケットプレイスの現地語を使用するよう伝えます（米国は英語、DEはドイツ語、JPは日本語）

ユーザーの表現とシナリオのクイックリファレンス

該当する -- Amazonのニッチ市場における消費者レビューとセンチメント分析：

ユーザーの発言	シナリオ
「XXについて顧客は何と言っていますか」	ニッチのレビュートピック検索
「XXに対する顧客の不満点」	ネガティブレビュー分析
「XXのどんな特長を購入者は気に入っていますか」	ポジティブレビュー分析
「XXニッチのレビューセンチメント」	センチメントの全体分析
「XXの消費者需要に関するインサイト」	レビューから需要シグナルを抽出
「XX製品に関するよくある苦情」	ネガティブトピックの抽出
「XX製品の人気の理由」	ポジティブトピックの抽出
「ニッチ市場のレビュー分析」	ニッチ全般のレビュー調査

該当しない -- ニッチのレビュー分析を超えるニーズ：

• 個別ASINのレビュー分析（このツールはニッチ／市場レベルで機能します）
• レビューの文脈を伴わないキーワード検索ボリュームの推移（代わりにABAデータツールを使用）
• 商品リストの最適化やコピーライティング
• 広告戦略やPPC管理
• 売上推定や収益予測

境界の判断：ユーザーが「市場調査」や「商品機会」と言う場合でも、その意図がニッチ市場における消費者センチメント、レビュートピック、不満点の把握にあるなら、このスキルが該当します。レビューの文脈を伴わずに検索ボリュームの推移、価格戦略、売上データについて尋ねている場合は該当しません。

算力消耗规则

9算力を消耗します。

ユーザーは算力の消耗に対して料金を支払います。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合や、ユーザーが算力の消耗量を十分に把握していない場合は、必ずユーザーに伝え、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

次のいずれかに該当する場合は、Feedback APIを使ってフィードバックを自動検出し、報告してください。

1. このスキルで説明されている機能や目的が、実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルへの不満または称賛を表明する
4. 改善できると思われることがある

references/api.mdで指定されているとおりにFeedback APIを呼び出してください。ユーザーの作業を中断しないでください。

---

より高品質でプロフェッショナルな越境ECスキルについては、LinkFox Skillsを設定してください。