Etsy MCP Scraper — Live Etsy Tools for AI Agents

Connect Claude, ChatGPT, Cursor, n8n, Make or any Model Context Protocol client to Etsy and let your AI agent search listings, shops and categories in real time. No Etsy API key, no browser automation, no monthly fee — you pay only per tool call.

Prefer a classic scraper? The same Actor also runs as a one-shot Etsy listing scraper that writes rows to a dataset.

---

Two ways to use it

1. As an MCP server (Standby mode)

Start the Actor in Standby mode and point your MCP client at:

https://<your-username>--etsy-mcp-scraper.apify.actor/mcp

Authenticate with your Apify API token as a Bearer token. Example client config:

{
    "mcpServers": {
        "etsy": {
            "type": "http",
            "url": "https://YOUR_USERNAME--etsy-mcp-scraper.apify.actor/mcp",
            "headers": { "Authorization": "Bearer YOUR_APIFY_API_TOKEN" }
        }
    }
}

Then ask your agent things like "Find the 10 cheapest personalized leather wallets on Etsy" or "Which Etsy candle shops have the most sales?"

2. As a classic scraper (Normal run)

Provide keywords (and optional filters) in the input and run it once. Normalized listings are pushed to the dataset for CSV/JSON/Excel export.

---

MCP tools

Tool	What it does	Key arguments
search_etsy_listings	Search products by keyword with filters and sorting	keywords, limit, min_price, max_price, ship_to, sort_on, free_shipping, is_discounted, digital_only
search_etsy_shops	Find shops (sellers) with sales, location and sample listings	query, limit, max_shop_listings
get_etsy_category	Browse the Etsy category/taxonomy tree	taxonomy_id
get_etsy_search_suggestions	Autocomplete / trending search terms buyers type, plus matching shops	query, limit

sort_on accepts: score (relevance), best_seller, price_asc, price_desc, created_desc.

---

Output fields (listings)

Field	Description
listing_id	Unique Etsy listing id
title	Listing title
url	Direct listing URL
shop_name / shop_url	Seller shop name and URL
price / original_price / discount_percent	Current price, pre-discount price, discount %
currency_code	Currency of the price
images / thumbnail	Full-resolution image URLs and a thumbnail
shipping	Shipping destinations and costs
is_digital	Instant digital download
is_bestseller / is_star_seller	Etsy performance badges
review_count	Shop review count (best available proxy)
shop_location	Seller location
scraped_at	UTC timestamp

Example listing

{
    "listing_id": "837615700",
    "title": "Handmade Ceramic Coffee Mug: Large Porcelain Espresso Cup",
    "url": "https://www.etsy.com/listing/837615700/handmade-ceramic-coffee-mug-large",
    "shop_name": "BZceramics",
    "shop_url": "https://www.etsy.com/shop/BZceramics",
    "price": 36.18,
    "currency_code": "USD",
    "images": ["https://i.etsystatic.com/.../il_fullxfull.jpg"],
    "is_digital": false,
    "is_bestseller": false,
    "is_star_seller": true,
    "review_count": 1842,
    "scraped_at": "2026-06-17T00:00:00Z"
}

---

Use cases

• AI shopping & research agents — give an LLM live Etsy data on demand.
• Product & dropshipping research — find trending, discounted or bestselling items.
• Competitor & supplier analysis — pull shop sales, catalogs and locations.
• Price monitoring — schedule runs and track price/discount changes.
• Catalog & niche mapping — walk the Etsy taxonomy to find high-volume categories.

---

Input parameters (classic run)

Parameter	Type	Description
keywords	string	Search terms (required for classic runs)
limit	integer	Max listings to return (1–5000)
minPrice / maxPrice	number	Price range filter
shipTo	string	ISO country code (US, GB, CA, …)
sortOn	string	Relevance, best sellers, price, newest
freeShipping	boolean	Free-shipping listings only
isDiscounted	boolean	Discounted listings only
digitalOnly	boolean	Instant digital downloads only

Example input

{
    "keywords": "ceramic coffee mug",
    "limit": 50,
    "minPrice": 15,
    "maxPrice": 60,
    "sortOn": "price_asc",
    "freeShipping": true
}

---

Pricing

This Actor uses Pay Per Event: a flat fee per MCP tool call. A single tool call can return many listings, so a research session typically costs only a few cents. Classic scraping runs are billed per tool call invoked internally.

---

Scheduling & automation

• Schedule runs from the Apify Console (e.g. daily price checks).
• Webhooks: POST results to your endpoint when a run finishes.
• API: trigger via POST https://api.apify.com/v2/acts/YOUR_USERNAME~etsy-mcp-scraper/runs.

---

FAQ

Do I need an Etsy API key? No. The Actor uses Etsy's public mobile endpoints.

Which MCP clients work? Any client speaking Streamable HTTP — Claude Desktop, ChatGPT, Cursor, VS Code, n8n, Make, and custom agents.

Can I use it without MCP? Yes — run it normally with keywords and read results from the dataset.

Is the data legal to use? It scrapes publicly available Etsy data. Use it in accordance with Etsy's Terms of Service and applicable laws.