linkfox-amazon-reviews

Amazon の商品レビュー

Amazon の商品レビューを取得して分析し、顧客のフィードバックから販売者が実行可能なインサイトを得られるよう支援します。

基本概念

このツールは、指定した Amazon ASIN の実際の顧客レビューを15 のマーケットプレイスから取得します。星評価（1〜5 つ星）ごとに取得するレビュー数（各最大 100 件）を指定し、新しさまたは役立ち度で並べ替えたり、さまざまなフィルターを適用したりできます。1 回のリクエストで指定できる ASIN は 1 つのみです。複数の ASIN を扱う場合は、個別に呼び出してください。

API の使用方法

米国を含む 15 のすべてのマーケットプレイスで、単一の統合エンドポイントを使用します。

• scripts/amazon_reviews.py を呼び出し、domainCode: "<code>" を渡します。Amazon.com の場合は domainCode: "com" を使用してください。references/api.md を参照してください。

パラメーターガイド

パラメーター	型	必須	対象範囲	説明	デフォルト
asin	string	はい	すべて	Amazon 商品 ASIN	-
star1Num	integer	いいえ	メインエンドポイント	取得する 1 つ星レビュー数（0〜100）	10
star2Num	integer	いいえ	メインエンドポイント	取得する 2 つ星レビュー数（0〜100）	10
star3Num	integer	いいえ	メインエンドポイント	取得する 3 つ星レビュー数（0〜100）	10
star4Num	integer	いいえ	メインエンドポイント	取得する 4 つ星レビュー数（0〜100）	10
star5Num	integer	いいえ	メインエンドポイント	取得する 5 つ星レビュー数（0〜100）	10
sortBy	string	いいえ	すべて	recent（新しい順）または helpful（役立ち度順）	recent
formatType	string	いいえ	すべて	current_format または all_formats	current_format
domainCode	string	いいえ	メインエンドポイント	マーケットプレイスコード（対応マーケットプレイスを参照）。米国では com を使用	com
filterByKeyword	string	いいえ	メインエンドポイント	キーワードでレビューを絞り込み（最大 1000 文字）	-
reviewerType	string	いいえ	メインエンドポイント	all_reviews または avp_only_reviews（認証済みのみ）	all_reviews
mediaType	string	いいえ	メインエンドポイント	all_contents または media_reviews_only	all_contents

星評価数のデフォルト値

• 星評価数のフィールドが指定されていない場合、star1Num から star5Num はすべてデフォルトで 10 になります。
• 星評価数のフィールドが 1 つでも指定されている場合、指定されていない星評価数はデフォルトで 0 になります。

対応マーケットプレイス

マーケットプレイス	コード
米国	com
カナダ	ca
英国	co.uk
ドイツ	de
フランス	fr
イタリア	it
スペイン	es
日本	co.jp
インド	in
オーストラリア	com.au
ブラジル	com.br
メキシコ	com.mx
オランダ	nl
スウェーデン	se
アラブ首長国連邦	ae

対応するすべてのマーケットプレイスで domainCode を使用してください。必ずユーザーが希望するマーケットプレイスを確認してください。

使用例

1. 米国のレビューを取得（Amazon.com）

{"asin": "B08N5WRWNW", "domainCode": "com", "star1Num": 10, "star2Num": 10, "star3Num": 10, "star4Num": 10, "star5Num": 10, "sortBy": "recent"}

2. キーワードで絞り込んで低評価レビューを取得（ドイツ）

{"asin": "B08N5WRWNW", "domainCode": "de", "star1Num": 30, "star2Num": 30, "filterByKeyword": "quality", "reviewerType": "avp_only_reviews"}

3. メディア付きの 5 つ星レビューを取得（日本）

{"asin": "B08N5WRWNW", "domainCode": "co.jp", "star5Num": 50, "star1Num": 0, "star2Num": 0, "star3Num": 0, "star4Num": 0, "sortBy": "helpful", "mediaType": "media_reviews_only"}

4. 3 つ星レビューのみを取得（星評価を明示的に指定）

{"asin": "B0FP5C63HZ", "domainCode": "com", "star3Num": 100}

表示ルール

