Agent skill

Amazon Best Sellers Finder

by browser-act in browser-act/skills

Extracts structured Amazon product data for a keyword and marketplace through the BrowserAct API, including titles, prices, ratings, reviews, sales volume and promotions.

MITAuto-check passedData & Analytics

Install Amazon Best Sellers Finder

skills CLI
$ npx skills add browser-act/skills --skill amazon-best-selling-products-finder-api-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install browser-act/skills amazon-best-selling-products-finder-api-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/browser-act/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/solutions/ecommerce/amazon-best-selling-products-finder-api-skill .claude/skills/amazon-best-selling-products-finder-api-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
amazon-best-selling-products-finder-api-skill
GitHub stars
6.1k
Used in
1 other repo
Token cost
~1.5k tokens
SKILL.md length
691 words
Files
2 (incl. scripts)
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

Extracts structured Amazon product data for a keyword and marketplace through the BrowserAct API, including titles, prices, ratings, reviews, sales volume and promotions.

  • Works in 5 steps: No hallucinations, ensuring stable and… → No CAPTCHA issues: No need to handle… → No IP access restrictions and… → …
  • Pulling the top Amazon results for a keyword as structured data
  • SKILL.md covers 📖 Skill Introduction, ✨ Features, 🔑 API Key Guide Flow and 🛠️ Input Parameters, plus 4 more sections
  • Runs Python scripts from its folder; calls python; reaches amazon.com and amazon.co.uk; needs BROWSERACT_API_KEY

What it does

The skill calls a preset BrowserAct template through the script `scripts/amazon_best_selling_products_finder_api.py` instead of driving a browser with an AI model, which the author presents as faster and cheaper. It takes three inputs: search keywords, a limit on how many products to return, which defaults to 10, and a marketplace URL that defaults to amazon.com and can point to regional stores such as amazon.co.uk or amazon.de.

Before anything runs, the agent checks the `BROWSERACT_API_KEY` environment variable. If it is missing, the agent stops, tells you to get a key from the BrowserAct console, and waits. The output is clean structured data meant for market research, competitor price and sales monitoring, and finding trending products in a region.

When your agent uses it

  • Pulling the top Amazon results for a keyword as structured data
  • Comparing prices and ratings of competing products across regional marketplaces
  • Gathering sales volume and promotion details for market research

Example prompts

  • “Find the best-selling gaming mouse products on Amazon and list price, rating and review count.”
  • “Search amazon.de for running shoes and return the top 25 with their promotions.”
  • “Collect Amazon data on iPhone cases so I can compare competitor prices.”

Requirements

  • A BrowserAct API key in the BROWSERACT_API_KEY environment variable
  • Python to run the bundled script

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. No hallucinations, ensuring stable and precise data extraction: Preset workflows avoid AI generative hallucinations.
  2. No CAPTCHA issues: No need to handle reCAPTCHA or other verification challenges.
  3. No IP access restrictions and geofencing: No need to handle regional IP restrictions.
  4. More agile execution speed: Compared to pure AI-driven browser automation solutions, task execution is faster.
  5. Extremely high cost-effectiveness: Significantly reduces data acquisition costs compared to AI solutions that consume a large number of…

What it can do on your machine

Read from SKILL.md and the folder at commit 11c057b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • amazon.com
    • amazon.co.uk
    • amazon.de

    Also links to:

    • browseract.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • BROWSERACT_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Amazon Best Sellers Finder loads about 1.5k tokens when it runs. Until then it costs about 185 tokens; SKILL.md has 691 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~185
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from browser-act/skills at commit 11c057b, republished under its MIT licence (© browser-act). 691 words, ~1,526 tokens.

Download SKILL.mdSave it as .claude/skills/amazon-best-selling-products-finder-api-skill/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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 on Amazon, extract Amazon product data based on keywords, find top rated Amazon products, monitor Amazon competitor prices and sales, discover trending products on Amazon marketplace, extract Amazon product titles prices and ratings, gather Amazon product sales volume for market research, search Amazon best sellers in specific region, collect Amazon product reviews and promotion details, analyze Amazon product availability and badges, get Amazon product data for market analysis.

Amazon Best Selling Products Finder API Skill

📖 Skill Introduction

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.

✨ Features

  1. No hallucinations, ensuring stable and precise data extraction: Preset workflows avoid AI generative hallucinations.
  2. No CAPTCHA issues: No need to handle reCAPTCHA or other verification challenges.
  3. No IP access restrictions and geofencing: No need to handle regional IP restrictions.
  4. More agile execution speed: Compared to pure AI-driven browser automation solutions, task execution is faster.
  5. Extremely high cost-effectiveness: Significantly reduces data acquisition costs compared to AI solutions that consume a large number of Tokens.

🔑 API Key Guide Flow

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. The Agent must inform the user at this time:

