Etsy Search & Shop Sales MCP

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.