- name
SKILL.md
스킬 파일은 게시자의 저장소에 그대로 있습니다.
복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add browser-act/skills --skill etsy-shop-catalog -a cursor -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add browser-act/skills --skill etsy-shop-catalog -a claude-code -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add browser-act/skills --skill etsy-shop-catalog -a codex -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add browser-act/skills --skill etsy-shop-catalog -a grok -y복사한 메시지를 Grok Bot 채팅에 보냅니다. Bot이 GitHub에서 이 SKILL.md를 가져와 모든 Bot이 공유하는 스킬에 추가합니다.
Install this skill: https://github.com/browser-act/skills/tree/HEAD/solutions/ecommerce/etsy-shop-catalog게시자 제공
Input an Etsy shop URL (and optional page number) → output paginated product listings from that shop's storefront.
All process output to user (progress updates, process notifications) follows the user's language.
Collect a shop's own storefront listings, one page at a time, with core fields per item.
https://www.etsy.com/shop/{shop-name} (or navigate to it during execution)https://www.etsy.com/ first, then to the shop URLIf 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.
If a fresh browser session was just created:
navigate https://www.etsy.com/ → wait stablenavigate https://www.etsy.com/shop/{shop-name} → wait stableOn blocked by anti-bot verification page errors, switch to a stealth browser with a different fingerprint / proxy and retry.
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 viaeval "$(python scripts/xxx.py {params})".$(...)is bash syntax; it is recommended to use the bash tool for execution.
Prerequisite: current page is an Etsy shop page (https://www.etsy.com/shop/{shop-name}) after wait stable. Works on both the default first tab and paginated tabs.
Extract: eval "$(python scripts/extract-listings.py)"
Output example:
{
"error": false,
"url": "https://www.etsy.com/shop/Xcraftsman?ref=items-pagination&page=2&sort_order=custom", // page URL
"currentPage": 2, // current page number parsed from URL, defaults 1
"count": 44, // number of unique listings on the page
"nextPageUrl": "https://www.etsy.com/shop/Xcraftsman?ref=items-pagination&page=3&sort_order=custom", // URL of next page, null on last page
"listings": [
{
"listingId": "4332558944", // Etsy listing id
"shopId": "13350861", // Etsy shop id (same across the whole shop)
"title": "Handmade Leather Bifold Wallet", // product title
"url": "https://www.etsy.com/listing/4332558944/…", // canonical listing URL, tracking params stripped
"image": "https://i.etsystatic.com/…/il_794xN.….jpg", // primary product image
"salePrice": "$120.00", // current display price
"originalPrice": null, // original / crossed-out price, null when no discount
"currency": "$", // currency symbol as shown to user
"rating": 4.8, // average star rating on the shop card, null when card shows none
"reviewCount": "455", // review count as displayed
"shopName": "Xcraftsman", // shop / seller display name (same for all cards)
"isAd": false, // typically false on shop pages
"freeShipping": true, // true when "Free shipping" badge shown
"badge": null, // ranked badge text or null
"positionIndex": 0 // 0-based position within the page
}
]
}
Error handling:
{"error": true, "message": "blocked by anti-bot verification page"} — DataDome interstitial; retry warm-up{"error": true, "message": "no listing cards found on page"} — shop may be empty, on vacation, or URL is wrong; check the shop URL and shop status shown on the pageURL Pagination: URL pattern https://www.etsy.com/shop/{shop-name}?ref=items-pagination&page={N}&sort_order=custom where {N} starts at 1. Follow the returned nextPageUrl verbatim to preserve sort_order and other shop-tab params. Termination: count === 0 or previous nextPageUrl was null.
result.error === false && result.count >= 1 && result.listings.every(l => l.listingId && l.title && l.url && l.shopName)
/ first?sort_order=custom matches the shop owner's default ordering~44 on page 1 vs ~64 on paginated pages); this is normal — extract what is rendered, then paginatecount may be 0results/{shop-name}-p{N}.json immediately; on failure resume from the missing pagePath: {working-directory}/browser-act-skill-forge-memories/etsy-scraper-etsy-shop-catalog.memory.md (working directory is determined by the Agent running the Skill, typically the project root or current working directory)
Before execution: If the file exists, read it first — it records unexpected situations encountered during past executions (e.g., a strategy has become ineffective); 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}
Normal execution does not write to the file. Do not record what shops were used or how many results were returned — those are task outputs, not experience.
Etsy shop catalog scraper: given an Etsy shop URL (e.g. https://www.etsy.com/shop/{shop-name}) and optional page number, returns paginated product listings from that shop's own storefront with listing
---name: etsy-shop-catalogdescription: Etsy shop catalog scraper: given an Etsy shop URL (e.g. https://www.etsy.com/shop/{shop-name}) and optional…---# solutions/ecommerce/etsy-shop-catalog/SKILL.md개요
Etsy shop catalog scraper: given an Etsy shop URL (e.g. https://www.etsy.com/shop/{shop-name}) and optional page number, returns paginated product listings from that shop's own storefront with listingId, shopId, title, url, image, salePrice, originalPrice, currency, rating, reviewCount, shopName, isAd, freeShipping, badge. Use when user mentions Etsy shop, Etsy seller, Etsy store, etsy.com/shop, scrape Etsy shop, extract all products from Etsy shop, Etsy shop catalog, Etsy seller catalog, list all Etsy shop items, Etsy storefront scraper, Etsy vendor products, Etsy competitor shop, Etsy shop monitoring, get inventory of an Etsy shop, dump Etsy shop products, Etsy seller product export, seller product benchmarking, Etsy shop bulk export. Also applies to competitor shop tracking, supplier catalog collection, price monitoring for a specific shop, new-item detection on a shop, and any paginated bulk collection driven by a single Etsy shop URL.
FAQ
게시자에게서 solutions/ecommerce/etsy-shop-catalog/SKILL.md를 다운로드하거나 경로를 복사해 저장소를 엽니다. PlugMCP는 스킬을 목록에 올릴 뿐 파일을 호스팅하지 않습니다.
게시자가 https://github.com/browser-act/skills에서 관리합니다.
Claude, Cursor, Codex, Grok Build는 게시자의 저장소에서 추가한 SKILL.md를 읽을 수 있습니다. Grok Bot은 채팅에서 스킬의 GitHub 폴더 링크를 보내면 설치합니다.