Amazon Product API Skill
This skill allows you to extract structured product data from Amazon search results using a single API request, eliminating the need for complex scrapers or manual data entry.
✨ Features
- One-call integration: Send product results directly into your pricing database, BI dashboards, competitor trackers, or automation workflows via API.
- Zero maintenance: No scraping scripts, proxy setup, or anti-bot handling required.
- Production-ready output: Consistent, structured responses designed for automated processing and monitoring.
- Built for workflows: Perfect for competitive pricing, product research, catalog monitoring, and merchandising insights.
🔑 API Key Setup
This skill requires a BROWSERACT_API_KEY.
Environment Variable Check
The associated script will automatically check for the BROWSERACT_API_KEY environment variable.
How to get an API Key
- Register/Login at BrowserAct.
- Go to the API & Integrations section to get your key.
- Set it in your environment:
$env:BROWSERACT_API_KEY = "your-api-key-here"
📥 Input Parameters
| Parameter |
Type |
Description |
Example |
KeyWords |
string |
Search keywords used to find products on Amazon. |
phone, wireless earbuds |
Brand |
string |
Filter products by brand name. |
Apple, Samsung, Sony |
Maximum_number_of_page_turns |
number |
Number of search result pages to paginate through. |
1, 3 |
language |
string |
UI language for the Amazon browsing session. |
en, de, zh-CN |
🚀 How to Call
You can trigger this skill using the provided Python script:
python -u .cursor/skills/amazon-product-api-skill/scripts/amazon_product_api.py --keywords "laptop" --brand "Dell" --pages 1 --lang "en"
📊 Output Data
The script returns a JSON array of products with the following fields:
product_title: The product name.asin: Amazon Standard Identification Number (unique ID).product_url: The product detail page URL.brand: Brand name.price_current_amount: Current selling price.price_original_amount: Original price (if available).rating_average: Average star rating.rating_count: Total number of ratings.featured: Whether it's a sponsored/featured item.color, material, style: Product attributes (if available).
🛠 Error Handling & Retries
- Invalid Authorization: If the API key is incorrect or expired, the script will catch the "Invalid authorization" error and prompt you to check your configuration.
- Network Issues: The script includes built-in retry logic for common network timeouts.
- Task Failures: If the workflow fails on the server side, the script will report the failure status and any available error details.
1---2name: amazon-product-api-skill3description: Amazon Product API Skill4---56# Amazon Product API Skill78This skill allows you to extract structured product data from Amazon search results using a single API request, eliminating the need for complex scrapers or manual data entry.910## ✨ Features1112- **One-call integration**: Send product results directly into your pricing database, BI dashboards, competitor trackers, or automation workflows via API.13- **Zero maintenance**: No scraping scripts, proxy setup, or anti-bot handling required.14- **Production-ready output**: Consistent, structured responses designed for automated processing and monitoring.15- **Built for workflows**: Perfect for competitive pricing, product research, catalog monitoring, and merchandising insights.1617## 🔑 API Key Setup1819This skill requires a `BROWSERACT_API_KEY`. 2021### Environment Variable Check22The associated script will automatically check for the `BROWSERACT_API_KEY` environment variable.2324### How to get an API Key251. Register/Login at [BrowserAct](https://www.browseract.com/).262. Go to the [API & Integrations](https://www.browseract.com/reception/integrations) section to get your key.273. Set it in your environment:28 ```powershell29 $env:BROWSERACT_API_KEY = "your-api-key-here"30 ```3132## 📥 Input Parameters3334| Parameter | Type | Description | Example |35|-----------|------|-------------|---------|36| `KeyWords` | string | Search keywords used to find products on Amazon. | `phone`, `wireless earbuds` |37| `Brand` | string | Filter products by brand name. | `Apple`, `Samsung`, `Sony` |38| `Maximum_number_of_page_turns` | number | Number of search result pages to paginate through. | `1`, `3` |39| `language` | string | UI language for the Amazon browsing session. | `en`, `de`, `zh-CN` |4041## 🚀 How to Call4243You can trigger this skill using the provided Python script:4445```bash46python -u .cursor/skills/amazon-product-api-skill/scripts/amazon_product_api.py --keywords "laptop" --brand "Dell" --pages 1 --lang "en"47```4849## 📊 Output Data5051The script returns a JSON array of products with the following fields:5253- `product_title`: The product name.54- `asin`: Amazon Standard Identification Number (unique ID).55- `product_url`: The product detail page URL.56- `brand`: Brand name.57- `price_current_amount`: Current selling price.58- `price_original_amount`: Original price (if available).59- `rating_average`: Average star rating.60- `rating_count`: Total number of ratings.61- `featured`: Whether it's a sponsored/featured item.62- `color`, `material`, `style`: Product attributes (if available).6364## 🛠 Error Handling & Retries6566- **Invalid Authorization**: If the API key is incorrect or expired, the script will catch the "Invalid authorization" error and prompt you to check your configuration.67- **Network Issues**: The script includes built-in retry logic for common network timeouts.68- **Task Failures**: If the workflow fails on the server side, the script will report the failure status and any available error details.
johnalbertini14-glitch