Etsy Seller MCP Hub

Etsy Seller MCP Hub

Official MCP Registry

Etsy セラー向けのオープンソース MCP サーバーです。 AI アシスタント、スクリプト、またはローカルアプリケーションを使って、自身の Etsy ショップの出品、注文、在庫、パーソナライズ設定、メディアを管理できます。Etsy Open API v3 を基盤とし、79 個の MCP ツール、CLI、ローカル HTTP ゲートウェイを備えています。

これはセラー向けのショップ管理ツールキットです。消費者向けの価格監視、購入者向けのお買い得品検索、ショッピングの自動化は行いません。

初回セットアップ · セキュリティレビュー · コネクターのトラブルシューティング · MCP 設定 · セラーワークフローのデモ · 既存の API キー · ホスティングとプライバシー · ロードマップ · Glama の掲載ページ · FAQ · ディレクトリ

「Etsy」という用語は Etsy, Inc. の商標です。このアプリケーションは Etsy の API を使用していますが、Etsy による推奨または認定を受けていません。

セラーは何ができますか？

• 有効な出品と在庫を確認し、注文、取引、ショップデータ、配送設定を確認できます。
• 承認済みの出品、在庫、パーソナライズ設定を更新し、商品画像、動画、ファイルをアップロードできます。
• Etsy の現行 Open API v3 エンドポイントを 79 個の MCP ツールから利用でき、必要に応じて高度な raw API 操作も実行できます。
• 同じセラーワークフローを etsyctl CLI、ローカル HTTP API、または互換性のある AI クライアントから実行できます。

プロンプトの例：「有効な出品のうち、在庫が少ないものはどれですか？」「支払い済みで未発送の注文を ID 付きで表示してください」「出品 123456789 のパーソナライズ設定を確認してください」「これらの出品変更を承認用に準備してください」。

セラー向けの読み取り専用ワークフロー：etsy_report_low_stock（範囲を限定した在庫スキャン）と etsy_report_unshipped（顧客データを最小限に抑制）。CLI での同等のコマンド：etsyctl report low-stock と etsyctl report unshipped。

インターフェース	対象ユーザー	ステータス
ローカル MCP（stdio）	Claude Desktop、Cursor、その他の互換クライアント	利用可能
CLI / etsyctl	スクリプト、セラー向け自動化、バックエンドエージェント	利用可能
ローカル HTTP / GPT Actions	セラー向け連携	利用可能
HTTPS 経由のリモート MCP	非公開のオーナー専用 ChatGPT コネクター	実装済み、制限あり
関係のない複数のショップ向けの単一公開サーバー	マルチテナント SaaS 運用者	未実装

クイックスタート

Etsy の認証とオペレーティングシステムの詳細については、ステップごとのガイドをご覧ください。

Node.js 22 以降と、承認済みの Etsy Open API v3 アプリおよび認証情報が必要です。

npm からインストール

公開パッケージを npm からインストールします。

npm install -g etsy-seller-mcp-hub
etsyctl init --shop-id 12345678    # replace with your actual shop ID
etsyctl doctor                    # inspect local config, then enter your own credentials
# Complete Etsy OAuth as documented in docs/QUICKSTART.md
etsy-mcp

npm パッケージ名は etsy-seller-mcp-hub です。初回利用時は、MCP クライアントの設定に ETSY_MCP_READ_ONLY=1 を追加してください。インストールされるコマンドは etsy-mcp（ローカル MCP サーバー）と etsyctl（CLI）のままです。

ソースから実行

git clone https://github.com/Bl0ck154/etsy-seller-mcp-hub.git
cd etsy-seller-mcp-hub
cp config.example.json /tmp/etsy-seller-config.json
# Edit shop_id, credential paths, and local backup paths in the copied JSON.
export ETSY_HUB_CONFIG=/tmp/etsy-seller-config.json
node bin/etsyctl.mjs shops
node bin/etsy-mcp.mjs

設定例では Linux のファイルシステム上のパスを使用しています。お使いのコンピューターの絶対パスに置き換えてください。キーやトークンは絶対にコミットしないでください。shops コマンドは設定済みのショップエイリアスを一覧表示しますが、ショップのライブ操作には OAuth が必要です。credentials.example.json と MCP クライアントのセットアップをご覧ください。

CLI の使用例

etsyctl --help
etsyctl doctor
etsyctl report low-stock --threshold 3 --limit 10 --offset 0
etsyctl report unshipped --limit 20 --offset 0

販売者レポートは読み取り専用であり、有料／未発送の概要に購入者の連絡先情報は含まれません。

CLI の高度な使用例

