Etsy Search & Shop Sales MCP
Etsy search + Etsy shop sales: live listing rows and sales counters via Apify MCP.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
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
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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.
Questions fréquentes
Qu'est-ce que Etsy Search & Shop Sales MCP ?
Etsy search + Etsy shop sales: live listing rows and sales counters via Apify MCP.
Comment installer Etsy Search & Shop Sales MCP ?
Il fonctionne comme serveur distant. Dans 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'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Etsy Search & Shop Sales MCP ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
Etsy Search & Shop Sales MCP est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Etsy Search & Shop Sales MCP ?
Il est publié par GeminiGeorge22. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.