К основному содержанию
скилл CX Codex

ecommerce-listing — скилл для Claude Code: что делает и как установить

Скилл ecommerce-listing собирает структурированные каталоги товаров с сайтов интернет-магазинов, включая фильтры по ценам, рейтингу и пагинацию.

MIT 1 установок ★ 6 409 обновлён 2026-08-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add browser-act/skills --skill ecommerce-listing -a claude-code
Открыть на GitHub

Что делает ecommerce-listing

Скилл парсит листинги категорий и выдачу поисковых запросов на витринах вроде Amazon, eBay, Walmart, Google Shopping или магазинах на Shopify и WooCommerce. На выходе формируется массив объектов в формате JSON с полями адреса товара, названия, цены, валюты, ссылки на изображение, рейтинга и числа отзывов.

Внутри логика опирается на скрипты Python в каталоге scripts/, которые исполняются через инструмент Bash с вызовом eval "$(python scripts/...)". Инструмент extract-listing.py забирает товары с текущей открытой страницы, а extract-listing-next-page.py находит ссылку на следующую страницу либо инициирует клик по кнопке дозагрузки вроде «Load more».

Для работы нужен предварительно подключённый и запущенный браузер под управлением связки browser-act. Без открытого сеанса браузера скрипты не смогут считать DOM страницы.

Какие задачи решает

  • собрать список товаров с ценами и картинками из категории интернет-магазина
  • сформировать поисковый URL с фильтрами по ценовому диапазону и рейтингу
  • пройти пагинацию каталога и выгрузить ссылки на следующие страницы
  • извлечь рейтинги и количество отзывов для карточек в выдаче

Примеры запросов агенту

  • Найди наушники на Amazon дешевле 100 долларов и собери первые 20 позиций
  • Выгрузи все товары со страницы категории магазина на Shopify
  • Собери список ноутбуков с eBay с сортировкой по возрастанию цены

Как установить ecommerce-listing

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

~/.claude/skills/ecommerce-listing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ecommerce-listing/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об ecommerce-listing

Как установить ecommerce-listing в Claude Code?

Выполните в терминале команду npx skills add browser-act/skills --skill ecommerce-listing -a claude-code.

Что делает ecommerce-listing?

Скилл открывает страницы каталогов и выдачи интернет-магазинов, считывает видимые карточки товаров и возвращает структурированный JSON с ценами, названиями и ссылками.

Требуется ли авторизация в интернет-магазинах?

Нет, для общедоступных страниц категорий и поисковой выдачи вход в аккаунт не требуется.

Исходный текст

SKILL.md · MIT
---
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

## 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 · browser-act/skills

Похожие скиллы

Все скиллы по теме «Браузер и парсинг» →
ecommerce-keyword-research nexscope-ai Скилл ecommerce-keyword-research для подбора ключевых слов в e-commerce: собирает запросы под Amazon, Shopify, Etsy, Walmart и TikTok Shop и оценивает их коммерческий потенциал. CX Codex +1 1 500установок ecommerce-business-plan nexscope-ai Скилл ecommerce-business-plan для Claude Code, Cursor и других редакторов с ИИ создаёт полноценный бизнес-план для e-commerce: анализ рынка, финансовые прогнозы, стратегия маркетинга и дорожная карта развития. CX Codex +1 1 300установок ecommerce-listing-suite xianyu110 Скилл ecommerce-listing-suite координирует создание набора продуктовых изображений для маркетплейсов вроде Amazon, Shopee и Taobao. Он фиксирует детали товара, верстает медиаплан и проверяет артефакты перед сдачей. CX Codex +1 ★ 190звёзд репо ecommerce Bria AI Скилл ecommerce превращает папку сырых фото товара в пакшоты, вырезы, размерные картинки и варианты листингов для Amazon, Shopify и Etsy. CX Codex +1 ★ 76звёзд репо Ecommerce Intel MCP — Shopify Store & Product Analysis nexgendata-apify Ecommerce Intel MCP — Shopify Store & Product Analysis — MCP-сервер для Claude Code: анализирует стек Shopify-магазина и выгружает каталог товаров. Используется для изучения конкурента и его ассортимента. CX Codex +1 10 762установок ecommerce-image-workflow nexu-io Скилл ecommerce-image-workflow собирает комплект товарных снимков из фотографии продукта: главное изображение на белом фоне, крупный план детали и сцену применения с точным сохранением цвета, формы и логотипа. CX Codex +1 2 200установок

Из того же набора11

Весь набор →
browser-act-skill-forge Скилл browser-act-skill-forge разбирает сайт через browser-act и собирает готовый скилл с SKILL.md и Python-скриптами. Дальше сбор данных идёт без повторного исследования. CX Codex +1 85 200установок amazon-competitor-analyzer Скилл amazon-competitor-analyzer собирает данные товаров с Amazon по ASIN и сравнивает цены, характеристики и отзывы конкурентов. Помогает найти слабые места в стратегии соперников и возможности для собственного продукта. CX Codex +1 133установок youtube-channel-api-skill Скилл youtube-channel-api-skill для Claude Code получает через BrowserAct API структурированные сведения о YouTube-каналах из результатов поиска. Ищет авторов по теме и собирает данные о конкурентах. CX Codex +1 5установок taobao-shop-catalog Скилл taobao-shop-catalog собирает товары из каталога магазина Taobao или Tmall по shopId: постранично отдаёт itemId, название, картинку и ссылку на карточку. CX Codex +1 1установок facebook-page-profile-posts Скилл facebook-page-profile-posts для Claude Code собирает посты с публичных страниц и профилей Facebook, включая реакции, медиа, ссылки и данные автора. Используется для выгрузки и мониторинга. CX Codex +1 1установок social-media-finder-skill Скилл social-media-finder-skill находит публичные профили человека или бренда в Facebook, Twitter, Instagram, LinkedIn, TikTok и других соцсетях, а отдаёт всё одним CSV-файлом. CX Codex +1 1установок facebook-page-posts Скилл facebook-page-posts собирает посты с открытых страниц Facebook вместе со счётчиками реакций, ссылками и хэштегами через браузер с активной сессией. CX Codex +1 1установок facebook-groups-scrape-posts Скилл facebook-groups-scrape-posts собирает посты из Facebook-группы и возвращает JSON с авторами, текстом, медиа, реакциями, комментариями и репостами. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой