Etsy Listing Supply & Competition Fetcher

Takes one or more Etsy search terms (e.g. "dark botanical shirt", "moth shirt") and pulls live Etsy listings for that term, row by row. Each row includes the product title, price, discount status (onSale), star rating, review count, seller (shop) name, free-shipping info, and the listing URL. It wraps the Apify automation-lab/etsy-scraper actor behind a residential proxy.

When to use it: When you want to read the SUPPLY and COMPETITION side before entering a niche on Etsy: how many competing listings exist for that term, what price band they spread across, how many sellers dominate, and how intense the discount pressure (price war) is. A low discount rate + a narrow price band points to a healthy-margin niche; a high discount rate indicates a saturated/aggressive competitive landscape.

Output: A JSON list of rows with consistent keys (product title, price, discount, rating, reviews, shop, shipping, URL). On the caller side you can compute a per-term competition summary (listing count, price min/median/max, discount %, average rating, distinct shop count, busiest sellers).

Important limitation: This actor does NOT provide SALES VOLUME — price/discount data should not be mistaken for sales volume. For a demand signal (how many people are searching), use it together with the complementary etsy-keywords-apify-fetcher skill. Credentials are read from APIFY_API_TOKEN in ~/.claude/.env.