linkfox-jiimore-get-niche-info-by-asin

ASIN による Jiimore ニッチ情報

このスキルでは、参照 ASIN を使って Amazon のニッチ市場データを照会・分析し、Amazon の販売者が競争の激しさ、ブランドの成熟度、価格構造、参入機会を評価できるようにします。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-info-by-asin-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリを指します。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動でまとめられます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
• レスポンス本文が 8 KB 以下の場合：ファイルへの保存後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える場合：ファイルへの保存後、stdout には要約のみを出力します（トップレベルのフィールド、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／プランの有効期限切れ／チャージが必要／チャージしてください」、または類似の意味の内容が含まれている場合。

基本概念

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

ASIN は必須です：すべてのクエリに asin を含める必要があります。このツールは、その ASIN に関連するニッチセグメントを特定し、詳細な指標とともに返します。ユーザーがすでに特定の商品（ASIN）を指定しており、その商品が競合する市場セグメントを知りたい場合に使用します。キーワードを起点とするニッチの検索とは異なります。

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

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

パラメーターガイド

必須

パラメーター	型	説明
asin	string	参照商品の ASIN です。このツールは、この ASIN に関連するニッチセグメントを特定します。

マーケットプレイスと件数

パラメーター	型	デフォルト	説明
countryCode	string	US	国コード：US、JP、DE
count	integer	10	返すニッチセグメントの数

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

商品と価格：

パラメーター	型	説明
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）
returnRateT360Min / returnRateT360Max	number	360日間の返品率（0-1）

使用例

1. ASINによる基本的なニッチ調査 米国市場でASIN B0D9NWVC6Zに関連するニッチセグメントを検索します：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "US",
  "count": 10
}

2. ASINによる競争の少ないニッチの絞り込み 上位5ブランドのクリックシェアが50%未満で、ブランド数が20を超えるASINのニッチを検索します：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "US",
  "count": 20,
  "top5BrandsClickShareMax": 0.5,
  "brandCountMin": 20
}

3. ASINによる需要とコンバージョン率の高いニッチの検索 週間検索ボリュームが10000を超え、クリックコンバージョン率が10%を超えるASINのニッチを検索します：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "US",
  "searchVolumeT7Min": 10000,
  "clickConversionRateT7Min": 0.1
}

4. ASINによる新商品機会の分析 新商品成功率が高く（20%超）、返品率が低い（5%未満）ASINのニッチを検索します：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "US",
  "launchRateT180Min": 0.2,
  "returnRateT360Max": 0.05
}

5. ASINによる日本市場のニッチ調査 日本市場でASINに関連するニッチを調査します：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "JP",
  "count": 10
}

6. ASINによる価格帯に応じたニッチ分析 平均価格が20ドルから50ドルで、広告の飽和度が低いASINのニッチを検索します：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "US",
  "avgPriceMin": 20,
  "avgPriceMax": 50,
  "sponsoredProductsPercentageMax": 0.3
}

表示ルール

1. データを明確に提示する：クエリ結果は、構造化された表で表示します。読みやすさのため、小数の比率はパーセンテージに変換します（例：0.25 → 25%）。
2. 主要指標を強調する：ニッチのタイトル、需要スコア、週間検索ボリューム、週間販売数、ブランド数、上位5ブランドのクリックシェアを、常に主要な列として表示します。
3. ニッチのタイトルを翻訳する：translationZh フィールドがあり、ユーザーが中国語を希望する場合は、元の nicheTitle と併せて表示します。
4. 結果が空の場合の処理：該当するニッチ情報がないことをレスポンスが示している場合（errcode 10000）、フィルターに一致するニッチがないことを説明し、範囲を広げるか ASIN を確認するよう提案します。
5. エラー処理：クエリに失敗した場合は、レスポンスメッセージに基づいて理由を説明し、フィルター条件の調整（範囲を広げる、ASIN／国を確認するなど）を提案します。
6. CPC の表示：CPC データがある場合は、広告費用の全体像を示すため、低・中・高の3段階すべてを表示します。
7. 主観的なアドバイスをしない：求められていないビジネス上の推奨事項を加えず、データを客観的に提示します。解釈は、ユーザーから明示的に求められた場合にのみ提供します。

重要な制限事項

• 対応マーケットプレイス：利用できるのは US、JP、DE のみです。それ以外のマーケットプレイスコードは拒否されます。
• ASIN が必須：すべてのクエリに ASIN を含める必要があります。ASIN がない場合、API は結果を返しません。
• ページネーション／ソートなし：このエンドポイントは count（デフォルトは10）で固定数のニッチを返します。page／pageSize／sort パラメーターはありません。ソートや、より深いページネーションが必要な場合は、キーワードベースのニッチスキルを使用してください。
• パーセンテージ値：すべての率／シェアのパラメーターは 0～1 の範囲で指定し、0～100 ではありません。フィルターを作成する際は、正しい値を使用してください。

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

該当するケース -- 参照 ASIN を起点としたニッチレベルの市場セグメント分析：

ユーザーの発言	シナリオ
「この ASIN はどのニッチに属していますか」	ASIN からニッチへのマッピング
「ASIN XXXXX の市場を分析してください」	ASIN を起点としたニッチ評価
「この商品が属するニッチの競争状況はどうですか」	ASIN に基づく独占度／ブランド集中度
「この ASIN の低競争ニッチを探してください」	ブルーオーシャンセグメントの絞り込み
「この ASIN のニッチにおける新商品の成功率はどのくらいですか」	新規参入の実現可能性
「この商品のニッチデータを見せてください」	ASIN に基づく一般的なニッチ探索
「この ASIN のニッチの CPC／広告費はいくらですか」	広告費用分析
「この ASIN の市場におけるブランド集中度」	ブランド優位性の評価

該当しないケース -- ASIN を起点とするニッチセグメントデータの範囲を超えるもの：

• キーワードを起点としたニッチ探索（代わりにキーワードベースのニッチスキルを使用）
• 個別 ASIN のパフォーマンスまたは販売数の推定
• 検索語句のランキング傾向（代わりに ABA データツールを使用）
• 広告キャンペーンの管理または入札額の最適化
• 商品レビューの分析またはリスティングの最適化

適用範囲の判断：特定の ASIN を念頭に置いたユーザーが「市場調査」や「商品機会」と述べ、その ASIN が競合するニッチセグメントの競争環境と需要の可能性を評価することを意図している場合、このスキルが該当します。キーワードを起点とした探索、ASIN レベルの販売数推定、包括的なビジネス戦略が必要な場合は、適切なツールを案内してください。

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

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

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

フィードバック：

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

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

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

---

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