etsy-keyword-search

Extract paginated product listings from Etsy keyword search result pages.

5.5k|269|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/browser-act/skills --skill etsy-keyword-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: etsy-keyword-search
Source: https://github.com/browser-act/skills/tree/main/solutions/ecommerce/etsy-keyword-search
Command: npx skills add https://github.com/browser-act/skills --skill etsy-keyword-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually collecting product data from Etsy search results is slow and repetitive, especially across many pages. This Skill automates the extraction of structured listing data from Etsy's public keyword search pages using a real browser session.

Core Features & Use Cases

  • Structured Listing Extraction: Captures listingId, shopId, title, URL, image, sale and original prices, currency, rating, review count, shop name, ad status, free shipping, and badges per product card.
  • URL-Based Pagination: Iterates through search result pages via the page parameter, stopping when no next page exists, with per-page JSON output for resumable batch runs.
  • Anti-Bot Handling Guidance: Includes warm-up navigation and error detection for Etsy's DataDome verification, with clear blocked-page error signals.
  • Use Case: A seller researching competitors runs the Skill across 10 pages of results for "leather wallet" to build a dataset of prices, ratings, and bestseller badges for market analysis.

Quick Start

Ask the agent to search Etsy for a keyword like "leather wallet" and extract the first three pages of product listings into JSON files.

Frequently Asked Questions about etsy-keyword-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape Etsy search results by keyword?

Open the Etsy search URL for your keyword in a browser-act session, then run the extraction script to get structured JSON of all listing cards on the page. Paginate by incrementing the page parameter in the URL until no next page exists.

What data fields can I extract from Etsy product listings?

Each listing yields listingId, shopId, title, canonical URL, image, sale price, original price, currency, rating, review count, shop name, ad status, free shipping flag, badge text, and position index. Fields like rating or original price return null when not shown on the card.

Does Etsy scraping require login or an account?

No login is required because Etsy search results are public. However, the browser session must survive DataDome anti-bot verification, which is why the Skill warms up by visiting the Etsy homepage before the search URL.

Why does Etsy scraping get blocked by anti-bot verification?

Cold navigation directly to a search URL often triggers Etsy's DataDome CAPTCHA interstitial. Navigate to the Etsy homepage first within the same stealth session, and rotate proxies or fingerprints if blocks persist.

What are the limitations of extracting Etsy search data?

Review counts are returned as displayed text like 7.9k rather than exact integers, and anonymized offsite ads return null for shop name. Search results are personalized per session, so positions may differ across proxies or accounts.