Amazon Product Search Automation Skill

"Since you haven't configured the BrowserAct API Key, please visit the BrowserAct Console to get your Key."

🛠️ Input Parameters

When calling the script, the Agent should flexibly configure the following parameters based on user needs:

1. KeyWords (Search Keywords)

   • Type: string
   • Description: The keywords the user wants to search for on Amazon.
   • Example: phone, wireless earbuds, laptop stand

2. Brand (Brand Filter)

   • Type: string
   • Description: Filter products by brand name shown in the listing.
   • Example: Apple, Samsung, Sony

3. Maximum_date (Maximum Products)

   • Type: number
   • Description: The maximum number of products to extract across paginated search results.
   • Default: 50

4. language (UI Language)

   • Type: string
   • Description: UI language for the Amazon browsing session.
   • Options: en, de, fr, it, es, ja, zh-CN, zh-TW
   • Default: en

🚀 Usage

The Agent should execute the following independent script to achieve "one-line command result":

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

⏳ Execution Monitoring

Since this task involves automated browser operations, it may take some time (several minutes). The script will continuously output status logs with timestamps (e.g., [14:30:05] Task Status: running). Agent Instructions:

• While waiting for the script result, keep monitoring the terminal output.
• As long as the terminal is outputting new status logs, the task is running normally; do not mistake it for a deadlock or unresponsiveness.
• Only if the status remains unchanged for a long time or the script stops outputting without returning a result should you consider triggering the retry mechanism.

📊 Data Output

After successful execution, the script will parse and print results directly from the API response. Results include:

• product_title: Product name
• product_url: Detail page URL
• rating_score: Average star rating
• review_count: Total number of reviews
• monthly_sales: Estimated monthly sales (if available)
• current_price: Current selling price
• list_price: Original list price (if available)
• delivery_info: Delivery or fulfillment information
• shipping_location: Shipping origin or location
• is_best_seller: Whether marked as Best Seller
• is_available: Whether available for purchase

⚠️ Error Handling & Retry

If an error occurs during script execution (e.g., network fluctuations or task failure), the Agent should follow this logic:

1. Check Output Content:

   • If the output contains "Invalid authorization", it means the API Key is invalid or expired. Do not retry; guide the user to re-check and provide the correct API Key.
   • If the output does not contain "Invalid authorization" but the task failed (e.g., output starts with Error: or returns empty results), the Agent should automatically try to re-execute the script once.

2. Retry Limit:

   • Automatic retry is limited to one time. If the second attempt fails, stop retrying and report the specific error information to the user.

🌟 Typical Use Cases

1. Market Research: Search for "wireless earbuds" from "Sony" to analyze the current market.
2. Competitive Monitoring: Track "Samsung" phone prices and availability on Amazon.
3. Catalog Discovery: Gather product titles and URLs for a new product catalog in the "laptop stand" category.
4. Localized Analysis: Search Amazon in "ja" (Japanese) to understand products available in the Japan region.
5. Best Seller Tracking: Identify products marked as "Best Seller" for a specific brand.
6. Pricing Intelligence: Compare current_price and list_price to monitor discounts.
7. Sales Trend Estimation: Use monthly_sales data to estimate market demand for certain items.
8. Shipping Efficiency Study: Analyze delivery_info and shipping_location for various brands.
9. Large-scale Data Extraction: Collect up to 100 products for a comprehensive dataset.
10. Product Availability Check: Verify if specific brand products are currently is_available for purchase.