linkfox-amazon-opportunity-search-by-metrics

指標によるAmazonの販売機会スクリーナー

このスキルでは、過去の販売機会レポートから集約した指標プールを使って、Amazonのニッチ市場やキーワードを逆引きする方法を説明します。競争が少ない、需要が伸びている、ブルーオーシャンである、顧客の悩みに応える機会がある、といった漠然とした選定アイデアを、具体的なニッチ市場の候補に落とし込めます。

主な概念

このツールは、過去のAmazon販売機会レポートから抽出した、ニッチ市場単位の指標（1レコードあたり約37項目）を検索可能なプールとして公開します。新しいレポートを生成する（フォワード分析）のではなく、30以上のビジネス指標で既存のプールを逆引き検索し、条件に一致する(marketplace, keyword)レコードを、収集日時の新しい順に返します。

レコードの単位はASINではなく、ニッチ市場／キーワードです。各レコードはニッチ市場のスナップショットであり、市場規模、成長率、競争状況、価格帯、人口統計、主な特徴、レビューのテーマが含まれます。

フォワード分析と逆引き分析：ユーザーがキーワードを指定し、包括的なAIレポートを求めている場合はlinkfox-amazon-opportunity-reportを使用します。ユーザーがビジネス条件（フィルター）を指定し、それに合うキーワードやニッチ市場を見つけたい場合は、このスキルを使用します。

フィルターの項目

フィルターは6つのビジネス指標に分類されています。すべてのフィルターパラメーターは任意ですが、keyword／nicheNameのいずれか、または任意の指標フィルターを少なくとも1つ指定する必要があります。すべて空の呼び出しは拒否されます。

指標	パラメーターの例	典型的なユーザーの意図
市場規模と成長	nicheRevenue360dMinUsdAtLeastGte、nichePeakSearchVolumeAtLeastGte、nicheSearchVolumeYoyChangePctAtLeastGte、nichePeakMonthGte/Lte	「十分な市場規模」「急成長中」「第4四半期に季節性がある」
競争の密度	nicheBrandCountLte、nicheBrandCountYoyChangePctAtLeastLte、nicheTop5ProductClickSharePctAtLeastLte、featureTop5BrandSharePctAtLeastLte	「新規参入しやすい」「ブランドが分散している」「寡占状態ではない」「ブランドが撤退している」
価格と価格帯	priceMinUsdGte、priceMaxUsdLte、priceSweetSpotMinUsdGte/Lte、priceEntryClickSharePctAtLeastGte、priceMidClickSharePctAtLeastLte、priceHighClickSharePctAtLeastGte	「手頃な価格を重視」「プレミアム商品に適している」「中価格帯のブルーオーシャン」
人口統計	demoPrimaryAgeMinGte、demoPrimaryAgeMaxLte、demoGenderDominant、demoPrimaryIncomeTier、demoLifeStageTagsContains	「女性が主な購入層」「高所得層」「親」「フィットネス愛好家」
商品の特徴	featureNewAvgReviewCountAtLeastLte、featureEstablishedAvgReviewCountAtLeastLte、featureEmergingTrendTagsContains、featureUncommonFeatureTagsContains、searchTopCategory1Label	「新商品の参入障壁が低い」「新たなトレンド」「珍しい特徴が差別化につながる」「セット／キットのニッチ市場」
レビューの分析情報	reviewPositiveTop1Topic、reviewPositiveTop1PctAtLeastGte/Lte、reviewNegativeTop1Topic、reviewNegativeTop1PctAtLeastGte/Lte、reviewNegativeTop2Topic、reviewStrategicInsightTagsContains	「顧客の悩みに応えるニッチ市場」「快適さを重視する購入層」「サイズの問題を解決する機会」

全パラメーターの一覧、型、値の範囲、レスポンスフィールドの対応表については、references/api.mdを参照してください。

対応マーケットプレイス

現在対応しているのはUS（アメリカ合衆国）のみです。常にamazonDomainにUSを設定してください（または省略してください）。ユーザーが他のマーケットプレイスを希望する場合は、このツールが現在、米国市場のみを対象としていることを伝えてください。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-opportunity-search-by-metrics-<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／套餐到期／需充值／请充值」、または同様の意味の内容が含まれています。

