# Etsy Keyword Search

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

- Repository: https://github.com/browser-act/skills (6303 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-08-24
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add browser-act/skills --skill etsy-keyword-search -g -a claude-code -y`
Codex: `npx skills add browser-act/skills --skill etsy-keyword-search -g -a codex -y`
Cursor: `npx skills add browser-act/skills --skill etsy-keyword-search -g -a cursor -y`
Gemini CLI: `npx skills add browser-act/skills --skill etsy-keyword-search -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/browser-act/skills/blob/HEAD/solutions/ecommerce/etsy-keyword-search/SKILL.md