linkfox-jiimore-product-discovery

Jiimore 商品発掘

このスキルでは、Jiimore 商品発掘エンジンを使用して、可能性の高い Amazon 商品を見つけ、分析する方法を説明します。コンバージョン、クリック数の増加、収益性の指標を使ってキーワードで絞り込むことで、Amazon セラーが将来有望なベストセラー候補を見つけられるよう支援します。

基本概念

Jiimore 商品発掘は、キーワードを使って Amazon 商品を発掘するツールです。検索キーワードを指定すると、コンバージョン率、クリック数の増加率、粗利益率、価格、レビュー数、出品期間など、指定したパフォーマンス条件に一致する商品の一覧が返されます。そのため、新たなビジネスチャンスの発見、商品アイデアの検証、競合ベンチマークに最適です。

キーワードは必須です：すべてのクエリに keyword を含める必要があります。キーワードは対象マーケットプレイスの言語に翻訳してください（例：JP には日本語、DE にはドイツ語）。

率の値は小数です：コンバージョン率と増加率は、0～1 の小数で表します。たとえば、0.1 は 10%、0.25 は 25% を意味します。ユーザーがパーセンテージを指定したときに混同しやすい点です。

マーケットプレイスのサポート：現在、US（米国）、JP（日本）、DE（ドイツ）をサポートしています。デフォルトは US です。ユーザーがマーケットプレイスを指定しない場合は、US を使用してください。

パラメーターガイド

必須

パラメーター	説明	例
keyword	検索キーワード（対象マーケットプレイスの言語に翻訳する必要があります）	wireless charger

絞り込みパラメーター

パラメーター	説明	値の形式
priceMin / priceMax	商品価格の範囲	数値（例：10.0、50.0）
totalReviewsMin / totalReviewsMax	レビュー数の範囲	整数（例：0、500）
customerRatingMin / customerRatingMax	顧客評価の範囲	数値（例：4.0、5.0）
clickConversionRateMin / clickConversionRateMax	クリックから購入へのコンバージョン率	小数 0～1（0.1 = 10%）
clickConversionRateCompositeMin / clickConversionRateCompositeMax	複合コンバージョン率	小数 0～1（0.1 = 10%）
clickCountT7Min / clickCountT7Max	週間クリック数の範囲	整数
clickCountT30Min / clickCountT30Max	月間クリック数の範囲	整数
clickCountGrowthT7Min / clickCountGrowthT7Max	週間クリック増加率	小数 0～1（0.1 = 10%）
clickCountGrowthT30Min / clickCountGrowthT30Max	月間クリック増加率	小数 0～1（0.1 = 10%）
salesVolumeT360Min / salesVolumeT360Max	年間販売量の範囲	整数
grossProfitMarginMin / grossProfitMarginMax	粗利益率の範囲	数値
fbaFeeMin / fbaFeeMax	FBA 手数料の範囲	数値
launchDateMin / launchDateMax	出品日の範囲	文字列：yyyyMMdd000000
nicheCountMin / nicheCountMax	ニッチ市場数の範囲	整数
sellerCountry	セラーの原産国コード（複数の場合はカンマ区切り）	CN,US
countryCode	対象マーケットプレイス（US、JP、DE）	US

並べ替えとページネーション

パラメーター	説明	デフォルト
sortField	フィールドで並べ替え（以下の選択肢を参照）	purchasedClicksT360
sortType	並べ替え順：desc または asc	desc
page	ページ番号	1
pageSize	1 ページあたりの結果数（10～100）	50

利用可能な並べ替えフィールド：totalReviews、price、launchDate、clickCountT7、clickCountT30、clickCountT90、clickConversionRate、clickConversionRateComposite、customerRating、purchasedClicksT360、clickCountGrowthT7、clickCountGrowthT30、currentPrice、fbaFee、shippingFee、gpm

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-product-discovery-<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. 米国市場でコンバージョン率の高いワイヤレス充電器を探す

{
  "keyword": "wireless charger",
  "countryCode": "US",
  "clickConversionRateMin": 0.1,
  "sortField": "clickConversionRate",
  "sortType": "desc"
}

2. 急成長している新商品を見つける（出品から6か月以内、週間クリック数の増加率が20％超）

{
  "keyword": "desk lamp",
  "countryCode": "US",
  "launchDateMin": "20250901000000",
  "clickCountGrowthT7Min": 0.2,
  "sortField": "clickCountGrowthT7",
  "sortType": "desc"
}

