linkfox-jiimore-get-niche-info-by-keyword

キーワードによるJiimoreのニッチ情報

このスキルでは、キーワードでAmazonのニッチ市場データを検索・分析する方法を説明します。Amazonの販売事業者が、市場セグメントの競争の激しさ、ブランドの成熟度、価格構造、参入機会を評価できるよう支援します。

呼び出し方法

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

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

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

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

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

以下の異常が発生した場合は、references/onboarding.md に従って解決方法を案内してください。

異常な状態

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• レスポンスのステータスコードが401または402
• 計算リソースまたは残高不足を示すレスポンス：メッセージに「計算リソース残高不足／課金額不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」といった文言、または同様の意味の内容が含まれている場合。

基本概念

ニッチ（サブマーケットセグメント）とは、Amazonで共通のキーワードテーマを持つ商品のグループです。このツールは、各ニッチの検索ボリューム、販売ボリューム、クリック率、ブランド数、上位ブランドの集中度、新商品の発売成功率、CPCの推定値、総合的な需要スコアなど、豊富な分析指標を返します。データはUS、JP、DEのマーケットプレイスで利用できます。

キーワードは必須です：すべてのクエリに keyword を含める必要があります。キーワードは対象のマーケットプレイスの言語で指定してください（例：USでは英語、JPでは日本語、DEではドイツ語）。ユーザーが別の言語でキーワードを指定した場合は、APIを呼び出す前にマーケットプレイスの言語に翻訳してください。

パーセンテージ項目：複数のパラメーターとレスポンスフィールドは、0～1の小数で0～100％を表します。ユーザーに表示する際は、パーセンテージに変換してください（例：0.35 → 35％）。

需要スコア：demand フィールドは、各ニッチに割り当てられる総合的な機会スコアです。値が高いほど、市場の需要ポテンシャルが高いことを示します。

パラメーターガイド

必須

パラメーター	型	説明
keyword	string	検索キーワード（最大1000文字）。対象のマーケットプレイスの言語に翻訳してください。

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

パラメーター	型	デフォルト	説明
countryCode	string	US	国コード：US、JP、DE
page	integer	1	ページ番号（1から開始）
pageSize	integer	50	1ページあたりの結果数（10～100）
sortField	string	unitsSoldT7	ソートするフィールド（下記の「ソートオプション」を参照）
sortType	string	desc	ソート順：desc または asc

フィルターパラメーター（すべて任意、最小値／最大値の範囲）

商品と価格：

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

検索と販売（7日間）：

パラメーター	型	説明
searchVolumeT7Min / searchVolumeT7Max	integer	週間検索ボリュームの範囲
unitsSoldT7Min / unitsSoldT7Max	integer	週間販売数量の範囲
clickCountT7Min / clickCountT7Max	integer	週間クリック数の範囲
clickConversionRateT7Min / clickConversionRateT7Max	number	週間クリックコンバージョン率（0-1）

ブランド指標：

パラメーター	型	説明
brandCountMin / brandCountMax	integer	ニッチ内のブランド数
top5BrandsClickShareMin / top5BrandsClickShareMax	number	上位5ブランドのクリックシェア（0-1）
avgBrandAgeMin / avgBrandAgeMax	number	ブランドの平均年数（現在）
avgBrandAgeQoqMin / avgBrandAgeQoqMax	number	ブランドの平均年数（90日間）
avgBrandAgeYoyMin / avgBrandAgeYoyMax	number	ブランドの平均年数（360日間）

セラー指標：

パラメーター	型	説明
avgSellingPartnerAgeMin / avgSellingPartnerAgeMax	number	セラーの平均年数（現在）
avgSellingPartnerAgeQoqMin / avgSellingPartnerAgeQoqMax	number	セラーの平均年数（90日間）
avgSellingPartnerAgeYoyMin / avgSellingPartnerAgeYoyMax	number	セラーの平均年数（360日間）

