Skills

Etsy Keyword Search

Etsy keyword search scraper: given a search keyword and optional page number, returns...

Install

npx skills add browser-act/skills --skill etsy-keyword-search -g -a claude-code -y
Repository
browser-act/skills6.3k
Category
Writing
Updated
2mo ago
License
MIT
Context cost
Mediumabout 2,057 tokens
Runs scripts
Yes, review before use

What it does

Etsy keyword search scraper: given a search keyword and optional page number, returns paginated product listings with listingId, shopId, title, url, image, salePrice, originalPrice, currency, rating, reviewCount, shopName, isAd, freeShipping, badge from etsy.com search results. Use when user mentions Etsy, etsy.com, Etsy search, search Etsy by keyword, scrape Etsy listings, extract Etsy products, Etsy product search, Etsy marketplace search, find products on Etsy, Etsy handmade search, Etsy vintage search, Etsy craft search, bulk Etsy product export, Etsy price monitoring, Etsy competitor research, Etsy top listings, Etsy bestseller extraction, Etsy sales data, Etsy shop discovery via keyword. Also applies to trend research on handmade or craft niches, competitor keyword ranking on Etsy, sourcing Etsy suppliers by product type, and any paginated bulk product collection driven by a search keyword.

Etsy, Keyword Search

Input a search keyword (and optional page number) → output paginated product listings from Etsy search results.

Language

All process output to user (progress updates, process notifications) follows the user's language.

Objective

Collect product listings from Etsy's public keyword search results, one page at a time, with core fields per item.

Prerequisites

  • Target page is already open in the browser: https://www.etsy.com/search?q={keyword} (or navigate to it during execution)
  • No login required, search results are public
  • Browser session must survive anti-bot verification (DataDome). Best practice: navigate to https://www.etsy.com/ first, then to the search URL, within an established stealth browser session

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.

2. Anti-bot Warm-up

If a fresh browser session was just created, before hitting the search URL directly:

  1. navigate https://www.etsy.com/ → wait stable
  2. Then navigate https://www.etsy.com/search?q={keyword} → wait stable

Reason: hitting /search cold triggers DataDome CAPTCHA more often than hitting / first and following the same-origin flow.

If the extraction script returns {"error": true, "message": "blocked by anti-bot verification page"}, treat this as a hard block: stop execution and inform the user that the page is blocked by anti-bot verification and cannot proceed automatically.

Capability Components

Read the whole SKILL.md on GitHub

More in Writing