3. 競争率が低く（レビューが少ない）、価格が割安で利益率の高い商品を見つける

{
  "keyword": "phone stand",
  "countryCode": "US",
  "priceMin": 10,
  "priceMax": 30,
  "totalReviewsMax": 100,
  "grossProfitMarginMin": 0.3,
  "sortField": "gpm",
  "sortType": "desc"
}

4. ドイツ市場で月間クリック数が大きく増加している中国の出品者の商品を探す

{
  "keyword": "Handyhuelle",
  "countryCode": "DE",
  "sellerCountry": "CN",
  "clickCountGrowthT30Min": 0.15,
  "sortField": "clickCountGrowthT30",
  "sortType": "desc"
}

5. 日本市場で評価が高く、年間売上が大きい商品を見つける

{
  "keyword": "ワイヤレスイヤホン",
  "countryCode": "JP",
  "customerRatingMin": 4.0,
  "salesVolumeT360Min": 1000,
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}

6. 総合コンバージョン率が高く、複数のニッチ市場があるニッチなビジネスチャンスを特定する

{
  "keyword": "yoga mat",
  "countryCode": "US",
  "clickConversionRateCompositeMin": 0.15,
  "nicheCountMin": 3,
  "sortField": "clickConversionRateComposite",
  "sortType": "desc"
}

表示ルール

1. データをわかりやすく提示する：商品タイトル、ASIN、価格、評価、コンバージョン率、クリック数、増加率を含む、構造化された表で検索結果を表示してください。
2. 率の表示形式：読みやすいよう、率の値は必ずパーセンテージで表示してください（例：0.12 は12％と表示します）。API には小数（0～1）を指定する必要があることをユーザーに伝えてください。
3. 画像の表示：商品画像の URL がある場合は、データと並べてメインの商品画像を表示してください。
4. ページネーションへの留意：結果が複数ページにわたる場合は、合計件数と現在のページをユーザーに伝え、追加ページの取得を提案してください。
5. キーワードの翻訳に関する注意：キーワードは対象マーケットプレイスの言語で入力する必要があることをユーザーに伝えてください（米国は英語、日本は日本語、ドイツはドイツ語）。
6. エラー処理：検索に失敗した場合は、レスポンスに基づいて理由を説明し、検索条件の調整を提案してください。
7. 主観的なアドバイスは禁止：主観的なビジネス上の推奨をせず、事実に基づく商品データを提示してください。

重要な制限事項

• キーワードは必須です：すべての検索でキーワードが必要です。キーワードを指定しない検索には対応していません。
• 対象マーケットプレイスは3つのみです：現在は米国、日本、ドイツに限定されています。
• ページサイズの上限：1ページあたり最大100件です。
• 率の値：すべての率／パーセンテージのパラメーターは、パーセンテージではなく小数（0～1）で渡す必要があります。
• 発売日の形式：yyyyMMdd000000 形式に厳密に従う必要があります（例：20250101000000）。

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

該当 -- 商品の発掘・調査タスク：

ユーザーの発言	シナリオ
"キーワード X の人気商品を探して"	キーワードに基づく商品発掘
"コンバージョン率の高い商品", "ベストセラー"	コンバージョン率の高い商品の選定
"急成長中の商品", "トレンド商品"	クリック数の伸びに基づく商品発掘
"ポテンシャルの高い新商品"	新規出品＋成長率による絞り込み
"利益率の高い商品", "収益性の高い商品"	粗利益率による選定
"競争率の低い商品", "レビューが少ない商品"	レビュー数の少ない商品機会の発掘
"中国のセラーの商品"	セラーの原産地による絞り込み
"ニッチ市場の機会"	ニッチ市場の商品数に基づく発掘

該当しない -- 商品の発掘以外のニーズ：

• ABA 検索語句データとキーワード分析（ABA Data Explorer を使用）
• 広告／PPC キャンペーン管理
• 商品レビューと出品情報の最適化
• 在庫管理とサプライチェーン
• 利益・価格戦略を含む包括的な市場レポート

計算リソース消費ルール

計算リソースを 9 消費します。

ユーザーは計算リソースの消費に対して料金を支払います。十分に評価してください。このスキルを高頻度で呼び出す必要がある場合や、ユーザーが計算リソースの消費量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

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

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

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

---

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