linkfox-amazon-opportunity-screener

指標で絞り込む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の使用方法

このツールはLinkFoxツールゲートウェイAPIを呼び出します。呼び出し方法、リクエストパラメーター、レスポンスの構造については、references/api.mdを参照してください。クエリを実行するには、scripts/amazon_opportunity_screener.pyを直接実行する方法もあります。

クエリの作成方法

ユーザーはビジネス上の意図を自然言語で表現します。それを実用上必要最小限のフィルターセットに置き換えます。原則：

1. 意図を具体的な範囲に置き換える：「競争が少ない」→ nicheBrandCountLte: 20、「急成長している」→ nicheSearchVolumeYoyChangePctAtLeastGte: 100（前年比100％以上）、「新規参入者に適している」→ featureNewAvgReviewCountAtLeastLte: 500。
2. まず絞り込み、次に条件を緩める：最初の呼び出しでは通常、強いフィルターを2～4個指定し、limit=25 にします。結果が空、または少なすぎる場合は、フィルターを追加するのではなく、最も厳しいフィルターを外すか、条件を広げます。
3. 相補的なシグナルを組み合わせる：ブランドレベルと製品レベルの集中度（featureTop5BrandSharePctAtLeastLte + nicheTop5ProductClickSharePctAtLeastGte）を組み合わせると、「ブランドは分散しているが、製品は集中している」状態が分かります。これはブランド拡張による参入のシグナルです。
4. タグフィールドにはスネークケースの語句を使用する：featureEmergingTrendTagsContains、demoLifeStageTagsContains、reviewNegativeTop1Topic などは、スネークケースの語句を受け付け、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四半期の季節性ニッチ」「Prime Dayの期間」	ピーク月＋ピークボリューム

適用対象外 — 代わりに他のツールを使用してください：

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

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

フィードバック：

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

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

references/api.md に記載されたとおりにフィードバックAPIを呼び出してください。ユーザーの作業の流れを妨げないでください。

大きなレスポンスの処理

エージェントのコンテキストがあふれないように、レスポンスをディスクに保存し、必要なフィールドだけを抽出してください：

python scripts/response_io.py run --script scripts/amazon_opportunity_screener.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

--out-dir は、Git作業ツリーの外に指定してください（例：Unixでは /tmp/...、Windowsでは %TEMP%/...）。保存されたレスポンスにはPII、価格情報、認証機密情報が含まれる場合があります。コミットしないでください。ファイルは自動削除されないため、作業が終わったら削除してください。

run はレスポンス全体をファイルに書き込み、スキーマのプレビューとファイルパスのみを出力します。read は特定のフィールドを抽出し、--limit/--offset で範囲を指定し、--format json|jsonl|csv|table で出力形式を選択できます。

この方法を優先する場合 — 次のようなレスポンスの特性に応じて判断してください：

• 1レコードあたりのフィールド数が多い、または不要なフィールドが含まれている
• バッチ／ページネーションされた結果（1回の呼び出しで複数項目を取得）
• 長文フィールド（説明、レビュー、HTML、時系列データ）
• すぐに使用するのではなく、後続のステップでも出力を再利用する

小規模で1回限りのレスポンスなら、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューは、切り詰められたスキーマとサンプルであり、全データではありません。フィールド単位で判断する場合は、read を使って保存済みファイルを読み取ってください。

---

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