linkfox-amazon-opportunity-report-by-keyword

Amazon マーケット機会レポート

このスキルでは、Amazon のキーワードに関する AI を活用した包括的な市場インサイトレポートの生成方法を説明します。販売者がデータに基づいて商品選定や市場参入の判断を行えるよう支援します。

基本概念

このツールは、Amazon のキーワードを次の 6 つの主要な観点から分析し、包括的なビジネスインサイトレポートを生成します。

1. 市場ポテンシャル - 検索ボリューム、需要の傾向、成長機会
2. 商品特性 - 一般的な商品属性、素材、特徴
3. ユーザーレビュー - 顧客の感情、課題、満足度を高める要因
4. 顧客プロフィール - 購入者の属性、好み、行動パターン
5. 検索トレンド - キーワードの人気度の推移と季節性
6. 価格分析 - 価格分布、競合の価格状況

レポートは、リアルタイムの Amazon データをもとに AI が生成し、構造化された Markdown ドキュメントとして提供します。意思決定を支援するための一時点のスナップショット分析であり、リアルタイム監視ツールではありません。

パラメーター

パラメーター	型	必須	説明	デフォルト
site	string	はい	Amazon マーケットプレイスのコード（現在は US のみ）	US
keyword	string	はい	分析対象の検索キーワード	-

対応マーケットプレイス

現在対応しているのは US（米国）のみです。site は必ず US に設定してください。他のマーケットプレイスを指定された場合は、このツールが現在対象としているのは米国市場のみであることを伝えてください。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-opportunity-report-by-keyword-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリを指します。<session> は環境変数 SESSION_ID から取得され、ユーザーのタスクごとに自動でまとめられます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
• レスポンス本文が 8 KB 以下の場合：ファイルへの保存後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える場合：ファイルへの保存後、stdout には概要のみを出力します（トップレベルのフィールド、total／costToken などの一般的なカウント、最大のリストフィールドの長さと先頭 3 件のサンプル）
• --inline を指定すると、ファイルへの保存に加えて、stdout に全量を強制的に出力します

データの読み取りに関する推奨事項：まず概要を確認し、それで十分か判断してください。具体的なフィールドが必要な場合は、JSON 全体をコンテキストに読み込むことを避けるため、保存された json ファイルから jq または ConvertFrom-Json を使って必要なデータを抽出してください。

認証と計算リソースに関する問題の解決

以下の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常の種類

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY および LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高不足を示すレスポンス：メッセージに「計算リソースの残高不足／請求不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれています。

使用例

1. 基本的なマーケット機会レポート

帮我搜索美国站，关键词是 hair mousse travel size 的商业洞察报告

2. ニッチ商品のリサーチ

帮我生成美国站关键词 magnetic shelves for whiteboard 的商业洞察报告

3. トレンドに基づく商品選定

我想了解美国站 solar power ac unit 这个关键词的商业洞察，帮我生成报告

表示ルール

• 主観的な助言をしない：AI が生成した分析をそのまま適用し、独自のビジネス上の推奨事項を追加しないでください
• 対象範囲を明確にする：レポートは一時点のスナップショットに基づいており、意思決定の参考として提供されることをユーザーに伝えてください
• エラー処理：クエリが失敗した場合は、msg フィールドに基づいて理由を説明し、キーワードを確認するか再試行するよう提案してください
• 二次分析を行わない：このツールの出力をデータクエリツールに渡して、さらに処理することはできません。ユーザーがそれを試みた場合は、その旨を伝えてください

重要な制限事項

• 米国のみ：現在、米国のマーケットプレイスのみ対応しています（site = US）
• 非構造化出力：構造化 JSON データではなく、Markdown レポートを返します。二次的な集計や分析のためにデータクエリツールと組み合わせて使うことはできません
• 処理時間：レポートの生成には AI 分析が含まれるため、単純なデータ検索より時間がかかることがあります
• スナップショットデータ：レポートは生成時点のデータを反映しており、継続的には更新されません

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

適用対象 - キーワードレベルの包括的な市場分析：

ユーザーの発言	シナリオ
「このキーワードの市場機会を分析してください」	市場機会の評価
「XXの市場インサイトレポートを作成してください」	包括的なインサイトレポート
「XXの競争環境はどうなっていますか」	競争と価格の分析
「XX商品を購入する消費者のプロフィール」	顧客行動のインサイト
「XXキーワードに参入する価値はありますか」	市場参入の評価
"选品报告", "商业洞察"	中国市場調査の依頼

適用対象外 - 包括的なレポートの生成を超えるニーズ：

• キーワードランキングのリアルタイム追跡（ABA または SIF ツールを使用してください）
• 個別商品の詳細情報の検索（商品詳細ツールを使用してください）
• 価格の履歴追跡（Keepa を使用してください）
• 特定の ASIN のレビュー単位の分析（レビューツールを使用してください）
• 広告／PPC 戦略

境界の判断：「市場分析」や「商品リサーチ」とユーザーが言った場合、キーワードの市場機会を多角的かつ包括的に把握したいのであれば、このスキルが適用されます。正確な販売数、個別商品の詳細、経時的なキーワードランキングなど、特定のデータポイントが必要な場合は、適切な専門ツールを案内してください。

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

動的なルールに基づいて課金されます：計算リソースの消費量 = 入力による消費量 + 7.5 × 出力による消費量。

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

フィードバック：

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

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

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

---

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