amazon-product-api-skill

Amazon Product Search Skill

📖 概要

このスキルは、BrowserAct の Amazon Product API テンプレートを利用して、Amazon の検索結果から商品リストを構造化データとして抽出します。タイトル、ASIN、価格、評価、商品仕様などの詳細情報を提供するため、手作業でデータを収集することなく、市場調査や商品モニタリングを効率的に行えます。

✨ 特長

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

🔑 API キーの設定

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

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

🛠️ 入力パラメーター

エージェントは、ユーザーの要件に基づいて次のパラメーターを設定してください。

1. KeyWords

   • 型：string
   • 説明：Amazon で商品を検索するためのキーワードです。
   • 必須：はい
   • 例：laptop、wireless earbuds

2. Brand

   • 型：string
   • 説明：ブランド名で商品を絞り込みます。
   • デフォルト：Apple
   • 例：Dell、Samsung

3. Maximum_number_of_page_turns

   • 型：number
   • 説明：ページ送りする検索結果ページの数です。
   • デフォルト：1

4. language

   • 型：string
   • 説明：Amazon のブラウジングセッションで使用する UI 言語です。
   • デフォルト：en
   • 例：zh-CN、de

🚀 使用方法

エージェントは、以下の独立したスクリプトを使用して「1 行コマンドで結果を取得」してください。

# Example Usage
python -u ./scripts/amazon_product_api.py "keywords" "brand" pages "language"

⏳ 実行状況のモニタリング

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

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

📊 データ出力

成功すると、スクリプトは API レスポンスから構造化された商品データを解析して出力します。データには次の項目が含まれます。

• product_title：商品の正式なタイトル。
• asin：Amazon Standard Identification Number。
• product_url：Amazon の商品ページの URL。
• brand：ブランド名。
• price_current_amount：現在の価格。
• price_original_amount：元の価格（該当する場合）。
• rating_average：平均星評価。
• rating_count：評価の合計数。
• featured：「Best Seller」や「Amazon's Choice」などのバッジ。
• color、material、style：商品の属性（取得できる場合）。

⚠️ エラー処理と再試行

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

1. 出力内容の確認：

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

2. 再試行の上限：

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

🌟 代表的なユースケース

1. 市場調査：特定の商品カテゴリーを検索し、主要ブランドと価格を分析します。
2. 競合他社のモニタリング：特定の競合ブランドの商品掲載状況と価格の変化を追跡します。
3. 商品カタログの拡充：ASINや仕様などの構造化された詳細情報を抽出し、商品データベースの構築や更新に活用します。
4. 評価分析：特定のキーワードで評価の高い商品を探し、市場をリードする商品を特定します。
5. 地域別調査：異なる言語のAmazonを検索し、国際市場を分析します。
6. 価格追跡：現在価格と通常価格をモニタリングし、割引の傾向を特定します。
7. ブランドの実績分析：複数のページにわたる検索結果で、特定ブランドの表示状況を評価します。
8. 属性の抽出：商品リストから素材や色などの技術仕様を収集します。
9. 見込み顧客の獲得：人気商品とそのメーカーを特定し、ビジネスの営業活動に活用します。
10. データフィードの自動化：Amazonの検索結果を定期的に外部のBIツールやダッシュボードに取り込みます。