linkfox-junglescout-product-database

Jungle Scout — 商品データベース検索

このスキルは、LinkFox ツールゲートウェイを介して Jungle Scout の商品データベースを検索し、10 のマーケットプレイスにおいて、複数条件で Amazon 商品を絞り込めます。販売者は、カテゴリー、価格帯、販売数、売上、レビュー、評価、BSR 順位、Listing Quality Score（LQS）、販売者タイプなどで商品を見つけられます。

主な概念

Jungle Scout 商品データベースは、Amazon 商品レベルの多次元絞り込みツールです。販売者が膨大な商品から目的の商品をすばやく見つけるのに役立ちます。

• カテゴリー別の商品選定：Amazon のメインカテゴリーで絞り込み、特定カテゴリーの商品を検索します
• 販売数／売上による絞り込み：月間販売数と月間売上の範囲を指定して、市場規模が適切な商品を絞り込みます
• 競争度の評価：レビュー数、評価、販売者数から競争の激しさを判断します
• Listing の品質評価：LQS（Listing Quality Score、1～10 点）を使って、改善の余地が大きい商品を見つけます
• 商品タイプによる絞り込み：FBA／FBM／AMZ の販売者タイプや、標準サイズ／大型サイズを区別します
• 新商品の発見：出品日で絞り込み、最近出品された新商品を見つけます

内部ページネーション：API がページネーションを自動で処理します。needCount を指定して必要な結果数を設定すると、バックエンドが内部で複数ページからデータを取得します。

データフィールド

主な出力フィールド

フィールド	API 名	説明	例
商品タイトル	title	商品タイトル	Yoga Mat Non Slip...
ブランド	brand	ブランド名	Liforme
メインカテゴリー	category	Amazon のメインカテゴリー	Sports & Outdoors
カテゴリーパス	breadcrumbPath	完全なカテゴリー階層	Sports & Outdoors > Exercise & Fitness
価格	price	現在の販売価格（USD）	29.99
月間販売数	approximate30DayUnitsSold	直近 30 日間の推定販売数	1200
月間売上	approximate30DayRevenue	直近 30 日間の推定売上（USD）	35988.00
BSR 順位	productRank	Best Sellers Rank	3456
レビュー数	reviews	累計レビュー数	850
評価	rating	平均評価（1.0～5.0）	4.5
LQS	listingQualityScore	Listing の品質スコア（1～10）	8
販売者数	numberOfSellers	販売中の販売者数	3
販売者タイプ	sellerType	販売者タイプ（amz/fba/fbm）	fba
初回出品日	dateFirstAvailable	商品の初回出品日	2024-06-15
重量	weightValue / weightUnit	商品の重量	2.5 lbs
寸法	lengthValue / widthValue / heightValue / dimensionsUnit	商品の寸法	24×8×8 inches
親 ASIN	parentAsin	親商品の ASIN	B0XXXXXXXX
Buy Box の保有者	buyBoxOwner	現在 Buy Box を保有している販売者	BrandName
手数料の内訳	feeBreakdown	FBA 手数料、紹介料、手数料合計など	{fbaFee: 5.40, ...}
サブカテゴリー順位	subcategoryRanks	サブカテゴリーの BSR 順位一覧	[{subcategory: "Yoga Mats", rank: 12}]
消費トークン数	costToken	今回の呼び出しで消費したトークン数	5

対応マーケットプレイス

us（米国）、uk（英国）、de（ドイツ）、in（インド）、ca（カナダ）、fr（フランス）、it（イタリア）、es（スペイン）、mx（メキシコ）、jp（日本）

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

呼び出し方法

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

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

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

クエリの作成方法

marketplace のみが必須です。それ以外のパラメーターはすべて任意のフィルターで、組み合わせて結果を絞り込めます。

API 呼び出しを作成する際の原則

1. マーケットプレイスのマッピング：ユーザーが「米国サイト」と言った場合は us、「日本サイト」の場合は jp、「ドイツサイト」の場合は de を指定します。指定がない場合はデフォルトの us を使用します
2. キーワード：includeKeywords には、タイトルまたは ASIN に対する複数の単語をカンマ区切りで指定できます（例：yoga mat,fitness）。excludeKeywords は、特定の単語を含む商品を除外します
3. カテゴリーの指定：categories には、対象サイトに対応する英語の標準カテゴリー名を指定する必要があります。たとえば米国サイトの場合は Sports & Outdoors、Home & Kitchen などです。複数のカテゴリーはカンマで区切ります
4. 数値の範囲：min／max は組み合わせて使用しますが、片方のみ指定することもできます。たとえば minSales=300 のみを設定すると、月間販売数が 300 以上の商品を指定できます
5. 並べ替え：sort のフィールド名の前に - を付けると降順になります。たとえば -sales は販売数の多い順です。デフォルトでは name の昇順で並べ替えます
6. 結果数：needCount で返す結果の合計数を指定します。設定しない場合はデフォルトの件数が返されます

一般的な検索シナリオ

