Etsy Sales MCP Server

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.

MCP pin (both Actors)

https://mcp.apify.com/?tools=publicrecords/etsy-shop-velocity,publicrecords/etsy-search-scraper

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

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

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:

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.

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.