etsy-category-listing

Name: etsy-category-listing
Author: browser-act

4.6kstars220forks

How to install etsy-category-listing?

browser-act/skills/etsy-category-listing

$npx -y skills add browser-act/skills --skill etsy-category-listing

Installs into the current project.

Summary

Etsy category page scraper: given an Etsy category URL (e.g. https://www.etsy.com/c/jewelry) and optional page number, returns paginated product listings with listingId, shopId, title, url, image, salePrice, originalPrice, currency, rating, reviewCount, shopName, isAd, freeShippi

Files · 1

View on GitHub

SKILL.md

1	# Etsy — Category Listing
2
3	> Input an Etsy category URL (and optional page number) → output paginated product listings from that category page.
4
5	## Language
6
7	All process output to user (progress updates, process notifications) follows the user's language.
8
9	## Objective
10
11	Collect product listings from Etsy public category (`/c/...`) pages, one page at a time, with core fields per item.
12
13	## Prerequisites
14
15	- Target page is already open in the browser: `https://www.etsy.com/c/{category-path}` (or navigate to it during execution)
16	- No login required — category pages are public
17	- Browser session must survive anti-bot verification (DataDome). Best practice: navigate to `https://www.etsy.com/` first, then to the category URL, within an established stealth browser session
18
19	## Pre-execution Checks
20
21	### 1. Tool Readiness
22
23	If browser-act has been confirmed available in the current session → skip this step.
24
25	Invoke `browser-act` via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.
26
27	### 2. Anti-bot Warm-up
28
29	If a fresh browser session was just created, before hitting a `/c/` URL directly:
30
31	1. `navigate https://www.etsy.com/` → `wait stable`
32	2. Then `navigate {category URL}` → `wait stable`
33
34	If the extraction script returns `{"error": true, "message": "blocked by anti-bot verification page"}`, switch to a stealth browser with a different fingerprint / proxy, retry the warm-up, then re-run extraction.
35
36	## Capability Components
37
38	> 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, never bypassing authentication or access controls. Its role is equivalent to copy-pasting on the user's behalf — the data is already on screen, automation merely saves time. JS code is encapsulated in Python files under the `scripts/` directory, invoked via `eval "$(python scripts/xxx.py {params})"`. `$(...)` is bash syntax; it is recommended to use the bash tool for execution.
39
40	### DOM: extract product listings from category page
41
42	Prerequisite: current page is an Etsy category page (`https://www.etsy.com/c/{category-path}`) after `wait stable`.
43
44	Extract: `eval "$(python scripts/extract-listings.py)"`
45
46	Output example:
47	```json
48	{
49	"error": false,
50	"url": "https://www.etsy.com/c/jewelry?ref=catnav-10855&page=2", // page URL
51	"currentPage": 2, // current page number parsed from URL, defaults 1
52	"count": 64, // number of unique listings on the page
53	"nextPageUrl": "https://www.etsy.com/c/jewelry?ref=pagination&page=3", // URL of next page, null on last page
54	"listings": [
55	{
56	"listingId": "1791916774", // Etsy listing id
57	"shopId": "18293002", // Etsy shop id
58	"title": "Handmade Silver Ring…", // product title
59	"url": "https://www.etsy.com/listing/1791916774/…", // canonical listing URL, tracking params stripped
60	"image": "https://i.etsystatic.com/…/il_794xN.….jpg", // primary product image
61	"salePrice": "$45.00", // current display price
62	"originalPrice": null, // original / crossed-out price, null when no discount
63	"currency": "$", // currency symbol as shown to user
64	"rating": 4.9, // average star rating, null when card shows none
65	"reviewCount": "1.2k", // review count as displayed
66	"shopName": "SilverCraftShop", // shop / seller display name
67	"isAd": false, // true when card is an advertised placement
68	"freeShipping": true, // true when "Free shipping" badge shown
69	"badge": "Etsy's Pick", // ranked badge text or null
70	"positionIndex": 0 // 0-based position within the page
71	}
72	]
73	}
74	```
75
76	Error handling:
77	- `{"error": true, "message": "blocked

People who liked this also viewed

6 picks

Type

etsy-category-listing

4.6kstars220forks

View on GitHub

How to install etsy-category-listing?

browser-act/skills/etsy-category-listing

$npx -y skills add browser-act/skills --skill etsy-category-listing

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Etsy — Category Listing
2
3	> Input an Etsy category URL (and optional page number) → output paginated product listings from that category page.
4
5	## Language
6
7	All process output to user (progress updates, process notifications) follows the user's language.
8
9	## Objective
10
11	Collect product listings from Etsy public category (`/c/...`) pages, one page at a time, with core fields per item.
12
13	## Prerequisites
14
15	- Target page is already open in the browser: `https://www.etsy.com/c/{category-path}` (or navigate to it during execution)
16	- No login required — category pages are public
17	- Browser session must survive anti-bot verification (DataDome). Best practice: navigate to `https://www.etsy.com/` first, then to the category URL, within an established stealth browser session
18
19	## Pre-execution Checks
20
21	### 1. Tool Readiness
22
23	If browser-act has been confirmed available in the current session → skip this step.
24
25	Invoke `browser-act` via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.
26
27	### 2. Anti-bot Warm-up
28
29	If a fresh browser session was just created, before hitting a `/c/` URL directly:
30
31	1. `navigate https://www.etsy.com/` → `wait stable`
32	2. Then `navigate {category URL}` → `wait stable`
33
34	If the extraction script returns `{"error": true, "message": "blocked by anti-bot verification page"}`, switch to a stealth browser with a different fingerprint / proxy, retry the warm-up, then re-run extraction.
35
36	## Capability Components
37
38	> 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, never bypassing authentication or access controls. Its role is equivalent to copy-pasting on the user's behalf — the data is already on screen, automation merely saves time. JS code is encapsulated in Python files under the `scripts/` directory, invoked via `eval "$(python scripts/xxx.py {params})"`. `$(...)` is bash syntax; it is recommended to use the bash tool for execution.
39
40	### DOM: extract product listings from category page
41
42	Prerequisite: current page is an Etsy category page (`https://www.etsy.com/c/{category-path}`) after `wait stable`.
43
44	Extract: `eval "$(python scripts/extract-listings.py)"`
45
46	Output example:
47	```json
48	{
49	"error": false,
50	"url": "https://www.etsy.com/c/jewelry?ref=catnav-10855&page=2", // page URL
51	"currentPage": 2, // current page number parsed from URL, defaults 1
52	"count": 64, // number of unique listings on the page
53	"nextPageUrl": "https://www.etsy.com/c/jewelry?ref=pagination&page=3", // URL of next page, null on last page
54	"listings": [
55	{
56	"listingId": "1791916774", // Etsy listing id
57	"shopId": "18293002", // Etsy shop id
58	"title": "Handmade Silver Ring…", // product title
59	"url": "https://www.etsy.com/listing/1791916774/…", // canonical listing URL, tracking params stripped
60	"image": "https://i.etsystatic.com/…/il_794xN.….jpg", // primary product image
61	"salePrice": "$45.00", // current display price
62	"originalPrice": null, // original / crossed-out price, null when no discount
63	"currency": "$", // currency symbol as shown to user
64	"rating": 4.9, // average star rating, null when card shows none
65	"reviewCount": "1.2k", // review count as displayed
66	"shopName": "SilverCraftShop", // shop / seller display name
67	"isAd": false, // true when card is an advertised placement
68	"freeShipping": true, // true when "Free shipping" badge shown
69	"badge": "Etsy's Pick", // ranked badge text or null
70	"positionIndex": 0 // 0-based position within the page
71	}
72	]
73	}
74	```
75
76	Error handling:
77	- `{"error": true, "message": "blocked

People who liked this also viewed

6 picks

Type