1. データを明確に提示する：レビューを星評価ごとにまとめ、評価、タイトル、本文、日付、認証済みステータス、役立ち度の件数などの主要な項目を表示します。
2. 適宜要約する：レビューが多い場合は、個々のレビューを列挙する前に、テーマや課題点を要約します。
3. 実行可能なインサイトを強調する：低評価レビューで繰り返し寄せられている不満を挙げ、高評価レビューで称賛されている機能にも触れます。
4. Vine と認証済みのラベルを示す：Vine Voice と認証済み購入のステータスを明確に示します。
5. メディアの有無を示す：レビューに画像や動画が含まれている場合は、その旨を示します。
6. レスポンスを正規化する：生のレスポンスでマーケットプレイス固有のテキスト形式が使われている場合は、評価と役立ち度の件数のフィールドを一貫した形式に正規化します。
7. エラー処理：クエリが失敗した場合は、レスポンスメッセージに基づいて理由を説明し、パラメーターの調整を提案します。
8. ASIN は 1 つのみ指定可能：ユーザーが複数の ASIN について尋ねた場合は、それぞれ個別にリクエストします。

重要な制限事項

• リクエストごとに1つのASIN：一度に照会できるASINは1つだけです。
• 星評価ごとの上限：星評価ごとに、1リクエストで最大100件のレビューが返されます。
• パラメーターの適用範囲：filterByKeyword、reviewerType、mediaType は、domainCode: "com" を含め、/amazon/reviews/list で使用できます。
• 過去のスナップショットなし：レビューはリアルタイムで取得されます。
• レビュー本文の言語：レビューは投稿時の原文で返されます。

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

該当する — Amazon の商品レビューに関するタスク：

ユーザーの発言	シナリオ
「このASINのレビューを見せて」	直接的なレビュー検索
「B08N5WRWNW の米国レビューを取得して」	マーケットプレイスを指定した検索
「顧客が不満に思っている点は？」	否定的なレビューの分析
「星1つのレビューをすべて取得して」	星評価で絞り込んだ取得
「低評価のレビューに共通する問題はある？」	ペインポイントの抽出
「この商品はどんな点が好評？」	肯定的なレビューの分析
「『battery』に言及しているレビューを探して」	キーワードで絞り込んだレビュー
「写真付きのレビューを見せて」	メディアで絞り込んだレビュー
「購入確認済みのレビューのみ」	レビュアーの種類による絞り込み
「競合他社のレビュー分析を手伝って」	競合レビューの調査
「レビューから商品改善の提案を出して」	実行可能なインサイトの抽出

該当しない — 商品レビューのデータを超える内容が必要な場合：

• ABA の検索語データ／キーワード調査（代わりに ABA Data Explorer を使用してください）
• 売上推定または収益分析
• 出品コピーの作成またはA+コンテンツの制作
• 広告／PPC 戦略
• 価格戦略または利益率の計算

適用範囲の判断：「商品調査」や「競合分析」が特定のASINの顧客レビューを読むことにとどまる場合、このスキルが該当します。検索ボリューム、キーワードランキング、売上推定、市場規模の推定に関わる場合は該当しません。

フィードバック：

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

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

リファレンスの指定に従ってフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

大きなレスポンスの処理

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

python scripts/response_io.py run --script scripts/amazon_reviews.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、価格情報、認証関連の機密データが含まれる場合があります。コミットしないでください。ファイルは自動削除されないため、タスクが完了したら削除してください。

このスキルが公開するエントリースクリプトは1つです：amazon_reviews.py。

run は完全なレスポンスをファイルに書き込み、スキーマのプレビューとファイルパスのみを出力します。read は指定したフィールドを抽出し、出力の分割には --limit/--offset、形式の指定には --format json|jsonl|csv|table を使用します。

このパターンを優先する場合 — 次のようなレスポンスの特徴に応じて判断してください：

• レコードあたりのフィールド数が多い、または不要なフィールドが含まれる
• バッチ／ページネーションされた結果（1回の呼び出しで複数の項目を取得）
• 長文のフィールド（説明、レビュー、HTML、時系列データ）
• すぐに消費せず、後続の手順でも出力を再利用する

小規模で一度だけ使用するレスポンスの場合は、メインスクリプトを直接呼び出してもかまいません。

⚠️ プレビューは、スキーマとサンプルを省略したものです。完全なデータではありません。フィールド単位の判断を行う場合は、保存されたファイルを read で読み取ってください。

---

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