etsyctl listing list active --limit 100
etsyctl listing get 1234567890
etsyctl inventory get 1234567890
etsyctl orders list --limit 20 --paid true
etsyctl personalization get 1234567890
etsyctl images list 1234567890
etsyctl request GET /application/shops/12345678/sections

以前の Etsy API キーは使えますか？

はい。Etsy Open API v3 用として既に承認されたキーがあり、必要な OAuth 認証を取得している場合は使えます。 Etsy の 2026 年 7 月の Seller App ティアは、新しいショップオーナーがより簡単に承認を受けるための方法です。Etsy は、既に Personal Key を保有している販売者は、現在のキーで同等のアクセスが可能なため、この新しいティアの対象外であると明言しています。

MCP は AI クライアント向けのインターフェースを追加するものであり、Etsy の権限を変更するものではありません。他の販売者の Etsy トークンを収集する共有サーバーは運用していません。Seller App は自分のショップ専用です。無関係な販売者向けに 1 つのサービスを運用する開発者には、適切な Etsy アクセス（Personal App および必要に応じて Commercial Access）と、安全なマルチテナント OAuth が必要ですが、このリポジトリでは現在実装されていません。セルフホストする各ユーザーは、自分自身の認証済み認証情報を設定する必要があります。

既存のキー、Seller App、Commercial Access に関する Etsy API アクセスをお読みください。

認証とセキュリティ

Etsy v3 では、x-api-key ヘッダーに keystring と共有シークレットが必要です。非公開の販売者データへのアクセスや書き込み操作には、さらに OAuth 2.0 スコープが必要です。ハブは OAuth PKCE、更新、再試行、レート制限に対応しています。ショップを認証するには、次の手順を実行してください。

etsyctl oauth start --shop main --redirect https://your-registered-callback.example/oauth/callback
etsyctl oauth complete --state STATE --code CODE

OAuth 後、ハブは設定されたショップの所有権を検証します。トークンをローテーションする他のプログラムから更新トークンをコピーしないでください。

ローカル HTTP の場合：

ETSY_HUB_CONFIG=/absolute/path/config.json node src/server.mjs

サービスはデフォルトで 127.0.0.1 にバインドされ、内部ベアラートークンがない場合は外部へのバインドを拒否します。リモートで使用する場合は、認証付き TLS と適切なアクセス制御を追加してください。既存のリモート MCP OAuth がサポートするのは、非公開でオーナーが承認した ChatGPT クライアントであり、一般的なサードパーティの販売者ログインではありません。

セルフホスト型の公開 MCP は、フルモードで 79 個のツールを公開します。ETSY_MCP_READ_ONLY=1 を設定すると、読み取り専用と注釈された 53 個のツールのみが公開されます。書き込みを有効にするには、読み取り専用の変数を削除し、必要な Etsy OAuth 書き込みスコープを付与して、自分のショップを再認証してください。フルアクセスの手順。これは追加のツールフィルターであり、Etsy OAuth の権限に代わるものではありません。型付きの出品、在庫、メディアへの書き込みでは、対応している場合にバックアップが作成されます。生の API 書き込みでは自動スナップショットは作成されません。AI クライアントに書き込みアクセスを許可する前に、実際の変更内容を確認してください。

Docker

docker build -t etsy-seller-mcp-hub:local .
docker run --rm --name etsy-seller-mcp-hub -p 127.0.0.1:3737:3737 -v /absolute/etsy-data:/data:rw -e ETSY_HUB_CONFIG=/data/config.json etsy-seller-mcp-hub:local

Docker 内では、server.host を 0.0.0.0 に設定し、空でない server.auth_token_file を指定してください。指定しない場合、起動時に外部へのバインドが拒否されます。ホストポートは localhost のみに公開するか、認証付き HTTPS の背後で公開してください。Dockerfile は非 root ユーザーとして実行されます。

開発

npm run check
npm test
npm pack --dry-run --ignore-scripts

テストではモックを使用し、実際のショップには書き込みを行いません。貢献ガイド、セキュリティ、MIT ライセンスをご覧ください。

© 2026 Bl0ck154。Etsy 販売者向けの認証済み連携に対応する、独立したオープンソースソフトウェアです。

マルチパートのメディアアップロードでは、デフォルトでリクエストごとにデコード済みファイルを最大 64 MiB に制限しています。より大きなファイルを扱うには、ETSY_HUB_MAX_UPLOAD_BYTES（バイト単位、最大 192 MiB）を設定してください。ローカルファイルパスを使ったマルチパートアップロードは、64 KiB のチャンクでストリーミングされるようになりました。リモート MCP からの base64 JSON アップロードは引き続きバッファーに保持され、サイズ制限が適用されます。