- name
SKILL.md
O arquivo da skill permanece no repositório do publicador.
Cole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add browser-act/skills --skill etsy-shop-catalog -a cursor -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add browser-act/skills --skill etsy-shop-catalog -a claude-code -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add browser-act/skills --skill etsy-shop-catalog -a codex -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add browser-act/skills --skill etsy-shop-catalog -a grok -yEnvie a mensagem copiada em um chat do Grok Bot. O Bot busca este SKILL.md no GitHub e o adiciona às skills que todos os seus Bots compartilham.
Install this skill: https://github.com/browser-act/skills/tree/HEAD/solutions/ecommerce/etsy-shop-catalogDo 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.mdVisão geral
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.
Perguntas frequentes
Baixe solutions/ecommerce/etsy-shop-catalog/SKILL.md do publicador ou copie o caminho e abra o repositório. O PlugMCP lista a skill e não hospeda o arquivo.
O publicador o mantém em https://github.com/browser-act/skills.
Claude, Cursor, Codex e Grok Build conseguem ler um SKILL.md que você adiciona a partir do repositório do publicador. O Grok Bot o instala quando você envia em um chat o link da pasta da skill no GitHub.