linkfox-amazon-opportunity-report

Amazon Market Opportunity Report

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

Core Concepts

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

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

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

Parameters

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

Supported Marketplaces

現在サポートされているのは US（米国）のみです。site は必ず US に設定してください。ほかのマーケットプレイスをユーザーから依頼された場合、このツールは現在、米国市場のみを対象としていることを伝えてください。

API Usage

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

Usage Examples

1. 基本的な市場機会レポート

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

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

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

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

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

Display Rules

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

Important Limitations

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

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

該当するケース - キーワードレベルでの包括的な市場分析：

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

該当しないケース - 包括的なレポート作成の範囲を超えるニーズ：

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

境界の判断：ユーザーが「市場分析」や「商品調査」と言い、キーワードの市場機会を多角的に概観したい場合は、このスキルが該当します。具体的なデータ（正確な販売数、個別商品の詳細、時系列でのキーワードランキング）が必要な場合は、適切な専用ツールを案内してください。

フィードバック：

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

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

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

大きなレスポンスの処理

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

python scripts/response_io.py run --script scripts/amazon_opportunity_report.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回の呼び出しで複数の項目が返される場合）
• 長文のフィールド（説明、レビュー、HTML、時系列データ）
• すぐに消費するのではなく、後続の手順で再利用する出力

小規模で一度だけ使うレスポンスなら、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューはスキーマの一部とサンプルを省略表示したもので、全データではありません。フィールド単位の判断には、保存済みファイルを read で読み込んでください。

---

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