amazon-asin-lookup-api-skill

Amazon ASIN 検索スキル

📖 はじめに

このスキルは BrowserAct の Amazon ASIN 検索 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. ASIN（Amazon 標準識別番号）
   • 型：string
   • 説明：Amazon の商品を識別する一意の ID です。
   • 必須：はい
   • 例：B07TS6R1SF

🚀 使用方法

エージェントは、次のスクリプトを実行して、1 つのコマンドで結果を取得してください：

# Example Usage
python -u ./scripts/amazon_asin_lookup_api.py "ASIN_VALUE"

⏳ 実行状況の監視

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

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

📊 データ出力

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

• product_title：商品の正式なタイトル。
• ASIN：指定された ASIN。
• product_url：Amazon 商品ページの URL。
• brand：ブランド名。
• price_current_amount：現在の価格。
• price_original_amount：元の価格（該当する場合）。
• price_discount_amount：割引額（該当する場合）。
• rating_average：平均評価。
• rating_count：評価の合計数。
• featured：「Amazon's Choice」などのバッジ。
• color：カラーのバリエーション（該当する場合）。
• compatible_devices：対応デバイスの一覧（該当する場合）。
• product_description：商品の詳しい説明。
• special_features：主な特徴。
• style：スタイル属性（該当する場合）。
• material：使用素材（該当する場合）。

⚠️ エラー処理と再試行

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

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

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

2. 再試行の上限：

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

🌟 代表的なユースケース

1. 商品データの拡充：ASIN のリストに対応する詳細情報を取得し、E コマースデータベースを更新します。
2. 価格比較：特定の ASIN の現在の Amazon 価格を調べ、他の小売業者の価格と比較します。
3. レビューのモニタリング：主要商品の平均評価やレビュー数の変化を追跡します。
4. 在庫状況の確認：特定の商品が現在 Amazon で在庫切れになっていないか、自動的に確認します。
5. ブランド分析：ASIN で特定される商品のブランドとメーカーを識別します。
6. 詳細な仕様：カタログ管理のために、素材、スタイル、色の情報を取得します。
7. 特徴の強調：マーケティング用の文章に活用するため、「特別な特徴」と詳細な説明を抽出します。
8. 互換性の確認：電子機器やアクセサリーの「対応デバイス」を確認します。
9. 市場調査：特定の商品 ID について、「Amazon's Choice」などの注目バッジを分析します。
10. URL の解決：ASIN のリストを、Amazon の商品ページの完全な URL に変換します。