linkfox-sorftime-amazon-product-detail

Sorftime 製品詳細

このスキルでは、Sorftime を介して ASIN による Amazon 製品の詳細データと過去のトレンドデータを照会する方法を説明します。Amazon の販売者が製品のパフォーマンス、価格戦略、競争上の位置付けを分析するのに役立ちます。

主な概念

Sorftime 製品詳細では、ASIN ごとの包括的な製品レベルのデータを提供し、2021 年までさかのぼる過去のトレンドデータも確認できます。販売数量と売上のトレンド、価格とプロモーションの追跡、多階層の BSR ランキング履歴、FBA 手数料の内訳を含むリアルタイムの利益分析を扱います。

主な差別化要因：このツールは、個々の製品のトレンド／時系列データを返します。カテゴリー、ブランド、または販売者を横断して製品を検索／絞り込む必要がある場合は、代わりに Sorftime 製品検索スキルを使用してください。

データフィールド

レスポンスデータは以下のカテゴリーをカバーします（フィールドの完全なリファレンスについては references/api.md を参照してください）。

• 基本情報：タイトル、ブランド、ASIN、出品 URL、画像（メイン＋A+）、ストア名、箇条書き、製品バッジ、販売終了ステータス、最終更新日、重量、サイズ
• バリエーション：親 ASIN、バリエーション数、子 ASIN、バリエーション属性
• 価格と利益：販売価格、クーポン、プラットフォーム手数料、FBA 手数料（詳細な内訳を含む）、FBM 配送料、利益額と利益率
• 販売：公式の月間販売数（Amazon 公表値）
• ランキング：BSR ランク、カテゴリー階層、サブカテゴリーランキング、出品日、オンライン日数
• 評価：評価スコア、評価数、星の分布（星 1～5 の割合）
• 販売者：Buy Box 販売者名／ID／国、FBA ステータス、販売者数
• 出品情報：A+ コンテンツ、動画、ブランドストア、機能評価、製品情報、特性
• プロモーション：ブランドプロモーション、セールの種類、追加割引
• トレンド（時系列）：BSR ランク、サブ BSR ランク、日次／月次販売数量、日次／月次売上、価格、定価、セールステータス

対応マーケットプレイス

US（米国）、GB（英国）、DE（ドイツ）、FR（フランス）、IN（インド）、CA（カナダ）、JP（日本）、ES（スペイン）、IT（イタリア）、MX（メキシコ）、AE（アラブ首長国連邦）、AU（オーストラリア）、BR（ブラジル）、SA（サウジアラビア）

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

注：Sorftime では小文字のコード（例：us、gb、de）を使用し、英国のコードは uk ではなく gb です。

呼び出し方法

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

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

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

クエリの作成方法

主要なパラメーターは asin と marketplace（どちらも必須）で、それに加えて任意のトレンド期間指定パラメーターを使用します。

クエリ作成の原則

1. マーケットプレイスを必ず指定する：us、de、jp など、小文字のサイトコードを使用します
2. トレンドを含めるか慎重に選択する：デフォルトではトレンド（過去15日間）が含まれます。基本的な商品情報のみが必要な場合は、includeTrend: 2 を設定してください。コストを抑え、応答を速くできます
3. 過去の分析では期間を指定する：デフォルトの15日間を超えるトレンドが必要な場合は、queryTrendStartDate と queryTrendEndDate（yyyy-MM-dd）を使用します。コストが2倍になる点にご注意ください
4. 比較時はASINをまとめて指定する：最大10件のASINをカンマ区切りで一度にクエリできます。1件ずつ呼び出すのではなく、競合比較に活用してください

よくあるシナリオのクエリ例

1. 商品をすばやく確認する（デフォルトの15日間のトレンド）

asin: B00FLYWNYQ, marketplace: us

2. 長期間のトレンド分析（日付を指定）

asin: B00FLYWNYQ, marketplace: us
queryTrendStartDate: 2025-01-01, queryTrendEndDate: 2025-03-31

3. 複数のASINをまとめて比較する

asin: B0088PUEPK,B00U26V4VQ,B0CVM8TXHP, marketplace: us

4. トレンドなしで商品情報のみを取得する