1. キーワード検索＋販売数で絞り込み

{
  "marketplace": "us",
  "includeKeywords": "yoga mat",
  "minSales": 300,
  "maxSales": 5000,
  "sort": "-sales",
  "needCount": 50
}

2. カテゴリー＋価格帯で絞り込み

{
  "marketplace": "us",
  "categories": "Home & Kitchen",
  "minPrice": 15,
  "maxPrice": 50,
  "minSales": 100,
  "sort": "-revenue",
  "needCount": 50
}

3. 高評価・低競争の商品を探す（レビュー数は少ないが評価は高い）

{
  "marketplace": "us",
  "categories": "Beauty & Personal Care",
  "minRating": 4.0,
  "maxReviews": 200,
  "minSales": 100,
  "sort": "-sales",
  "needCount": 50
}

4. FBA 商品のみを絞り込み

{
  "marketplace": "us",
  "includeKeywords": "phone stand",
  "sellerTypes": "fba",
  "productTiers": "standard",
  "minSales": 200,
  "sort": "-sales",
  "needCount": 50
}

5. 大手ブランドを除外＋ブルーオーシャンの機会を発見

{
  "marketplace": "us",
  "categories": "Sports & Outdoors",
  "excludeTopBrands": true,
  "minSales": 300,
  "maxReviews": 500,
  "minRating": 4.0,
  "sort": "-sales",
  "needCount": 50
}

6. 出品日で新商品を探す

{
  "marketplace": "us",
  "categories": "Electronics",
  "minUpdatedAt": "2026-01-01",
  "minSales": 50,
  "sort": "-sales",
  "needCount": 50
}

表示ルール

1. 表形式：タイトル、ブランド、価格、月間販売数、月間売上高、BSR ランク、レビュー数、評価、LQS などの主要項目を含む構造化された表で結果を表示します
2. 並べ替えに関する注記：適用した並べ替え方法と、返された結果の件数をユーザーに伝えます
3. 注目ポイントの強調：レビュー数が特に少ない一方で販売数が多い商品（有望な機会）、または LQS スコアが高い商品を示します
4. 手数料の内訳：ユーザーが収益性について尋ねた場合は、feeBreakdown の詳細（FBA 手数料、紹介手数料、手数料合計）を含めます
5. 画像リンク：個別商品の詳細を表示する際は、imageUrl を含めます
6. エラー処理：クエリに失敗した場合は、エラーレスポンスに基づいて理由を説明し、パラメーターの調整を提案します

重要な制限事項

• marketplace は必須：クエリごとにサイトを指定する必要があります
• カテゴリー名は一致が必要：categories の値は、該当するサイトの標準的な最上位カテゴリー名と完全に一致する必要があります
• キーワードの制限：includeKeywords / excludeKeywords はそれぞれ最大100項目まで、各項目は最長50文字です
• データの鮮度：データは Jungle Scout が定期的に更新しており、リアルタイムではありません
• 評価の範囲：minRating / maxRating は 1.0〜5.0 の範囲で指定します
• 重量の単位：minWeight / maxWeight はポンド（pounds）単位です

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

適用対象 - Amazon 商品の複数条件による絞り込みと発見：

ユーザーの表現	シナリオ
"月間販売数500以上のヨガマットを探して"	キーワード＋販売数で絞り込み
"米国サイトのキッチンカテゴリーで30ドル以下の良い商品はある？"	カテゴリー＋価格で絞り込み
"レビュー数は少ないが評価が高いブルーオーシャン商品"	高評価・低競争の商品を探す
"FBA 標準サイズのスマホスタンドを探して"	出品者タイプ＋商品サイズで絞り込み
"大手ブランドを除外したスポーツカテゴリーの機会"	大手ブランドを除外
"最近出品された電子製品で、よく売れているものは？"	新商品の発見
"BSR ランクが1万以内のホーム用品"	BSR ランクで絞り込み
"LQS が5点未満の高販売数商品"	出品情報の最適化機会

適用対象外 - 商品データベースの絞り込み以外：

• キーワード検索数／トレンド分析（キーワードの過去の検索数を調べるツールが必要です）
• ABA 検索語ランク（ABA ツールが必要です）
• 商品詳細ページ／出品情報の分析
• 広告／PPC の運用戦略
• Amazon 以外のプラットフォームの商品データ

適用範囲の判断：ユーザーが「商品を選ぶ」「商品を探す」「市場調査」と言い、Amazon の商品カタログから価格、販売数、カテゴリー、レビュー数などの具体的な条件で商品を絞り込む必要がある場合、このスキルが適用されます。キーワード単位の検索数データ、広告に関する知見、または Amazon 以外のプラットフォームのデータが必要な場合は適用されません。

計算リソース消費ルール

動的なルールに基づいて課金されます：計算リソース消費量 = 実際のクエリページ数 × 63.75。

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

フィードバック：

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

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

references/api.md に記載されている方法でフィードバック API を呼び出してください。ユーザーの操作を中断しないでください。

---

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