amazon-reviews-api-skill

Amazon レビュー自動抽出スキル

📖 はじめに

このスキルは、BrowserAct の Amazon Reviews API テンプレートを通じて、Amazon レビューをワンストップで収集できます。Amazon の商品ページから、構造化されたレビュー結果を直接抽出できます。ASIN を指定するだけで、クローラースクリプトを構築したり、Amazon アカウントにログインしたりすることなく、整理された使いやすいレビューデータを取得できます。

✨ 特長

1. ハルシネーションなし：事前設定されたワークフローにより、AI の生成によるハルシネーションを防ぎ、安定した正確なデータ抽出を実現します。
2. CAPTCHA の問題なし：reCAPTCHA やその他の認証チャレンジに対応する必要はありません。
3. IP 制限なし：地域別の IP 制限やジオフェンシングに対応する必要はありません。
4. 高速な実行：純粋な AI 主導のブラウザー自動化ソリューションと比べて、タスクをより高速に実行できます。
5. 低コスト：大量のトークンを消費する AI ソリューションと比べて、データ取得コストを大幅に削減できます。

🔑 API キーの設定

実行前に、BROWSERACT_API_KEY 環境変数を確認してください。設定されていない場合は、ほかの対処をせず、ユーザーに尋ねて提供を待ってください。 エージェントはユーザーに次のように伝えてください：

"BrowserAct API Key が設定されていません。BrowserAct Console にアクセスして Key を取得してください。"

🛠️ 入力パラメーター

スクリプトを呼び出す際、エージェントはユーザーのニーズに応じてパラメーターを柔軟に設定してください。

1. ASIN（Amazon Standard Identification Number）
   • 型：string
   • 説明：Amazon 上の商品を一意に識別する番号です。
   • 例：B07TS6R1SF、B08N5WRWJ6

🚀 使用方法

「ワンラインコマンドで結果を取得」するため、エージェントは次の独立したスクリプトを実行してください。

# Example call
python -u ./scripts/amazon_reviews_api.py "ASIN_HERE"

⏳ 実行状況の監視

このタスクではブラウザー操作を自動化するため、完了までに数分かかることがあります。スクリプトはタイムスタンプ付きのステータスログを継続的に出力します（例：[14:30:05] Task Status: running）。 エージェントへの指示：

• スクリプトの結果を待つ間、ターミナルの出力を監視し続けてください。
• ターミナルに新しいステータスログが出力されている限り、タスクは正常に実行中です。デッドロックや応答なしと誤認しないでください。
• ステータスが長時間変わらない場合、または結果が返されないままスクリプトの出力が止まった場合に限り、再試行を検討してください。

📊 データ出力

正常に実行されると、スクリプトは API レスポンスから結果を解析し、直接出力します。各レビュー項目には次の情報が含まれます：

• Commentator：レビュアーの名前
• Commenter profile link：レビュアーのプロフィールへのリンク
• Rating：星による評価
• reviewTitle：レビューの見出し
• review Description：レビュー本文
• Published at：レビューの公開日
• Country：レビュアーの国
• Variant：商品のバリエーション情報（利用可能な場合）
• Is Verified：購入済み商品の認証状況

⚠️ エラー処理と再試行

スクリプトの実行中にエラーが発生した場合（ネットワークの不安定さやタスクの失敗など）、エージェントは次の手順に従ってください：

1. 出力内容を確認する：

   • 出力に "Invalid authorization" が含まれている場合、API Key が無効または期限切れです。再試行しないでください。API Key を再確認し、正しいものを提供するようユーザーに案内してください。
   • 出力に "Invalid authorization" が含まれていないにもかかわらずタスクが失敗した場合（例：出力が Error: で始まる、または結果が空の場合）、エージェントはスクリプトを自動で一度再実行してください。

2. 再試行の上限：

   • 自動再試行は1 回までです。2 回目の実行にも失敗した場合は、再試行を停止し、具体的なエラー情報をユーザーに報告してください。

🌟 典型的なユースケース

1. 競合分析：競合製品のレビューを抽出し、強みと弱みを把握します。
2. 製品フィードバック：自社製品へのフィードバックを要約し、改善すべき点を特定します。
3. 市場調査：特定のカテゴリにおける顧客の好みやよくある不満に関するデータを収集します。
4. 感情モニタリング：最近のレビューを監視し、顧客感情の変化を検出します。
5. 品質保証の知見：顧客レビューを活用して、潜在的な品質問題やバグを特定します。
6. 感情分析の準備：詳細な感情モデリングに向けて、レビューの本文と評価を収集します。
7. 購入認証済みレビューの分析：購入認証済みの購入者と未認証の購入者からのフィードバックを比較します。
8. 地域別の知見：レビュアーの国ごとに製品のパフォーマンスを分析します。
9. バリエーションの比較：どの製品バリエーション（サイズ／色）が最も高い評価を得ているかを把握します。
10. 過去の傾向の追跡：レビューの投稿日を取得して分析し、製品ライフサイクルにおける感情の変化を追跡します。