asin: B0088PUEPK, marketplace: us, includeTrend: 2

5. BSRランキングの履歴（ドイツ市場）

asin: B00FLYWNYQ, marketplace: de
queryTrendStartDate: 2024-06-01, queryTrendEndDate: 2025-01-01

トレンドデータの解釈

トレンド配列は交互形式です。偶数インデックスが日付、奇数インデックスが値です。

[20250101, 150, 20250102, 180, 20250103, 165, ...]
 ^date     ^val ^date     ^val ^date     ^val

• 販売数量／売上高のトレンド：値が -1 の場合は「推定できない」ことを示します（例：カテゴリーが Amazon Renewed に変更された場合）
• 価格のトレンド：単位は現地通貨の最小単位です（USDならセント）。-1 はその日の価格データがないことを示します
• BSRランキングのトレンド：bsrRankTrend の形式は、サブカテゴリーごとに [{NodeId: xxx, Rank: [date, rank, ...]}] です
• Dealのトレンド：値が 1 の場合はその日に有効なDealがあり、0 の場合はDealがありません

表示ルール

1. データのみを提示する：クエリ結果は、主観的なビジネス上の助言を加えず、分かりやすい表で表示します
2. ランキングの補足：ランキングデータを表示する際は、値が小さいほど上位であることをユーザーに伝えます
3. 価格単位に注意する：トレンドデータの単位は通貨の最小単位です（USDならセント）。ユーザーに表示する際は標準的な通貨単位に換算します
4. 販売数の推定に関する注意：販売数量／売上高のフィールドで値が -1 の場合は「推定できない」ことを示します。-1 をそのまま表示するのではなく、ユーザーに説明します
5. トレンドを視覚化する：トレンドデータを表示する際は、生の配列をそのまま出力せず、主要なデータポイントを読みやすい表にまとめます
6. 販売停止時の対応：offSale が true の場合、商品が現在購入できない、または販売停止中であることを明確に伝えます
7. エラーへの対応：クエリが失敗した場合は、msg フィールドに基づいて理由を説明し、クエリ条件の調整を提案します

重要な制限事項

• クエリあたりのASINは最大10件です
• トレンドのコスト：デフォルトでは過去15日間が返されます。15日を超える期間をクエリするとコストが2倍になります
• 非構造化データ：結果は _dataQuery_executeDynamicQuery による二次分析に対応していません
• 販売数の推定：標準外のカテゴリー（例：Amazon Renewed）の商品では、販売数フィールドが -1 になることがあります

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

該当するもの - ASINによる商品詳細およびトレンドのクエリ：

ユーザーの発言	シナリオ
「查一下这个ASIN的销量走势」	販売数量のトレンド
「这个产品最近价格变化如何」	価格履歴
「帮我看看这个产品的利润空间」	利益分析
「这个ASIN的BSR排名趋势」	ランキング履歴
「对比一下这几个ASIN的数据」	複数ASINの比較
「这个产品的FBA费用是多少」	FBA手数料の内訳
「产品上架多久了，评分怎么样」	基本的な商品情報
「这个产品还在售吗」	販売停止状況の確認
「这个产品有没有Deal促销记录」	Deal履歴
「看看这个产品的变体信息」	バリエーションの詳細

該当しないもの - 単一商品の詳細情報を超える内容が必要な場合：

• カテゴリーまたはブランドをまたいだ商品の検索／絞り込み（Sorftime Product Search を使用）
• ABA検索語のランキングデータ（ABA Data Explorer を使用）
• 広告／PPC戦略
• 商品レビューの内容分析
• 特許または商標の確認

適用範囲の判断：「商品分析」や「競合比較」という依頼でも、特定のASINの詳細データやトレンド曲線の確認にとどまる場合は、このスキルが該当します。市場全体から商品を発見または絞り込む依頼の場合は、該当しません。

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

動的ルールに基づいて課金されます：消費する計算リソース = Sorftime内部クエリ回数 × 6。Sorftime内部クエリ回数：クエリ条件によって必要なクエリ回数は異なる場合があり、その回数はSorftimeが決定します。

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

フィードバック：

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

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

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

---

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