Etsy Search & Shop Sales MCP
Etsy search and Etsy shop sales data for CRMs, dashboards, research workflows, and AI assistants — live Etsy search listing rows plus shop sales counters — via Apify’s hosted MCP or the Store Actors directly.
Pull live Etsy search listing rows (title, price, shop, badges, rank) and Etsy shop sales counters with history/breakout fields through Apify MCP. This is an Etsy scraper / Etsy MCP pin for both Actors. Manifest-only repo — no Actor source.
Disclosure: I maintain these Actors on Apify Store (publicrecords). This repo documents MCP / client config only.
Paid Actor (tracked): Etsy Shop Sales Tracker & Scraper on Apify — daily sales / velocity for named Etsy shops.
MCP pin (both Actors)
https://mcp.apify.com/?tools=publicrecords/etsy-shop-velocity,publicrecords/etsy-search-scraper
| Actor | Store / status | Role |
|---|---|---|
| Etsy Search Scraper | publicrecords/etsy-search-scraper (listed) | Live keyword / market / category listing rows (title, price, shop, badges, rank) |
| Etsy Shop Sales Tracker & Scraper | publicrecords/etsy-shop-velocity (listed) | Daily sales / velocity rows for named Etsy shops (counters, history, breakout) |
Use either path:
- Apify MCP (Claude Desktop, Cursor, or any MCP client) with the pin above
- Store Actors directly in Apify Console / API for pipelines, CRMs, and dashboards
Auth: your own Apify token in the client when prompted. Runs are billed on your Apify account.
Pricing (Console PPE, live 2026-10-02)
Search — publicrecords/etsy-search-scraper
| Event | USD |
|---|---|
actor-start | $0.005 |
listing-row | $0.006 |
Measured proof run pRpdAMmfeMHdmuRXA: 36 complete listing rows → $0.221. Works out of the box on Apify residential proxy (default; Apify bills proxy usage separately — no proxy markup on our PPE). Or plug in your own residential proxy. Blocked pages charge no listing rows.
Tracker — publicrecords/etsy-shop-velocity
| Event | USD |
|---|---|
actor-start | $0.005 |
shop-row | $0.003 |
shop-history-record | $0.05 |
velocity-record | $0.10 |
Measured: 2 shops → $0.011; 5 shops → $0.020. No proxy required.
Tools
Live tools/list against the pin URL (Bearer Apify token). Tool names exposed:
| Tool name | Role |
|---|---|
publicrecords--etsy-search-scraper | Run Etsy Search Scraper (publicrecords/etsy-search-scraper) |
publicrecords--etsy-shop-velocity | Run Etsy Shop Sales Tracker (publicrecords/etsy-shop-velocity) |
get-actor-run | Get detailed information about a specific Actor run |
get-dataset-items | Read items from a run dataset |
get-key-value-store-record | Read a key-value store record |
abort-actor-run | Abort a running Actor run |
Claude Desktop
Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"etsy-sales": {
"command": "npx",
"args": [
"-y",
"@apify/actors-mcp-server",
"--actors",
"publicrecords/etsy-shop-velocity,publicrecords/etsy-search-scraper"
],
"env": {
"APIFY_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
}
Or point the Apify remote MCP URL (with the pin above) if your Claude Desktop build supports remote MCP servers.
Cursor
In Cursor MCP settings / .cursor/mcp.json:
{
"mcpServers": {
"etsy-sales": {
"url": "https://mcp.apify.com/?tools=publicrecords/etsy-shop-velocity,publicrecords/etsy-search-scraper"
}
}
}
Sign in with Apify when Cursor prompts.
Example prompts (measured)
1) Etsy search — ceramic mug, 3 pages
Prompt: Scrape Etsy search for ceramic mug, max 3 pages (Apify residential US default).
Run: pRpdAMmfeMHdmuRXA — SUCCEEDED in 52.561s; 36 listing rows; fill price/shop/title 36/36; Console PPE $0.221.
First three rows (abbreviated): KJPottery $57 bestsellers; BZceramics $35.50 popular_now; Neherpottery $35 bestsellers.
2) Etsy shop sales — two named shops
Prompt: Track sales for Etsy shops OrelCeramics and Bestickend.
Run: lWWrFPgwZcu6DYYKe — SUCCEEDED in 5.314s; 2 shop-rows; Console cost $0.011; snapshot 2026-09-30.
| shop | sales_count | sales_precision | reviews_count | rating | admirers | listings_active | breakout | snapshot_date |
|---|---|---|---|---|---|---|---|---|
| OrelCeramics | 111 | exact | 34 | 5 | 252 | 44 | false | 2026-09-30 |
| Bestickend | 11400 | rounded | 1830 | 5 | 771 | 44 | false | 2026-09-30 |
What this repo is not
- Not Actor implementation / Docker / truth sets
- Not a substitute for Apify Console billing screens
- Not affiliated with Etsy, Inc.
Site hubs + tutorials
- Search hub: https://geminigeorge22.github.io/etsy-search-scraper/
- Tracker hub: https://geminigeorge22.github.io/etsy-shop-velocity/
- Search tutorial: https://geminigeorge22.github.io/blog/etsy-search-scraper/
- Tracker tutorial: https://geminigeorge22.github.io/blog/etsy-shop-sales-velocity/
- Publisher site: https://geminigeorge22.github.io/
License
MIT — applies to this documentation and config only.
Published by the publicrecords maintainer on Apify.