競争と広告：

パラメーター	型	説明
top5ProductsClickShareMin / top5ProductsClickShareMax	number	上位5商品のクリックシェア（0-1）
sponsoredProductsPercentageMin / sponsoredProductsPercentageMax	number	SP 広告の割合（0-1）
cpcMediumMin / cpcMediumMax	number	CPC 中央値の範囲

新商品と返品：

パラメーター	型	説明
launchRateT180Min / launchRateT180Max	number	180日間の新商品の成功率（0-1）
newProductRateT180	number	180日間の新商品比率の最小値（0-1）
returnRateT360Min / returnRateT360Max	number	360日間の返品率（0-1）

並べ替えオプション

値	意味
unitsSoldT7	週間販売数量
searchVolumeT7	週間検索ボリューム
demand	需要スコア
avgPrice	平均価格
maximumPrice	最高価格
minimumPrice	最低価格
productCount	商品数
searchConversionRateT7	週間検索コンバージョン率
clickConversionRateT7	週間クリックコンバージョン率
searchVolumeGrowthT7	検索ボリューム成長率
clickCountT7	週間クリック数
clickCountT90	90日間のクリック数
brandCount	ブランド数
top5BrandsClickShare	上位5ブランドのクリックシェア
top5ProductsClickShare	上位5商品のクリックシェア
newProductsLaunchedT180	180日間に発売された新商品数
successfulLaunchesT180	180日間の発売成功数
launchRateT180	180日間の発売成功率
returnRateT360	年間返品率
clickConversionRateT90	90日間のクリックコンバージョン率
searchConversionRateT90	90日間の検索コンバージョン率
searchVolumeT90	90日間の検索ボリューム
unitsSoldT90	90日間の販売数量
unitsSoldGrowthT90	90日間の売上成長率
searchVolumeGrowthT90	90日間の検索ボリューム成長率
acos	広告費売上高比率
profitRate50	オーガニック売上50％時の利益率

使用例

1. キーワードによる基本的なニッチ市場の調査 米国市場で「wireless earbuds」に関連するニッチ市場を、週間販売数の多い順に検索します：

{
  "keyword": "wireless earbuds",
  "countryCode": "US",
  "sortField": "unitsSoldT7",
  "sortType": "desc"
}

2. 競争の少ないニッチ市場の発見 上位5ブランドのクリックシェアが50％未満で、ブランド数が20を超える「yoga mat」のニッチ市場を検索します：

{
  "keyword": "yoga mat",
  "countryCode": "US",
  "top5BrandsClickShareMax": 0.5,
  "brandCountMin": 20,
  "sortField": "demand",
  "sortType": "desc"
}

3. 需要とコンバージョン率の高いニッチ市場 週間検索ボリュームが10000を超え、クリックコンバージョン率が10％を超える「phone case」のニッチ市場を検索します：

{
  "keyword": "phone case",
  "countryCode": "US",
  "searchVolumeT7Min": 10000,
  "clickConversionRateT7Min": 0.1,
  "sortField": "searchVolumeT7",
  "sortType": "desc"
}

4. 新商品機会の分析 新商品の成功率が高く（20％超）、返品率が低い（5％未満）「LED light」のニッチ市場を検索します：

{
  "keyword": "LED light",
  "countryCode": "US",
  "launchRateT180Min": 0.2,
  "returnRateT360Max": 0.05,
  "sortField": "launchRateT180",
  "sortType": "desc"
}

5. 日本市場のニッチ市場調査 日本でヘッドフォンに関連するニッチ市場を、需要スコアの高い順に調べます：

{
  "keyword": "\u30d8\u30c3\u30c9\u30db\u30f3",
  "countryCode": "JP",
  "sortField": "demand",
  "sortType": "desc"
}

6. 価格帯を指定したニッチ市場の分析 平均価格が20ドルから50ドルで、広告の飽和度が低い「backpack」のニッチ市場を検索します：

