MakeBox for Etsy

Etsy 向け MakeBox

バージョン 0.3.4 では、Etsy SEO ストラテジストと、ガイド付きの7つのワークフローを利用できます。MCP 接続がなくても便利に使えます。商品情報、写真、貼り付けた商品リスティング、または CSV を渡すと、そのままコピーして使える完全な項目、設定用ワークシート、未確認の事実を明示した一覧を受け取れます。同じナレッジを使って、出品者が認証した MakeBox ワークスペース経由で接続操作を行うこともできます。

マネージャーは SEO、商品の位置付け、コンバージョンにつながるコピー、オプション、配送、慎重なショップ運営を組み合わせます。素材、パッケージサイズ、検索ボリューム、配送の約束、ランキング結果を推測することはありません。長い説明文は、事実に関するセクションを維持したまま全文を返します。作成例と記入式テンプレートで、出力例を確認できます。

コネクターを使わずに利用する

「この商品情報から完全な商品リスティングを作成して」「仕様を損なわずに、貼り付けた説明文を改善して」「キーワード CSV を分析して」などと依頼してください。このプラグインは、タイトル、完全な説明文、タグ、該当する属性・素材、パーソナライズ、オプション、配送・デジタル設定を用意します。不足している情報は、購入者向けのコピーとは別に一覧表示されます。手動で引き継ぐ際は、Etsy に貼り付ける項目や選択する項目と、公開前に確認すべき内容を出品者に伝えます。説明コンテンツを利用するためのアカウント、トークン、サブスクリプションは不要です。ただし、ホスト側独自のモデルやアクセスに関するルールは適用されます。

スタンドアロンパッケージには、空の MCP 設定とともに、同じスキル、役割、ガイド、例、オプションの QA が含まれています。接続版パッケージにはリモート MakeBox の宣言が追加されます。ツールに接続していない場合でも、編集作業は引き続き利用できます。エージェント定義があっても、すべてのクライアントで別個のエージェントが起動されるわけではありません。スキルには対応していてもエージェントファイルには対応していないクライアントでは、調整用スキルが役割を担います。

Etsy のライブ操作（オプション）

サーバーは、MakeBox のワークフローとともに、2026年10月1日付の公式 Etsy API スナップショットに含まれる105件すべての操作に対応するアダプターを公開しています。付属の操作インデックスと入力スキーマは、10月4日にローカルランタイムと照合済みです。ライブのツールスキーマが常に優先されます。対象は公開済み API の操作であり、Etsy のウェブサイトのすべての機能を網羅するものではありません。利用可否は、スコープ、アプリへのアクセス権、有効な商品データ、MakeBox へのアクセス権によって異なります。Etsy への直接接続では、別のモデルを呼び出したり MakeBox AI の利用枠を消費したりしませんが、Etsy の手数料が発生する場合があります。

接続して使用する

接続版をインストールし、ライブ操作が必要なときに OAuth で MakeBox に接続します。list_shops と get_account_status を使って、ワークスペースとアクセス権を確認します。非公開の操作では出品者のショップが対象になります。公開情報の調査では、ほかのショップを参照できます。コピーの作成には接続は必要ありません。

「このリスティングの配送プロファイルを変更して」「完成したコピーから Etsy の下書きを作成して」「最新の注文と支払い台帳を表示して」「関連するキーワードを調査して」などと試してみてください。Claude は、プラグインに固定リストとして埋め込まれた情報ではなく、ライブのツールスキーマを使用します。既存の会話で新しく追加されたツールが表示されない場合は、コネクターを更新するか、新しい会話を開始してください。ツールの検出とキャッシュの動作はクライアントによって異なります。

直接 etsy_* 操作を行う場合、Etsy ID を使用し、事前に MakeBox へインポートする必要はありません。書き込みには、対象と値を明示した許可が必要です。HTTP レスポンスの成功だけでは、最新の読み戻しによって最終状態が確認されたことにはなりません。既存の MakeBox の下書き、調査、最適化、一括ジョブ用ツールも、これらのワークフローを依頼すれば引き続き利用できます。この MCP コネクターでは、画像や動画の生成はできません。既存のファイルはアップロードして管理できます。

データとサポート

