Etsy Search & Shop Sales MCP
Etsy search + Etsy shop sales: live listing rows and sales counters via Apify MCP.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http etsy-search-shop-sales-mcp 'https://mcp.apify.com/?tools=publicrecords/etsy-shop-velocity,publicrecords/etsy-search-scraper'
{
"mcpServers": {
"etsy-search-shop-sales-mcp": {
"type": "http",
"url": "https://mcp.apify.com/?tools=publicrecords/etsy-shop-velocity,publicrecords/etsy-search-scraper"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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.
Frequently asked questions
What is Etsy Search & Shop Sales MCP?
Etsy search + Etsy shop sales: live listing rows and sales counters via Apify MCP.
How do I install Etsy Search & Shop Sales MCP?
It runs as a remote server. In Claude Code: claude mcp add --transport http etsy-search-shop-sales-mcp 'https://mcp.apify.com/?tools=publicrecords/etsy-shop-velocity,publicrecords/etsy-search-scraper'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Etsy Search & Shop Sales MCP need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Etsy Search & Shop Sales MCP open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Etsy Search & Shop Sales MCP?
It is published by GeminiGeorge22. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.