"Since you have not configured the BrowserAct API Key yet, please go to 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

    • Type: string
    • Description: Search keywords used to find Amazon products.
    • Example: iphone 17 pro max, gaming mouse, running shoes
  2. Date_limit

    • Type: number
    • Description: Maximum number of products to extract.
    • Default: 10
    • Recommendation: Set to a lower number for quick checks, or higher for comprehensive analysis.
  3. Marketplace_url

    • Type: string
    • Description: Amazon marketplace URL for region-specific searches.
    • Default: https://www.amazon.com
    • Example: https://www.amazon.co.uk, https://www.amazon.de

The Agent should execute the following standalone script to achieve "one command to get results":

bash
# Call example
python -u ./scripts/amazon_best_selling_products_finder_api.py "search keywords" limit "marketplace_url"
⏳ Running Status Monitoring

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. Agent notice:

  • While waiting for the script to return the result, please keep an eye on the terminal output.
  • 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.
  • 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.
Show full SKILL.md (275 more words)Show less

📊 Data Output Description

After successful execution, the script will parse and print the result directly from the API response. The result contains:

  • title: Product title
  • brand: Brand name
  • list_price: Original list price
  • current_price: Current selling price
  • star_rating: Average star rating
  • review_count: Total review count
  • past_month_sales: Sales volume in the past month
  • availability: Stock status
  • promotion: Promotional offers
  • asin: Amazon Standard Identification Number
  • category: Product category
  • badge: Badges like Amazon's Choice
  • product_url: Direct link to the product

⚠️ Error Handling & Retry Mechanism

During the execution of the script, if an error occurs (such as network fluctuation or task failure), the Agent should follow this logic:

  1. Check the output content:

    • If the output contains "Invalid authorization", it means the API Key is invalid or expired. At this time, do not retry, and guide the user to recheck and provide the correct API Key.
    • If the output does not contain "Invalid authorization" but the task execution fails (for example, the output starts with Error: or the returned result is empty), the Agent should automatically try to execute the script again once.
  2. Retry limit:

    • Automatic retry is limited to once. If the second attempt still fails, stop retrying and report the specific error message to the user.

🌟 Typical Use Cases

  1. Market Research: Extract product listings and ratings to analyze the current market for specific keywords.
  2. Competitor Analysis: Monitor competitor pricing, discounts, and sales volume over time.
  3. Trending Products Discovery: Find the best-selling and highly rated products within a specific category.
  4. Price Monitoring: Track current prices and list prices to optimize purchasing strategies.
  5. Cross-Region Analysis: Compare product availability and pricing across different Amazon marketplaces.

© browser-act, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in solutions/ecommerce/amazon-best-selling-products-finder-api-skill of browser-act/skills.

  • SKILL.md
  • scripts/amazon_best_selling_products_finder_api.py

Open the folder on GitHubat commit 11c057b

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in browser-act/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Amazon Best Sellers Finder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Amazon Best Sellers Finder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Amazon Best Sellers Finder this skillbrowser-act/skills6.1k1 repos~1.5kAutomated safety check: PassMIT
Competitor Comparison Matrixfirecrawl/web-agent1.2k—~1.1kAutomated safety check: PassMIT
LinkfoxagentLeoYeAI/openclaw-master-skills2.2k—~3.8kAutomated safety check: PassMIT
Competitor Analysissocial-media-skills/skills134—~1.3kAutomated safety check: PassMIT
Apify Multi-Platform Scraperapify/agent-skills2.4k2 repos~1.4kAutomated safety check: NotesNone
Apify Ecommercesickn33/agentic-awesome-skills47k2 repos~2.3kAutomated safety check: NotesMIT

Similar skills

  • Competitor Comparison Matrix

    firecrawl/web-agent

    Compares two or more products or companies on pricing, features and positioning by scraping their sites, and returns a normalized JSON matrix.

    1.2k GitHub stars~1.1k tokensUpdated 5 mo ago
    Marketing & SEOAuto-check passed
  • Linkfoxagent

    LeoYeAI/openclaw-master-skills

    Cross-border e-commerce AI Agent with 41 specialized tools for Amazon/TikTok/eBay/Walmart product research, competitor analysis, keyword tracking, review insights, patent detection, trend analysis…

    2.2k GitHub stars~3.8k tokensUpdated 2 mo ago
    Legal & ComplianceAuto-check passed
  • Competitor Analysis

    social-media-skills/skills

    Competitor analysis for social media — public-data competitive reconnaissance to find the gap a brand can own.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Marketing & SEOAuto-check passed
  • Official

    Scrapes public data from social, maps, search and review platforms by choosing from about a hundred Apify Actors and running them through the Apify CLI.

    2.4k GitHub starsUsed in 2 repos~1.4k tokens
    Data & AnalyticsAuto-check: notes
  • Apify Ecommerce

    sickn33/agentic-awesome-skills

    Extract product data, prices, reviews, and seller information from any e-commerce platform using Apify's E-commerce Scraping Tool.

    47k GitHub starsUsed in 2 repos~2.3k tokens
    Sales & SupportAuto-check: notes
  • Extract

    actionbook/actionbook

    Extract structured data from websites and produce an executable Playwright script plus extracted data.

    1.6k GitHub starsUsed in 2 repos~3.4k tokens
    Sales & SupportAuto-check passed

