Etsy Sales Mcp

io.github.GeminiGeorge22v1.0.0更新于 Oct 2, 2026

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

已验证Streamable HTTP可网页运行Web Search & Scraping Business & Commerce Data & Analytics

概览

AI 生成的概览

让助手通过 Apify 托管的 MCP 获取 Etsy 店铺销售计数与历史，以及 Etsy 搜索实时商品列表数据。

功能: 将两个 Apify Actor 暴露为工具：一个返回指定 Etsy 店铺的每日销售与速度数据（计数、历史、突破字段），另一个返回关键词、市场或分类搜索的实时商品列表行，含标题、价格、店铺、徽章和排名。辅助工具可读取 Actor 运行详情、数据集条目和键值存储记录，并可中止正在运行的运行。
适用场景: 当你希望助手跟踪特定 Etsy 店铺的销售趋势，或为市场调研、仪表盘、CRM 类工作流收集 Etsy 搜索列表数据，而不想自己编写爬虫时，适合使用。
运行要求: 需要 mcp.apify.com 的远程 MCP 端点，或通过 npx 在本地运行 Apify Actors MCP 服务器（需 Node.js）。需要 Apify 账户和 Apify 令牌（APIFY_TOKEN）；运行费用计入该账户。需要网络访问。

安装前请注意

运行会在你的 Apify 账户上产生费用：按事件计费，如 actor-start、shop-row、shop-history-record、velocity-record 和 listing-row，住宅代理用量另行计费。Apify 令牌属于凭据，不应放入共享配置。该服务器读取 Etsy 公开数据，与 Etsy 无关联。

安装

在 SourceWeft 中

打开控制台中的 Etsy Sales Mcp，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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)

Actor	Store / status	Role
Etsy Shop Sales Tracker & Scraper	publicrecords/etsy-shop-velocity (listed)	Daily sales / velocity rows for named Etsy shops (counters, history, breakout)
Etsy Search Scraper	publicrecords/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`

Measured: 2 shops → $0.011; 5 shops → $0.020. No proxy required.

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.

Tools

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

Tool name	Role
`publicrecords--etsy-shop-velocity`	Run Etsy Shop Sales Tracker (`publicrecords/etsy-shop-velocity`)
`publicrecords--etsy-search-scraper`	Run Etsy Search Scraper (`publicrecords/etsy-search-scraper`)
`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):

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"      }    }  }}

{  "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"    }  }}

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

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.

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.

来源：README.md，提交 dcb1ffd

工具

工具元数据尚未被收录。

版本历史

v1.0.0最新Oct 2, 2026

Event	USD
`actor-start`	$0.005
`shop-row`	$0.003
`shop-history-record`	$0.05
`velocity-record`	$0.10

Event	USD
`actor-start`	$0.005
`listing-row`	$0.006

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