Etsy Sales Mcp

io.github.GeminiGeorge22v1.0.0Updated Oct 2, 2026

Etsy shop sales counters with history plus live Etsy search listing rows, via Apify MCP.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & CommerceData & Analytics

Overview

AI-generated overview

Lets an assistant pull Etsy shop sales counters with history and live Etsy search listing rows through Apify's hosted MCP.

What it does
Exposes two Apify Actors as tools: one returns daily sales and velocity rows for named Etsy shops (counters, history, breakout fields), the other returns live keyword, market, or category search listing rows with title, price, shop, badges, and rank. Supporting tools read Actor run details, dataset items, and key-value store records, and abort a running run.
When to use it
Use it when you want an assistant to track sales trends for specific Etsy shops or collect Etsy search listing data for market research, dashboards, or CRM-style workflows, without writing your own scraper.
Requirements
A remote MCP endpoint at mcp.apify.com, or the Apify Actors MCP server run locally via npx with Node.js. An Apify account and an Apify token (APIFY_TOKEN) are needed; runs are billed to that account. Network access is required.
Before you install
Runs cost money on your Apify account: per-event charges such as actor-start, shop-row, shop-history-record, velocity-record, and listing-row, plus separately billed residential proxy usage. The Apify token is a credential and should be kept out of shared configs. The server reads public Etsy data and is not affiliated with Etsy.

Installation

In SourceWeft

  1. Open Etsy Sales Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "etsy-sales-mcp": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=publicrecords/etsy-shop-velocity,publicrecords/etsy-search-scraper"
    }
  }
}

README

etsy-sales-mcp

Drop-in Etsy data for sales and marketing software — CRMs, dashboards, research workflows, and AI assistants — via Apify’s hosted MCP or the Store Actors directly.

Pull Etsy shop sales counters with history/breakout fields and live Etsy search listing rows (title, price, shop, badges, rank) through Apify MCP. 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
ActorStore / statusRole
Etsy Shop Sales Tracker & Scraperpublicrecords/etsy-shop-velocity (listed)Daily sales / velocity rows for named Etsy shops (counters, history, breakout)
Etsy Search Scraperpublicrecords/etsy-search-scraper (listed)Live keyword / market / category listing rows (title, price, shop, badges, rank)

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)

Tracker — publicrecords/etsy-shop-velocity

EventUSD
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.

Search — publicrecords/etsy-search-scraper

EventUSD
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.

Tools

Live tools/list against the pin URL (Bearer Apify token). Tool names exposed:

Tool nameRole
publicrecords--etsy-shop-velocityRun Etsy Shop Sales Tracker (publicrecords/etsy-shop-velocity)
publicrecords--etsy-search-scraperRun Etsy Search Scraper (publicrecords/etsy-search-scraper)
get-actor-runGet detailed information about a specific Actor run
get-dataset-itemsRead items from a run dataset
get-key-value-store-recordRead a key-value store record
abort-actor-runAbort a running Actor run

Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

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:

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) Shop velocity — 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.

shopsales_countsales_precisionreviews_countratingadmirerslistings_activebreakoutsnapshot_date
OrelCeramics111exact34525244false2026-09-30
Bestickend11400rounded1830577144false2026-09-30

2) 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.

What this repo is not

  • Not Actor implementation / Docker / truth sets
  • Not a substitute for Apify Console billing screens
  • Not affiliated with Etsy, Inc.

Tutorials

License

MIT — applies to this documentation and config only.

Published by the publicrecords maintainer on Apify.

Source: README.md at commit dcb1ffd

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 2, 2026