amazon-product-search-api-skill

Amazon 商品検索自動化スキル

📖 はじめに

このスキルは、BrowserAct の Amazon 商品検索 API テンプレートを通じて、ワンストップの商品データ収集サービスを提供します。Amazon の検索結果一覧から、構造化された商品情報を直接抽出します。検索キーワード、ブランドフィルター、取得件数の上限を入力するだけで、すぐに使えるクリーンな商品データを取得できます。

✨ 特長

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 で検索するキーワードです。
   • 例：phone、wireless earbuds、laptop stand

2. Brand（ブランドフィルター）

   • 型：string
   • 説明：商品一覧に表示されたブランド名で商品を絞り込みます。
   • 例：Apple、Samsung、Sony

3. Maximum_date（商品数の上限）

   • 型：number
   • 説明：ページ分割された検索結果全体から抽出する商品の最大数です。
   • デフォルト：50

4. language（UI 言語）

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

🚀 使用方法

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

# Example Call
python -u ./scripts/amazon_product_search_api.py "Keywords" "Brand" Quantity "language"

⏳ 実行状況の監視

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

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

📊 データ出力

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

• product_title：商品名
• product_url：詳細ページの URL
• rating_score：平均星評価
• review_count：レビューの合計数
• monthly_sales：推定月間販売数（取得可能な場合）
• current_price：現在の販売価格
• list_price：元の表示価格（取得可能な場合）
• delivery_info：配送またはフルフィルメントに関する情報
• shipping_location：発送元または所在地
• is_best_seller：ベストセラーとして表示されているかどうか
• is_available：購入可能かどうか

⚠️ エラー処理と再試行

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

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

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

2. 再試行の上限：

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

🌟 代表的なユースケース

1. 市場調査：「wireless earbuds」を「Sony」から検索し、現在の市場を分析します。
2. 競合モニタリング：Amazon で「Samsung」の携帯電話の価格と在庫状況を追跡します。
3. カタログの探索：「laptop stand」カテゴリの新しい商品カタログ用に、商品タイトルと URL を収集します。
4. 地域別分析：「ja」（日本語）で Amazon を検索し、日本地域で入手可能な商品を把握します。
5. ベストセラーの追跡：特定のブランドで「Best Seller」の表示が付いた商品を特定します。
6. 価格情報の分析：current_price と list_price を比較して、割引を監視します。
7. 販売動向の推定：monthly_sales データを使って、特定商品の市場需要を推定します。
8. 配送効率の調査：さまざまなブランドの delivery_info と shipping_location を分析します。
9. 大規模なデータ抽出：包括的なデータセットを作成するため、最大 100 件の商品を収集します。
10. 商品の在庫状況の確認：特定ブランドの商品が現在購入可能（is_available）かどうかを確認します。