Amazon Product Search Skill

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

🛠️ Input Parameters

The agent should configure the following parameters based on user requirements:

1. KeyWords

   • Type: string
   • Description: Search keywords used to find products on Amazon.
   • Required: Yes
   • Example: laptop, wireless earbuds

2. Brand

   • Type: string
   • Description: Filter products by brand name.
   • Default: Apple
   • Example: Dell, Samsung

3. Maximum_number_of_page_turns

   • Type: number
   • Description: Number of search result pages to paginate through.
   • Default: 1

4. language

   • Type: string
   • Description: UI language for the Amazon browsing session.
   • Default: en
   • Example: zh-CN, de

🚀 Usage

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

# Example Usage
python -u ./scripts/amazon_product_api.py "keywords" "brand" pages "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

Upon success, the script parses and prints the structured product data from the API response, which includes:

• product_title: Full title of the product.
• asin: Amazon Standard Identification Number.
• product_url: URL of the Amazon product page.
• brand: Brand name.
• price_current_amount: Current price.
• price_original_amount: Original price (if applicable).
• rating_average: Average star rating.
• rating_count: Total number of ratings.
• featured: Badges like "Best Seller" or "Amazon's Choice".
• color, material, style: Product attributes (if available).

⚠️ 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 a specific product category to analyze top brands and pricing.
2. Competitor Monitoring: Track product listings and price changes for specific competitor brands.
3. Product Catalog Enrichment: Extract structured details like ASINs and specifications to build or update a product database.
4. Rating Analysis: Find high-rated products for specific keywords to identify market leaders.
5. Localized Research: Search Amazon in different languages to analyze international markets.
6. Price Tracking: Monitor current and original prices to identify discount trends.
7. Brand Performance: Evaluate the presence of a specific brand in search results across multiple pages.
8. Attribute Extraction: Gather technical specifications like material or color for a list of products.
9. Lead Generation: Identify popular products and their manufacturers for business outreach.
10. Automated Data Feed: Periodically pull Amazon search results into external BI tools or dashboards.