Etsy Search & Shop Sales MCP

Etsy Search & Shop Sales MCP

CRM、ダッシュボード、リサーチワークフロー、AI アシスタント向けの Etsy 検索およびEtsy ショップの売上データを提供します。ライブ Etsy 検索の出品行とショップの売上カウンターを、Apify のホスト型 MCPまたは各 Store Actor から取得できます。

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 クライアント）
• パイプライン、CRM、ダッシュボード向けに Apify Console／API から Store Actor を直接利用

認証：求められたら、クライアントにご自身の 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。プロキシは不要です。

ツール

登録 URL に対するライブの tools/list（Bearer Apify トークン）で公開されるツール名：

ツール名	役割
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 検索 — ceramic mug、3ページ

プロンプト： Etsy で ceramic mug を検索し、最大3ページをスクレイピングします（デフォルトの Apify 米国レジデンシャル設定）。

実行： pRpdAMmfeMHdmuRXA — 52.561秒で SUCCEEDED。出品行36件、価格／ショップ／タイトルの取得率36/36、Console PPE $0.221。

最初の3行（抜粋）：KJPottery $57 bestsellers、BZceramics $35.50 popular_now、Neherpottery $35 bestsellers。

2）Etsy ショップの売上 — 2 つの指定ショップ

プロンプト： Etsy ショップ OrelCeramics と Bestickend の売上を追跡します。

実行： lWWrFPgwZcu6DYYKe — 5.314 秒で SUCCEEDED、ショップ行 2 件、Console のコスト $0.011、スナップショット 2026-09-30。

ショップ	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

このリポジトリに含まれないもの

• 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 メンテナーが公開しています。