amazon-best-selling-products-finder-api-skill

Name: amazon-best-selling-products-finder-api-skill
Author: browser-act

21installs220forks

How to install amazon-best-selling-products-finder-api-skill?

browser-act/skills/amazon-best-selling-products-finder-api-skill

$npx -y skills add browser-act/skills --skill amazon-best-selling-products-finder-api-skill

Installs into the current project.

Summary

--- name: amazon-best-selling-products-finder-api-skill description: "This skill helps users extract structured best-selling product data from Amazon via the BrowserAct API. Agent should proactively apply this skill when users express needs like search for best selling products

Files · 1

View on GitHub

SKILL.md

1	# Amazon Best Selling Products Finder API Skill
2
3	## 📖 Skill Introduction
4	This skill provides users with a one-stop product data extraction service using the BrowserAct Amazon Best Selling Products Finder API template. It can directly extract structured best-selling product data from Amazon. By inputting search keywords, data limit, and marketplace URL, you can easily get clean and usable product data including titles, prices, ratings, reviews, sales volume, and promotional details.
5
6	## ✨ Features
7	1. No hallucinations, ensuring stable and precise data extraction: Preset workflows avoid AI generative hallucinations.
8	2. No CAPTCHA issues: No need to handle reCAPTCHA or other verification challenges.
9	3. No IP access restrictions and geofencing: No need to handle regional IP restrictions.
10	4. More agile execution speed: Compared to pure AI-driven browser automation solutions, task execution is faster.
11	5. Extremely high cost-effectiveness: Significantly reduces data acquisition costs compared to AI solutions that consume a large number of Tokens.
12
13	## 🔑 API Key Guide Flow
14	Before running, first check the `BROWSERACT_API_KEY` environment variable. If it is not set, do not take other actions; require and wait for the user to collaborate to provide it.
15	The Agent must inform the user at this time:
16	> "Since you have not configured the BrowserAct API Key yet, please go to the [BrowserAct Console](https://www.browseract.com/reception/integrations) to get your Key."
17
18	## 🛠️ Input Parameters
19	When calling the script, the Agent should flexibly configure the following parameters based on user needs:
20
21	1. KeyWords
22	- Type: `string`
23	- Description: Search keywords used to find Amazon products.
24	- Example: `iphone 17 pro max`, `gaming mouse`, `running shoes`
25
26	2. Date_limit
27	- Type: `number`
28	- Description: Maximum number of products to extract.
29	- Default: `10`
30	- Recommendation: Set to a lower number for quick checks, or higher for comprehensive analysis.
31
32	3. Marketplace_url
33	- Type: `string`
34	- Description: Amazon marketplace URL for region-specific searches.
35	- Default: `https://www.amazon.com`
36	- Example: `https://www.amazon.co.uk`, `https://www.amazon.de`
37
38	## 🚀 Call Method (Recommended)
39	The Agent should execute the following standalone script to achieve "one command to get results":
40
41	```bash
42	# Call example
43	python -u ./scripts/amazon_best_selling_products_finder_api.py "search keywords" limit "marketplace_url"
44	```
45
46	### ⏳ Running Status Monitoring
47	Since this task involves automated browser operations, it may take a long time (several minutes). The script will continuously output status logs with timestamps (e.g. `[14:30:05] Task Status: running`) during execution.
48	Agent notice:
49	- While waiting for the script to return the result, please keep an eye on the terminal output.
50	- As long as the terminal is still outputting new status logs, it means the task is running normally. Please do not mistakenly judge it as a deadlock or unresponsive.
51	- If the status remains unchanged for a long time or the script stops outputting and no result is returned, the retry mechanism can be triggered.
52
53	## 📊 Data Output Description
54	After successful execution, the script will parse and print the result directly from the API response. The result contains:
55	- `title`: Product title
56	- `brand`: Brand name
57	- `list_price`: Original list price
58	- `current_price`: Current selling price
59	- `star_rating`: Average star rating
60	- `review_count`: Total review count
61	- `past_month_sales`: Sales volume in the past month
62	- `availability`: Stock status
63	- `promotion`: Promotional offers
64	- `asin`: Amazon Standard Identification Number
65	- `category`: Product category
66	- `badge`: Badges like Amazon's Choice
67	- `product_url`: Direct link to the product
68
69	## ⚠️ Error Handling & Retry Mechanism
70	During the execution of the script, if an error occurs (such as network fluctuation or task failure), the Agent should follow this logic:
71
72	1. **Check the ou