More from browser-act/skills

All 87 skills in this repo
  • Amazon ASIN Lookup

    browser-act/skills

    Fetches structured Amazon product details such as title, price, ratings and availability for a given ASIN through BrowserAct's lookup API template.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Amazon Buy Box Monitor

    browser-act/skills

    Pulls Amazon product details, competing seller prices and seller ratings for a given ASIN through the BrowserAct API, without browser automation.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Analyzes a competitor's Amazon listing by ASIN with BrowserAct data extraction, then reports what it does well, where the market has gaps and opportunity points for your own listing.

    6.1k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Pulls structured Amazon search results (titles, ASINs, prices, ratings, specifications) for a keyword and brand through BrowserAct's Amazon Product API template.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Collects structured product data from Amazon search results for a keyword and optional brand, using a BrowserAct script, for market and competitor research.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Amazon Reviews Extractor

    browser-act/skills

    Pulls structured Amazon product reviews for an ASIN through BrowserAct's Amazon Reviews API, with no Amazon login, using a bundled Python script.

    6.1k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed

Questions about Amazon Best Sellers Finder

What does Amazon Best Sellers Finder do?

Extracts structured Amazon product data for a keyword and marketplace through the BrowserAct API, including titles, prices, ratings, reviews, sales volume and promotions. py` instead of driving a browser with an AI model, which the author presents as faster and cheaper.de.

When should I use Amazon Best Sellers Finder?

Amazon Best Sellers Finder fits situations like: pulling the top Amazon results for a keyword as structured data; comparing prices and ratings of competing products across regional marketplaces; gathering sales volume and promotion details for market research.

How do I install Amazon Best Sellers Finder in Claude Code?

Run `npx skills add browser-act/skills --skill amazon-best-selling-products-finder-api-skill -a claude-code`. Or copy the skill folder (solutions/ecommerce/amazon-best-selling-products-finder-api-skill in browser-act/skills) into .claude/skills/amazon-best-selling-products-finder-api-skill in your project. Claude Code loads it when a task matches its description.

How do I install Amazon Best Sellers Finder in Codex?

Run `npx skills add browser-act/skills --skill amazon-best-selling-products-finder-api-skill -a codex`. Or copy the skill folder (solutions/ecommerce/amazon-best-selling-products-finder-api-skill in browser-act/skills) into .agents/skills/amazon-best-selling-products-finder-api-skill in your project. Codex loads it when a task matches its description.

Can I use Amazon Best Sellers Finder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add browser-act/skills --skill amazon-best-selling-products-finder-api-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/amazon-best-selling-products-finder-api-skill, .gemini/skills/amazon-best-selling-products-finder-api-skill, .github/skills/amazon-best-selling-products-finder-api-skill and .opencode/skills/amazon-best-selling-products-finder-api-skill in your project.

What does Amazon Best Sellers Finder need to run?

Going by SKILL.md and its folder, Amazon Best Sellers Finder needs Python for the scripts in its folder, the command-line tools its instructions call (python) and credentials named BROWSERACT_API_KEY. Our summary lists: A BrowserAct API key in the BROWSERACT_API_KEY environment variable; Python to run the bundled script.

Does Amazon Best Sellers Finder access the network?

SKILL.md names 4 domains. In commands or code: amazon.com, amazon.co.uk and amazon.de; the agent is likely to contact these when it follows the instructions. As links in the text: browseract.com. This is read from the text; nothing was executed.

Is Amazon Best Sellers Finder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Amazon Best Sellers Finder use?

Amazon Best Sellers Finder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Amazon Best Sellers Finder use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Amazon Best Sellers Finder?

Skills that share tags, products or a category with Amazon Best Sellers Finder: Competitor Comparison Matrix (firecrawl/web-agent, 1.2k stars), Linkfoxagent (LeoYeAI/openclaw-master-skills, 2.2k stars), Competitor Analysis (social-media-skills/skills, 134 stars) and Apify Multi-Platform Scraper (apify/agent-skills, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Amazon Best Sellers Finder?

browser-act (a GitHub organization) maintains it in browser-act/skills, which has 6,126 GitHub stars. The repository holds 87 skills in this directory. The repository was last updated on August 24, 2026.

Source: browser-act/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.