概要
1つのサイトのためのSquarespace Commerce API: トラッキング付きの注文と履行、在庫レベルと在庫調整、製品とバリアント、顧客プロファイルと連絡先、そして財務取引。APIキーの保持者。
ガイド付きセットアップ
Squarespace Commerce を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Squarespace Commerce を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Squarespace Commerce のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセス。 サインインして、Connectors → Squarespace Commerceをクリックし、認証情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Squarespace Commerce
1つのサイトのためのSquarespace Commerce API: トラッキング付きの注文と履行、在庫レベルと在庫調整、製品とバリアント、顧客プロファイルと連絡先、そして財務取引。APIキーの保持者。
セットアップ
セットアップには約3分かかります。
- Squarespaceサイトにログインします。左側のナビゲーションでSettingsを開き、AdvancedまでスクロールしてDeveloper API Keysをクリックします。APIキーにはCommerce Advancedプランが必要です。
- Generate keyをクリックし、名前を付け、権限を選択します: Orders(履行のための読み取りと書き込み)、Inventory(在庫変更のための読み取りと書き込み)、Products(読み取り専用)、Profiles、Contacts、Transactions(読み取り専用)。
- キーを
SQUARESPACE_API_KEYにコピーします。Squarespaceはそれを一度だけ表示します; サイトがアクティブな限り期限切れにはなりません。
すべての呼び出しには、キーとUser-Agentヘッダーを含むAuthorization: Bearerが必要です。これはSquarespaceが要求します。
開始する場所: squarespace_commerce_get_websiteでサイトを確認し、その後fulfillment_statusがPENDINGの squarespace_commerce_list_ordersで出荷する注文を取得します。
注文: squarespace_commerce_list_orders、squarespace_commerce_get_order、およびsquarespace_commerce_fulfill_order(トラッキング付きの出荷を追加し、注文を履行済みとしてマークします; 顧客にメールを送信できます)。呼び出しには注文のidを使用します; orderNumberは顧客が見るものです。返金やキャンセルはAPIの一部ではありません。
在庫: squarespace_commerce_list_inventory、squarespace_commerce_get_inventory、squarespace_commerce_adjust_inventory。すべての調整には新しいidempotency_key(UUID)が必要です: 同じキーを再送信しても何も起こらず、リトライが安全になります。
製品: squarespace_commerce_list_productsおよびsquarespace_commerce_get_products(Products API v2: タイプ PHYSICAL、SERVICE、GIFT_CARD、DIGITAL; 各バリアントの価格と在庫)。製品の変更は含まれていません。
人々: squarespace_commerce_list_contacts、squarespace_commerce_search_contacts、squarespace_commerce_get_contact(Contacts API)および古いsquarespace_commerce_list_profiles、squarespace_commerce_get_profiles(Profiles API、メンテナンスモードですが、顧客ごとの注文合計があるものです)。
お金: squarespace_commerce_list_transactionsおよびsquarespace_commerce_get_transactionsは、注文または寄付ごとの支払い、返金、手数料を読み取ります; ここではお金は動きません。
ページングと日付: リストは最大50件のレコードを返し、pagination.hasNextPageおよびpagination.nextPageCursorを使用します; 次のページを取得するにはカーソルだけを渡します。modified_afterとmodified_beforeは一緒に指定する必要があり、UTC ISO 8601形式です。金額はcurrencyとvalue(小数文字列)を持つオブジェクトです。IDによる取得ツールは、カンマで区切られた最大50のIDを受け取ります。
レート制限: 1分あたり300リクエスト/キー; それを超えるとSquarespaceは429で応答し、1分間キーをブロックします。
前提条件: SQUARESPACE_API_KEY
コネクタをローカルにインストールする
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/storeを開き、Squarespace Commerceを選択し、前提条件の下にリストされている環境変数を貼り付けます。
利用可能なツール
| ツール | 機能 |
|---|---|
squarespace_commerce_get_website | APIキーが属するSquarespaceサイトの基本情報を読み取ります: id、siteTitle、url、timeZone、currency、language、location… |
squarespace_commerce_list_orders | 注文をリストし、最も最近修正されたものを最初に表示します。ページあたり50件: id、orderNumber、createdOn、modifiedOn、channel、customerEmail、customerId… |
squarespace_commerce_get_order | IDで1つの注文を読み取ります: squarespace_commerce_list_ordersと同じフィールドで、すべてのラインアイテム、割引、内部メモ、履行を含みます |
squarespace_commerce_fulfill_order | 注文を履行済みとしてマークし、出荷日、運送業者、サービス、トラッキング番号、トラッキングURLを持つ出荷を追加します。should_send_notification… |
squarespace_commerce_list_inventory | すべての製品バリアントの在庫をリストします。ページあたり50件: variantId、sku、descriptor(製品名とオプション)、isUnlimited、quantity。次… |
squarespace_commerce_get_inventory | 特定のバリアントのリアルタイム在庫を読み取ります: variantId、sku、descriptor、isUnlimited、quantity |
squarespace_commerce_adjust_inventory | 1回の呼び出しでバリアントの在庫を変更します: 数量を増減、有限数量を設定、またはバリアントを無制限にします。必要です… |
squarespace_commerce_list_products | 製品をリストします。ページあたり50件: id、type(PHYSICAL、SERVICE、GIFT_CARD、DIGITAL)、storePageId、name、description、url、urlSlug、tags… |
squarespace_commerce_get_products | 最大50の製品をIDで読み取り、それらのバリアント、価格、在庫、属性、画像を取得します |
squarespace_commerce_list_profiles | プロファイル(顧客、メーリングリストの購読者、寄付者)をリストします。ページあたり50件: id、firstName、lastName、email、hasAccount、isCustomer… |
squarespace_commerce_get_profiles | 最大50のプロファイルをIDで読み取ります: 名前、email、住所、マーケティング同意、transactionsSummary |
squarespace_commerce_list_contacts | 連絡先(プロファイルの後継)をリストします: id、firstName、lastName、email、phone、createdOn、defaultShippingAddress、マーケティング… |
squarespace_commerce_search_contacts | 名前またはメールテキストで連絡先を検索し、要求された順にソートします: squarespace_commerce_list_contactsと同じフィールド。読み取り専用ですが、これは… |
squarespace_commerce_get_contact | 1つの連絡先を読み取ります: 名前、email、電話、住所、マーケティングの好み |
squarespace_commerce_list_transactions | 注文または寄付(ドキュメント)ごとにグループ化された財務取引をリストします。ページあたり50件: id、createdOn、modifiedOn、customerEmail、salesOrderId… |
squarespace_commerce_get_transactions | 最大50の取引ドキュメントをIDで読み取り、支払い、返金、手数料、ラインアイテムを含みます。読み取り専用 |
例のプロンプト
- "どのSquarespaceの注文がまだ履行を待っていますか?"
- "USPSトラッキング9400111899223197428490で注文1047を履行し、顧客にメールを送信します。"
- "在庫が5未満の製品はどれですか?"
- "バリアントSKU MUG-WHT-12の在庫に20ユニットを追加します。"
- "先月の取引と総処理手数料を表示します。"
次のステップ
このガイドは役に立ちましたか?