クエリの作成方法

ユーザーが自然言語で業務上の意図を表現したら、それを実行可能な最小限のフィルターセットに変換します。原則：

1. 意図を具体的な範囲に変換する：「競争が少ない」→ nicheBrandCountLte: 20。「急成長している」→ nicheSearchVolumeYoyChangePctAtLeastGte: 100（前年比 ≥100％）。「新規参入者向け」→ featureNewAvgReviewCountAtLeastLte: 500。
2. 絞り込んでから緩和する：最初の呼び出しでは通常、強いフィルターを 2～4 個設定し、limit=25 にします。結果が空、または少なすぎる場合は、新たなフィルターを追加するのではなく、最も厳しいフィルターを削除するか、範囲を広げます。
3. 相補的なシグナルを組み合わせる：ブランドレベルと商品レベルの集中度（featureTop5BrandSharePctAtLeastLte + nicheTop5ProductClickSharePctAtLeastGte）から、「ブランドは分散しているが商品は集中している」状態が分かります。これはブランド拡張による参入のシグナルです。
4. タグフィールドには snake_case の断片を使う：featureEmergingTrendTagsContains、demoLifeStageTagsContains、reviewNegativeTop1Topic などは snake_case の単語の断片を受け付け、LIKE マッチングを使用します。正規化されたバリエーションを広くカバーするには、語幹（size、parent、cordless）を渡してください。
5. ユーザーの意図に忠実にする：ユーザーが求めていないフィルターを黙って追加してはいけません。「成長している」とだけ述べた場合は、成長に関する条件だけで絞り込みます。価格について言及していない限り、価格を条件に加えないでください。

よくあるシナリオ

1. キーワードによるニッチ市場の逆引き

{"keyword": "whoop band", "limit": 25}

2. 競争が少なく新規参入者向けのニッチ市場

{"nicheBrandCountLte": 20, "featureNewAvgReviewCountAtLeastLte": 500, "limit": 25}

3. 高成長のブルーオーシャン（前年比 ≥100％、ブランドの流入はまだ少ない）

{"nicheSearchVolumeYoyChangePctAtLeastGte": 100, "nicheBrandCountYoyChangePctAtLeastLte": 30, "limit": 25}

4. 中価格帯の価格ギャップ（低価格帯が支配的で、中価格帯が少ない）

{"priceEntryClickSharePctAtLeastGte": 70, "priceMidClickSharePctAtLeastLte": 5, "limit": 25}

5. ペインポイントからの参入 — サイズに関する不満が多い

{"reviewNegativeTop1Topic": "size", "reviewNegativeTop1PctAtLeastGte": 70, "limit": 25}

6. プレミアム商品向けで女性が主導するニッチ市場

{"demoGenderDominant": "female", "demoPrimaryIncomeTier": "high", "priceHighClickSharePctAtLeastGte": 25, "limit": 25}

7. 検索ピークが 10 万回以上の第 4 四半期の季節性ニッチ市場

{"nichePeakMonthGte": 11, "nichePeakMonthLte": 12, "nichePeakSearchVolumeAtLeastGte": 100000, "limit": 25}

8. 既知の競合ブランド周辺のニッチ市場を追跡する

{"featureTopBrandsContains": "WHOOP", "limit": 50}

表示ルール

1. データのみを提示：返されたニッチを、ニッチ名／キーワード、市場規模、成長率、ブランド数、価格帯、主なタグを含む比較表として見やすく表示します。主観的なビジネスアドバイスは含めません。
2. 適用中のフィルターを表示：使用したフィルターセットを明記し、ユーザーが調整できるようにします（「現在のフィルター：ブランド数 ≤ 20、かつ検索ボリュームの前年比 ≥ 100％」）。
3. データ時点に関する注意：レコードは収集時点のデータを反映しており、継続的に更新されるものではありません。結果が古く見える場合や、ユーザーが知っている外部情報と食い違う場合は、この点に触れてください。
4. 結果がない／少ない場合の対応：data が空または非常に短い場合は、最初からユーザーに聞き直すのではなく、最も厳しいフィルターを緩めるよう提案します。
5. エラー処理：クエリに失敗した場合は、msg フィールドに基づいて理由を説明します（多くの場合、「パラメーターがすべて空」の場合に拒否されます）。少なくとも1つのフィルターを追加するよう提案してください。
6. 二次集計を行わない：結果はフロントエンドでの表示に使用され、保存されないため、さらなる集計のために @智能数据查询（インテリジェントデータクエリ）へ渡すことはできません。ニッチをまたいだグループ別統計を求められた場合は、ローカルで計算するか、まず limit を大きくしてデータを取得してください。

