Agent skill

Ecommerce Listing

by browser-act in browser-act/skills

Extract product list from any e-commerce category page, search results page, or keyword search with filters.

MITAuto-check passedSales & Support

Install Ecommerce Listing

skills CLI
$ npx skills add browser-act/skills --skill ecommerce-listing -a claude-code

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

GitHub CLI
$ gh skill install browser-act/skills ecommerce-listing --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/ecommerce-listing .claude/skills/ecommerce-listing && 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
ecommerce-listing
GitHub stars
6.1k
Token cost
~1.7k tokens
SKILL.md length
599 words
Files
3 (incl. scripts)
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

Extract product list from any e-commerce category page, search results page, or keyword search with filters.

  • Works in 2 steps: navigate {constructed_url} → wait stable → eval "$(python…
  • : category listing
  • SKILL.md covers Language, Objective, Prerequisites and Pre-execution Checks, plus 6 more sections
  • Runs Python scripts from its folder; calls python; reaches amazon.com and ebay.com

What it does

Ecommerce Listing is an agent skill from browser-act/skills. Extract product list from any e-commerce category page, search results page, or keyword search with filters. Returns paginated product arrays with URL, name, price, currency, image, rating, review count per item. Supports URL input, keyword search, and site-scoped search with filters: price range, brand, category, minimum rating, in-stock only, and sort order. Works on Amazon, eBay, Walmart, Shopify collections, WooCommerce shops, Google Shopping, and any public product listing page. Use when: category listing…

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/extract-listing-next-page.py` and `scripts/extract-listing.py`).

It sits in Sales & Support, covering E-commerce operations and Web scraping. It works with Shopify and WooCommerce. The repository describes itself as: Browser automation CLI built for AI agents. Break through anti-bot walls, hand off to humans across platforms when stuck. Parallel multi-task execution, independent multi-session… The licence is MIT.

When your agent uses it

  • : category listing
  • Product search results
  • Ecommerce search
  • Search for products

Example prompts

  • “/ecommerce-listing”

Requirements

  • Python 3

Workflow steps

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

  1. navigate {constructed_url} → wait stable
  2. eval "$(python scripts/extract-listing.py --max-results {n})"

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 2 files 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
    • ebay.com
    • m.media-amazon.com
    • walmart.com
    • google.com

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Ecommerce Listing loads about 1.7k tokens when it runs. Until then it costs about 229 tokens; SKILL.md has 599 words of instructions outside code blocks.

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

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). 599 words, ~1,736 tokens.

Download SKILL.mdSave it as .claude/skills/ecommerce-listing/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
ecommerce-listing
description
Extract product list from any e-commerce category page, search results page, or keyword search with filters. Returns paginated product arrays with URL, name, price, currency, image, rating, review count per item. Supports URL input, keyword search, and site-scoped search with filters: price range, brand, category, minimum rating, in-stock only, and sort order. Works on Amazon, eBay, Walmart, Shopify collections, WooCommerce shops, Google Shopping, and any public product listing page. Use when: category listing, product search results, ecommerce search, search for products, filter products by price, list products from a site, price range filter, brand filter, keyword search with filters, scrape product list, product catalog extraction, get all products from category, bulk product URLs, product list scraping, category page scraper, search results scraper, multi-page product extraction.

E-commerce — Product Listing

Category/search URL or keyword + filters → paginated product list (URL, name, price, image, rating per item)

Language

All process output to user (progress updates, process notifications) follows the user's language.

Objective

Extract a structured list of products from any e-commerce category, search results, or keyword search page, with support for price/brand/rating filters and multi-page pagination.

Prerequisites

  • Target browser is open and connected
  • No login required for public listing pages

Pre-execution Checks

1. Tool Readiness

If browser-act has been confirmed available in the current session → skip this step.

Invoke browser-act via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.

Capability Components

This Skill's operational boundary = what the user can manually do in their browser. It only reads data already displayed to the user on the page. JS code is encapsulated in Python files under the scripts/ directory, invoked via eval "$(python scripts/xxx.py {params})". Use the bash tool for execution.

DOM: Extract product list from current page

Navigate to the listing/search page first, then extract:

bash
eval "$(python scripts/extract-listing.py --max-results 20)"

Parameters:

  • --max-results: max items to return per page, default 20

Output example:

json
{
  "count": 20,
  "items": [
    {
      "url": "https://www.amazon.com/dp/B09WNK39JN",
      "name": "Amazon Echo Pop",
      "price": 39.99,
      "currency": "USD",
      "image": "https://m.media-amazon.com/images/I/...jpg",
      "rating": 4.7,
      "review_count": 103789,
      "asin": "B09WNK39JN"
    }
  ]
}
DOM: Get next page URL

After extracting a page, get the URL to navigate to for the next page:

bash
eval "$(python scripts/extract-listing-next-page.py)"

Output example:

json
{"next_url": "https://www.amazon.com/s?k=headphones&page=2", "has_next": true, "method": "amazon"}

When has_next is false, pagination is complete.

Composite: Keyword search with filters → product list

Step 1 — Build search URL with filters:

Construct the URL based on target site and desired filters using the patterns below, then navigate:

Amazon (amazon.com):

https://www.amazon.com/s?k={keyword_urlencoded}&s={sort}&rh={filter_params}
  • Sort (s): price-asc-rank | price-desc-rank | review-rank | date-desc-rank (omit for relevance)
  • Price filter: append p_36:{min_cents}-{max_cents} to rh (dollars × 100, e.g. $50–$200 → p_36:5000-20000)
  • Rating filter: append avg_customer_review:four-and-above | three-and-above | two-and-above to rh
  • In-stock: append p_n_availability:1248801011 to rh
  • Multiple rh values: comma-separate (e.g. rh=p_36:5000-20000,avg_customer_review:four-and-above)

eBay (ebay.com):

https://www.ebay.com/sch/i.html?_nkw={keyword_urlencoded}&_udlo={min_price}&_udhi={max_price}&_sop={sort_num}
  • Sort: 12=BestMatch | 15=PriceLow | 16=PriceHigh | 24=NewlyListed

Walmart (walmart.com):

https://www.walmart.com/search?q={keyword_urlencoded}&min_price={min}&max_price={max}&sort={sort}
  • Sort: best_match | price_low | price_high | rating_high

Google Shopping (cross-site, no --site):

https://www.google.com/search?tbm=shop&q={keyword_urlencoded}&tbs=p_ord:{sort}
  • Sort: rv=relevance | pd=price ascending | prd=price descending

Any site with --site (generic):

https://{site}/search?q={keyword_urlencoded}

Step 2 — Navigate and extract:

  1. navigate {constructed_url} → wait stable
  2. eval "$(python scripts/extract-listing.py --max-results {n})"

Step 3 — Paginate (repeat until done):

  1. eval "$(python scripts/extract-listing-next-page.py)"
  2. If has_next is true: navigate {next_url} → wait stable → re-run extract-listing.py
  3. If has_next is false: stop
Show full SKILL.md (240 more words)Show less

Pagination

URL Pagination: extract-listing-next-page.py detects rel=next link, platform-specific pagination controls, and URL page parameters. Returns next_url for navigation.

DOM Pagination: For sites with load-more buttons (some Shopify themes):

  1. state to find "Load more" or "Show more" button
  2. click <index> → wait stable → re-run extract-listing.py
  3. Termination: button no longer present, or item count stops increasing

Success Criteria

result.count >= 1 AND items[0].url != null

Known Limitations

  • Amazon: direct navigation may trigger bot detection on fresh sessions — navigate from https://www.amazon.com first
  • eBay listing pages may require navigating from https://www.ebay.com first
  • Google Shopping results have complex SPA structure and may have reduced accuracy; prefer direct site search when --site is specified
  • Filter URL parameters are site-specific; unsupported filter parameters are silently ignored by some sites
  • Shopify themes vary widely; if the generic DOM strategies miss items, check if the page has JSON-LD ItemList or Product array in page source

Execution Efficiency

  • Batch orchestration: Loop through pages serially within a single session; add 1–2 second intervals between page navigations
  • Test before batch execution: Test with 1 page before running multi-page extraction
  • Error resumption: Record page number; on failure, resume from the last successful page

Experience Notes

Path: {working-directory}/browser-act-skill-forge-memories/ecommerce-scraper-ecommerce-listing.memory.md

Before execution: If the file exists, read it first — it records unexpected situations encountered during past executions; adjust strategy order accordingly.

After execution: If an unexpected situation is encountered (strategy became ineffective, page redesigned, anti-scraping upgraded, better path discovered), append a line: {YYYY-MM-DD}: {what happened} → {conclusion}

© 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 2 other files (scripts) in solutions/ecommerce/ecommerce-listing of browser-act/skills.

  • SKILL.md
  • scripts/extract-listing-next-page.py
  • scripts/extract-listing.py

Open the folder on GitHubat commit 11c057b

Compare with similar skills

Ecommerce Listing 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.

Ecommerce Listing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ecommerce Listing this skillbrowser-act/skills6.1k—~1.7kAutomated safety check: PassMIT
Apify Ecommerceapify/awesome-skills262—~4.6kAutomated safety check: NotesApache-2.0
Ecommerce SEOnowork-studio/notfair-plugin3.9k—~919Automated safety check: PassMIT
Shopifyericrisco/rsc-harness156—~3.2kAutomated safety check: PassMIT
Extractactionbook/actionbook1.6k2 repos~3.4kAutomated safety check: PassApache-2.0
Agentkeychainbase-labs/Agentkey655—~2.3kAutomated safety check: PassMIT

Similar skills

  • Apify Ecommerce

    apify/awesome-skills

    Official

    Scrape e-commerce data for pricing, reviews, bestsellers, and seller discovery across 30+ platforms including Amazon, Walmart, eBay, Shopify, WooCommerce, and more.

    262 GitHub stars~4.6k tokensUpdated 14 days ago
    Sales & SupportAuto-check: notes
  • Ecommerce SEO

    nowork-studio/notfair-plugin

    E-commerce SEO audit for online stores (WooCommerce, Shopify, Magento, custom).

    3.9k GitHub stars~919 tokensUpdated 6 days ago
    Sales & SupportAuto-check passed
  • Shopify

    ericrisco/rsc-harness

    A skill your agent uses when building or customizing a Shopify store across its three code surfaces — themes (Liquid, Online Store 2.0 sections, blocks and JSON templates), apps (Remix with the…

    156 GitHub stars~3.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • 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
  • Agentkey

    chainbase-labs/Agentkey

    PROACTIVELY use whenever the user needs data outside your training set or requires a live network call — web search, URL scraping, news, social media (any platform), market prices…

    655 GitHub stars~2.3k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Checkout Purchase

    keypo-us/keypo-cli

    A skill your agent uses when the user asks to buy a product from the Shopify store.

    182 GitHub stars~880 tokensUpdated 6 mo ago
    Sales & SupportAuto-check: notes

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 2 repos~1.5k tokens
    Auto-check passed
  • Amazon Best Sellers Finder

    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.

    6.1k GitHub starsUsed in 2 repos~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 2 repos~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 2 repos~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 2 repos~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 2 repos~1.6k tokens
    Auto-check passed

Categories

Questions about Ecommerce Listing

What does Ecommerce Listing do?

Extract product list from any e-commerce category page, search results page, or keyword search with filters. Ecommerce Listing is an agent skill from browser-act/skills. Extract product list from any e-commerce category page, search results page, or keyword search with filters.

When should I use Ecommerce Listing?

Ecommerce Listing fits situations like: : category listing; product search results; ecommerce search; search for products.

How do I install Ecommerce Listing in Claude Code?

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

How do I install Ecommerce Listing in Codex?

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

Can I use Ecommerce Listing 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 ecommerce-listing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ecommerce-listing, .gemini/skills/ecommerce-listing, .github/skills/ecommerce-listing and .opencode/skills/ecommerce-listing in your project.

What does Ecommerce Listing need to run?

Going by SKILL.md and its folder, Ecommerce Listing needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Ecommerce Listing access the network?

SKILL.md names 5 domains. In commands or code: amazon.com, ebay.com, m.media-amazon.com, walmart.com and google.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Ecommerce Listing 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 Ecommerce Listing use?

Ecommerce Listing 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 Ecommerce Listing use?

About 1.7k tokens (SKILL.md is roughly 6.9k 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 Ecommerce Listing?

Skills that share tags, products or a category with Ecommerce Listing: Apify Ecommerce (apify/awesome-skills, 262 stars), Ecommerce SEO (nowork-studio/notfair-plugin, 3.9k stars), Shopify (ericrisco/rsc-harness, 156 stars) and Extract (actionbook/actionbook, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ecommerce Listing?

browser-act (a GitHub organization) maintains it in browser-act/skills, which has 6,108 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.