- name
SKILL.md
El archivo de la skill permanece en el repositorio del publicador.
Pega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add browser-act/skills --skill etsy-shop-catalog -a cursor -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add browser-act/skills --skill etsy-shop-catalog -a claude-code -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add browser-act/skills --skill etsy-shop-catalog -a codex -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add browser-act/skills --skill etsy-shop-catalog -a grok -yEnvía el mensaje copiado en un chat de Grok Bot. El Bot obtiene este SKILL.md de GitHub y lo añade a las skills que comparten todos tus Bots.
Install this skill: https://github.com/browser-act/skills/tree/HEAD/solutions/ecommerce/etsy-shop-catalogDel publicador
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.mdResumen general
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.
Preguntas frecuentes
Descarga solutions/ecommerce/etsy-shop-catalog/SKILL.md desde el publicador, o copia la ruta y abre el repositorio. PlugMCP lista la skill y no aloja el archivo.
El publicador lo mantiene en https://github.com/browser-act/skills.
Claude, Cursor, Codex y Grok Build pueden leer un SKILL.md que añadas desde el repositorio del publicador. Grok Bot lo instala cuando envías en un chat el enlace a la carpeta de la skill en GitHub.