People who liked this also viewed

6 picks

Type

amazon-best-selling-products-finder-api-skill

21installs220forks

View on GitHub

How to install amazon-best-selling-products-finder-api-skill?

browser-act/skills/amazon-best-selling-products-finder-api-skill

$npx -y skills add browser-act/skills --skill amazon-best-selling-products-finder-api-skill

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Amazon Best Selling Products Finder API Skill
2
3	## 📖 Skill Introduction
4	This skill provides users with a one-stop product data extraction service using the BrowserAct Amazon Best Selling Products Finder API template. It can directly extract structured best-selling product data from Amazon. By inputting search keywords, data limit, and marketplace URL, you can easily get clean and usable product data including titles, prices, ratings, reviews, sales volume, and promotional details.
5
6	## ✨ Features
7	1. No hallucinations, ensuring stable and precise data extraction: Preset workflows avoid AI generative hallucinations.
8	2. No CAPTCHA issues: No need to handle reCAPTCHA or other verification challenges.
9	3. No IP access restrictions and geofencing: No need to handle regional IP restrictions.
10	4. More agile execution speed: Compared to pure AI-driven browser automation solutions, task execution is faster.
11	5. Extremely high cost-effectiveness: Significantly reduces data acquisition costs compared to AI solutions that consume a large number of Tokens.
12
13	## 🔑 API Key Guide Flow
14	Before running, first check the `BROWSERACT_API_KEY` environment variable. If it is not set, do not take other actions; require and wait for the user to collaborate to provide it.
15	The Agent must inform the user at this time:
16	> "Since you have not configured the BrowserAct API Key yet, please go to the [BrowserAct Console](https://www.browseract.com/reception/integrations) to get your Key."
17
18	## 🛠️ Input Parameters
19	When calling the script, the Agent should flexibly configure the following parameters based on user needs:
20
21	1. KeyWords
22	- Type: `string`
23	- Description: Search keywords used to find Amazon products.
24	- Example: `iphone 17 pro max`, `gaming mouse`, `running shoes`
25
26	2. Date_limit
27	- Type: `number`
28	- Description: Maximum number of products to extract.
29	- Default: `10`
30	- Recommendation: Set to a lower number for quick checks, or higher for comprehensive analysis.
31
32	3. Marketplace_url
33	- Type: `string`
34	- Description: Amazon marketplace URL for region-specific searches.
35	- Default: `https://www.amazon.com`
36	- Example: `https://www.amazon.co.uk`, `https://www.amazon.de`
37
38	## 🚀 Call Method (Recommended)
39	The Agent should execute the following standalone script to achieve "one command to get results":
40
41	```bash
42	# Call example
43	python -u ./scripts/amazon_best_selling_products_finder_api.py "search keywords" limit "marketplace_url"
44	```
45
46	### ⏳ Running Status Monitoring
47	Since this task involves automated browser operations, it may take a long time (several minutes). The script will continuously output status logs with timestamps (e.g. `[14:30:05] Task Status: running`) during execution.
48	Agent notice:
49	- While waiting for the script to return the result, please keep an eye on the terminal output.
50	- As long as the terminal is still outputting new status logs, it means the task is running normally. Please do not mistakenly judge it as a deadlock or unresponsive.
51	- If the status remains unchanged for a long time or the script stops outputting and no result is returned, the retry mechanism can be triggered.
52
53	## 📊 Data Output Description
54	After successful execution, the script will parse and print the result directly from the API response. The result contains:
55	- `title`: Product title
56	- `brand`: Brand name
57	- `list_price`: Original list price
58	- `current_price`: Current selling price
59	- `star_rating`: Average star rating
60	- `review_count`: Total review count
61	- `past_month_sales`: Sales volume in the past month
62	- `availability`: Stock status
63	- `promotion`: Promotional offers
64	- `asin`: Amazon Standard Identification Number
65	- `category`: Product category
66	- `badge`: Badges like Amazon's Choice
67	- `product_url`: Direct link to the product
68
69	## ⚠️ Error Handling & Retry Mechanism
70	During the execution of the script, if an error occurs (such as network fluctuation or task failure), the Agent should follow this logic:
71
72	1. **Check the ou

People who liked this also viewed

6 picks

Type