{
  "keyword": "backpack",
  "countryCode": "US",
  "avgPriceMin": 20,
  "avgPriceMax": 50,
  "sponsoredProductsPercentageMax": 0.3,
  "sortField": "unitsSoldT7",
  "sortType": "desc"
}

表示ルール

1. データを明確に提示する：検索結果は、適切に構成された表で表示します。読みやすさのため、小数比率はパーセンテージに変換します（例：0.25 → 25％）。
2. 主要指標を強調する：ニッチ市場のタイトル、需要スコア、週間検索ボリューム、週間販売数、ブランド数、上位5ブランドのクリックシェアを、必ず主要な列として表示します。
3. ニッチ市場のタイトルを翻訳する：translationZh フィールドが存在し、ユーザーが中国語を希望する場合は、元の nicheTitle と併せて表示します。
4. ページネーションの案内：total が現在のページサイズを超える場合は、総件数をユーザーに伝え、必要に応じて追加ページを取得するよう案内します。
5. エラー処理：クエリに失敗した場合は、レスポンスメッセージに基づいて理由を説明し、フィルター条件の調整（範囲を広げる、キーワードを確認するなど）を提案します。
6. CPC の表示：CPC データがある場合は、広告費用の全体像を把握できるよう、低・中・高の3段階をすべて表示します。
7. 主観的なアドバイスはしない：求められていないビジネス上の提案を加えず、データを客観的に提示します。ユーザーから明示的に求められた場合に限り、解釈を提示します。

重要な制限事項

• 対応するマーケットプレイス：利用できるのは US、JP、DE のみです。それ以外のマーケットプレイスコードは拒否されます。
• キーワードは必須：すべてのクエリにキーワードを含める必要があります。キーワードがない場合、API は結果を返しません。
• 結果の上限：1ページあたり最大100件です。
• パーセンテージ値：すべての率／シェアのパラメーターは0～1の範囲で指定します（0～100ではありません）。フィルターの構築時に正しい値を指定してください。

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

該当する -- キーワード単位のニッチ市場セグメント分析：

ユーザーの発言	シナリオ
「XX市場にチャンスはありますか」	ニッチ市場の機会評価
「XXキーワードの競争はどの程度ですか」	独占／ブランド集中度
「XXの競争が少ないニッチ市場を探して」	ブルーオーシャンのニッチ市場発見
「XXの新商品の成功率はどのくらいですか」	新規参入者の実現可能性
「XXのニッチ市場データを見せて」	一般的なニッチ市場の調査
「XXで需要の高いニッチ市場はどれですか」	需要重視のニッチ市場ランキング
「XXのニッチ市場の CPC／広告費用はいくらですか」	広告費用の分析
「XXでコンバージョン率の高いニッチ市場を探して」	コンバージョン最適化セグメント
「XX市場のブランド集中度」	ブランドの支配度評価

該当しない -- ニッチ市場セグメントのデータを超える要件：

• 個別の ASIN の実績または売上推定
• 検索語句のランキング動向（代わりに ABA データツールを使用）
• 広告キャンペーン管理または入札単価の最適化
• 商品レビュー分析または商品リスティングの最適化
• サプライヤーの調達または物流計画

適用範囲の判断：ユーザーが「市場調査」や「商品機会」と言っていても、キーワード単位の市場セグメントについて競争環境と需要の可能性を評価することが目的であれば、このスキルが適用されます。ASIN 単位のデータ、検索語句のランキング動向、または包括的なビジネス戦略が必要な場合は、適切なツールを案内してください。

コンピューティングリソースの消費ルール

コンピューティングリソースを 9 消費します。

ユーザーはコンピューティングリソースの消費に応じて料金を支払います。十分にご検討ください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが消費量を十分に把握していない場合は、必ずユーザーに通知し、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

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

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

references/api.md に記載された方法で Feedback API を呼び出してください。ユーザーの作業を中断しないでください。

---

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