ecommerce-listing

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:

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

Parameters:

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

Output example:

{
  "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:

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

Output example:

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