重要な制限事項

• 米国のみ：現在は米国のマーケットプレイスのみをサポートしています（amazonDomain = US）。
• ページネーションなし：page パラメーターはありません。候補の範囲を広げるには limit を増やしてください（最大200）。結果は収集時刻の新しい順に並びます。
• 少なくとも1つのフィルターが必要：keyword／nicheName がなく、指標フィルターもない呼び出しは拒否されます。
• スナップショットデータ：レコードは過去のオポチュニティレポートから集計されています。新しいレポートによってデータプールは随時更新されますが、個々のレコードはリアルタイムではありません。
• ニッチ単位の粒度：出力はニッチ／キーワード単位であり、ASIN単位ではありません。ニッチ内の特定の商品を詳しく調べるには、linkfox-amazon-search、linkfox-keepa-product-search などに引き継いでください。

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

適用可能 — 米国Amazon市場でのニッチ単位の逆引き選定：

ユーザーの発言	シナリオ
「競争の少ないニッチ」「新規参入者向け」「ブランドが少ない」	ブランド密度フィルター
「ブランドが撤退している」「既存プレイヤーが退いている」	ブランド数の前年比マイナス
「急成長中のニッチ」「上昇傾向」「前年比 ≥ 100％」	検索ボリュームの前年比フィルター
「中価格帯のブルーオーシャン」「低価格帯が優勢だが、中価格帯は少ない」	価格帯別シェアのギャップ
「高価格帯向け」「高所得の消費者」	所得層＋高価格帯シェア
「女性向け／男性向け／男女混合市場」	性別の優位性フィルター
「親／学生／退職者／フィットネス愛好家」	ライフステージタグ
「サイズ／品質／耐久性に関する不満が強い」	否定的なレビューのトピック＋シェア
「快適性重視」「価値重視の販売者」	肯定的なレビューのトピック＋シェア
「ブランドXに関連するすべてのニッチを追跡」	featureTopBrandsContains
「第4四半期の季節性ニッチ」「プライムデー期間」	ピーク月＋ピークボリューム

適用不可 — 代わりにほかのツールを使用してください：

• 1つのキーワードについて包括的なAIレポートが必要 → linkfox-amazon-opportunity-report
• ASIN単位の競合調査、売上推定 → SellerSprite／Keepa／Sorftime ツール
• リアルタイムのキーワードランキング、検索語句のマイニング → ABA／SIF ツール
• 米国以外のマーケットプレイス → このツールではまだサポートされていません
• @智能数据查询 を使ってニッチをグループ化して集計したい → 非対応（データは保存されません）

適用範囲の判断：ユーザーがビジネス用語で選定条件を説明し、それに合致する候補ニッチを求めている場合は、このスキルが適用されます。特定のキーワードを提示し、多角的な分析を求めている場合は、linkfox-amazon-opportunity-report を使用してください。ニッチ内のASIN／販売者を詳しく調べたい場合は、商品検索ツールに引き継いでください。

計算リソースの消費ルール

動的ルールに基づいて課金されます：消費リソース = 1.5 × (N ≤ 25 ? 5 : 5 + ceil((N - 25) / 5))。N はインターフェースが実際に返すデータ件数です。N = 0 の場合でも、インターフェースが成功すれば 15000 が課金されます。

重要：このスキルのサービスは倍率に応じて動的に計算されるため、一度に大量のリソースを消費する可能性があります。必ずユーザーに警告し、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

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

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

references/api.md の指定に従ってフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

---

高品質でプロフェッショナルな越境 EC スキルをお探しの場合は、LinkFox Skills をご覧ください。