コネクターは選択したツールのリクエストを https://mcp.makebox.ai/mcp の MakeBox に送信し、MakeBox は販売者の OAuth 認証を使って Etsy を呼び出します。直接操作の対象には、出品情報、注文と購入者の詳細、配送情報、支払い記録、ショップポリシーなどが含まれる場合があります。販売者のタスクに必要なデータのみを表示してください。オプションの個人用 Etsy メールアドレス／住所メソッドには、Etsy の追加の同意が必要です。通常の接続でこれらの権限が自動的に付与されることはありません。

プラグインには認証情報も、自律的に動作するバックグラウンドワーカーも含まれていません。オプションの Python スクリプトは、ローカルで構造チェックを実行し、参照ファイルを作成します。ネットワークへの接続、クレジットの消費、Etsy 上の操作は行いません。また、これらを自動実行するフックはありません。販売者が所有するファイルは、get_upload_link または Asset Library を通じて、認可された範囲内でのみアップロードされます。直接のマルチパートフィールドでは asset_id を使用してください。トークンや任意のパスを共有しないでください。

MakeBox ホームページ、プラグインのドキュメント、プライバシーポリシー、利用規約、サポート／お問い合わせページをご覧ください。プラグインの利用には、同梱のプロプライエタリライセンスが適用されます。

コンポーネント

• agents/makebox-etsy-manager.md：Cowork と Claude Code で作業を調整します。
• skills/makebox-shop-manager/SKILL.md：通常の Claude チャットにおける調整役です。
• skills/use-etsy-api/SKILL.md：直接 API の探索、認可、通信、読み戻しを行います。
• skills/create-etsy-listing/SKILL.md：出品の下書き、オプション、ポリシー、メディアを一通り作成します。
• skills/optimize-etsy-listing/SKILL.md：チャットで作成した改善案、または明示的に依頼された MakeBox AI ジョブを扱います。
• skills/manage-etsy-orders/SKILL.md：現在の注文、取引、支払い記録、認可された注文処理を扱います。
• skills/research-etsy-market/SKILL.md：公開されている Etsy の情報と MakeBox のキーワードに関する根拠を調査します。
• skills/manage-etsy-shop/SKILL.md：配送、返品、セクション、処理、ショップ設定を管理します。
• references/direct-etsy-api-guide.md：直接コネクターの仕様と使用例を記載します。
• .mcp.json：リモートサーバーの URL です。サーバーコードと認証情報は同梱されていません。

ナレッジとチェック

プラグインのマップは、エージェント／スキルから、事実情報、コピー、キーワードの根拠、バリエーション、パーソナライズ、配送／梱包、メディア／デジタル、注文、API レシピ、105 個のスキーマへと案内します。すべてのコピー作成リクエストにカタログ全体を読み込ませるのではなく、タスクに応じたガイドを段階的に読み込んでください。

オプションのローカルチェック（Python 3）：

python3 scripts/check-listing.py examples/physical-desk-sign.json
python3 scripts/check-listing.py examples/digital-weekly-planner.json
python3 tests/test-listing-qa.py
uv run --with PyYAML --with jsonschema python scripts/validate-bundle.py

generated QA は、スペースで単語を区切る言語について、重複のない複数語のフレーズを 13 個要求します。--mode native は、内部の AI ゲートを強制せずに、タグ数と長さの構造をネイティブ形式でチェックします。これらのチェックでは、情報の真偽、関連性、知的財産権、Etsy の状態、SEO の成果は検証できません。実質的なリリースチェックリストを使用してください。

API リファレンスを更新するには、python3 scripts/build-api-reference.py <official-operation-manifest.json> --date YYYY-MM-DD を実行します。実際のランタイムからエクスポートしたファイルと比較するには、validate-bundle.py --runtime-schemas <export.json> を実行します。レシピに記載されている ID は説明用です。変更せずに実行してはいけません。

エージェントファイルが読み込まれない場合、Claude チャットでは調整用スキルを使用します。対応する Cowork／Code ランタイムでは、マネージャーエージェントを読み込めます。Codex のパッケージでは、サポートされていないエージェントローダーがあると主張せず、オンボーディングスキルを通じて同じ役割を提供します。Muse コネクターのインストールだけでは、これらの Markdown 指示はインストールされません。Muse が実際に提供する機能を通じてのみインポートするか、プロジェクトの指示として使用してください。リモートツールの変更は MCP から提供されます。ナレッジの変更にはプラグインの更新が必要です。アーカイブの準備や GitHub パッケージの更新が済んでも、マーケットプレイスの審査が承認されたことにはなりません。CHANGELOG.mdをご覧ください。