Etsy Search & Shop Sales MCP

Etsy 搜索与店铺销售 MCP

面向 CRM、仪表板、研究工作流和 AI 助手的 Etsy 搜索与Etsy 店铺销售数据——实时 Etsy 搜索商品行和店铺销售计数器——可通过 Apify 托管的 MCP 或直接使用 Store Actors 获取。

通过 Apify MCP 获取实时 Etsy 搜索商品行（标题、价格、店铺、徽章、排名）以及包含历史记录和细分字段的 Etsy 店铺销售计数器。这是适用于这两个 Actor 的 Etsy 抓取工具 / Etsy MCP 收藏条目。仅包含清单的仓库——不含 Actor 源代码。

**披露：**我在 Apify Store（publicrecords）维护这些 Actor。本仓库仅记录 MCP / 客户端配置。

付费 Actor（已跟踪）：Apify 上的 Etsy Shop Sales Tracker & Scraper——指定 Etsy 店铺的每日销售量 / 销售速度。

MCP 固定项（两个 Actor）

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

Actor	Store / 状态	用途
Etsy Search Scraper	publicrecords/etsy-search-scraper（已上架）	实时关键词 / 市场 / 类别商品行（标题、价格、店铺、徽章、排名）
Etsy Shop Sales Tracker & Scraper	publicrecords/etsy-shop-velocity（已上架）	指定 Etsy 店铺的每日销售量 / 销售速度行（计数器、历史记录、细分）

可选择任一路径：

• 使用上方固定项的 Apify MCP（Claude Desktop、Cursor 或任何 MCP 客户端）
• 直接在 Apify Console / API 中使用 Store Actors，用于数据管道、CRM 和仪表板

身份验证：按提示在客户端中提供你自己的 Apify 令牌。运行费用计入你的 Apify 账户。

定价（Console PPE，实时数据，2026-10-02）

搜索 — publicrecords/etsy-search-scraper

事件	USD
actor-start	$0.005
listing-row	$0.006

实测证明运行 pRpdAMmfeMHdmuRXA：36 条完整商品行 → $0.221。使用 Apify 住宅代理即可开箱即用（默认；Apify 会单独收取代理费用——我们的 PPE 不加收代理费用）。也可以接入你自己的住宅代理。页面被拦截时不会收取商品行费用。

跟踪器 — publicrecords/etsy-shop-velocity

事件	USD
actor-start	$0.005
shop-row	$0.003
shop-history-record	$0.05
velocity-record	$0.10

实测费用：2 家店铺 → $0.011；5 家店铺 → $0.020。无需代理。

工具

使用 Bearer Apify 令牌，通过固定项 URL 实时调用 tools/list。公开的工具名称：

工具名称	用途
publicrecords--etsy-search-scraper	运行 Etsy Search Scraper（publicrecords/etsy-search-scraper）
publicrecords--etsy-shop-velocity	运行 Etsy Shop Sales Tracker（publicrecords/etsy-shop-velocity）
get-actor-run	获取指定 Actor 运行的详细信息
get-dataset-items	读取运行数据集中的项目
get-key-value-store-record	读取键值存储记录
abort-actor-run	中止正在运行的 Actor

Claude Desktop

添加到 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"
      }
    }
  }
}

如果你的 Claude Desktop 版本支持远程 MCP 服务，也可以使用 Apify 远程 MCP URL（包含上方固定项）。

Cursor

在 Cursor MCP 设置 / .cursor/mcp.json 中：

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

按 Cursor 提示登录 Apify。

示例提示词（实测）

1) Etsy 搜索——陶瓷马克杯，3 页

**提示词：**抓取 Etsy 上 ceramic mug 的搜索结果，最多 3 页（默认使用 Apify 美国住宅代理）。

运行：pRpdAMmfeMHdmuRXA——52.561 秒后 SUCCEEDED；36 条商品行；价格 / 店铺 / 标题字段填充率为 36/36；Console PPE $0.221。

前三条记录（简略）：KJPottery $57 bestsellers；BZceramics $35.50 popular_now；Neherpottery $35 bestsellers。

2）Etsy 店铺销量——两个指定店铺

**提示词：**跟踪 Etsy 店铺 OrelCeramics 和 Bestickend 的销量。

运行：lWWrFPgwZcu6DYYKe — 成功，耗时 5.314 秒；2 行店铺数据；Console 费用 $0.011；快照日期 2026-09-30。

店铺	销量	销量精度	评价数	评分	关注者	在售商品数	突增	快照日期
OrelCeramics	111	exact	34	5	252	44	false	2026-09-30
Bestickend	11400	rounded	1830	5	771	44	false	2026-09-30

本仓库不是什么

• 不是 Actor 实现、Docker 或基准真值集
• 不能替代 Apify Console 账单页面
• 与 Etsy, Inc. 无关联

站点导航页和教程

• 搜索导航页：https://geminigeorge22.github.io/etsy-search-scraper/
• 跟踪器导航页：https://geminigeorge22.github.io/etsy-shop-velocity/
• 搜索教程：https://geminigeorge22.github.io/blog/etsy-search-scraper/
• 跟踪器教程：https://geminigeorge22.github.io/blog/etsy-shop-sales-velocity/
• 发布者网站：https://geminigeorge22.github.io/

许可证

MIT——仅适用于本文档和配置。

由 Apify 上的 publicrecords 维护者发布。