连接器指南阅读约 2 分钟16 个 MCP 工具7 种语言

Squarespace MCP 服务器:订单、库存与商品

Squarespace 商务 API 用于一个站点:带有跟踪的订单和履行、库存水平和库存调整、产品和变体、客户档案和联系人,以及财务交易。API 密钥持有者。

HC作者:HelpCode 团队更新于 2 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Squarespace Commerce

Squarespace Commerce

Squarespace Commerce APIs for one site: orders and fulfillment with tracking, inventory levels and stock adjustments, products and variants, customer profiles and contacts, and financial transactions. API key bearer.

个工具

16

区域

INTL

类别

电子商务

身份验证

Bearer Token

所需环境变量

SQUARESPACE_API_KEY
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

Squarespace 商务 API 用于一个站点:带有跟踪的订单和履行、库存水平和库存调整、产品和变体、客户档案和联系人,以及财务交易。API 密钥持有者。

引导式设置

2 分钟将 Squarespace Commerce 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Squarespace Commerce,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Squarespace Commerce 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Squarespace Commerce · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Squarespace Commerce,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

Squarespace 商务

Squarespace 商务 API 用于一个站点:带有跟踪的订单和履行、库存水平和库存调整、产品和变体、客户档案和联系人,以及财务交易。API 密钥持有者。

设置

设置大约需要 3 分钟。

  1. 登录到 Squarespace 网站。在左侧导航中打开 Settings,滚动到 Advanced 并点击 Developer API Keys。API 密钥需要 Commerce Advanced 计划。
  2. 点击 Generate key,命名并选择权限:订单(读取和写入以进行履行)、库存(读取和写入以更改库存)、产品(只读)、档案、联系人和交易(只读)。
  3. 将密钥复制到 SQUARESPACE_API_KEY。Squarespace 仅显示一次;在站点活动期间不会过期。

每次调用都携带 Authorization: Bearer 和密钥以及 User-Agent 头,这是 Squarespace 所要求的。

从哪里开始:squarespace_commerce_get_website 确认站点,然后使用 squarespace_commerce_list_orders 和 fulfillment_status PENDING 获取待发货的订单。

订单: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(产品 API v2:类型 PHYSICAL、SERVICE、GIFT_CARD 和 DIGITAL;每个变体的价格和库存)。产品变更不包括在内。

人员:squarespace_commerce_list_contacts、squarespace_commerce_search_contacts、squarespace_commerce_get_contact(联系人 API)和较旧的 squarespace_commerce_list_profiles、squarespace_commerce_get_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。

速率限制:每个密钥每分钟 300 个请求;超过此限制,Squarespace 会返回 429 并阻止该密钥一分钟。

先决条件: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 读取一个订单:与 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在一次调用中更改变体的库存:按数量增加或减少,设置有限数量,或使变体无限制。需要一个…
squarespace_commerce_list_products列出产品,每页 50 条:id、type(PHYSICAL、SERVICE、GIFT_CARD、DIGITAL)、storePageId、name、description、url、urlSlug、tags…
squarespace_commerce_get_products通过 id 读取最多 50 个产品及其变体、定价、库存、属性和图像
squarespace_commerce_list_profiles列出档案(客户、邮件列表订阅者、捐赠者),每页 50 条:id、firstName、lastName、email、hasAccount、isCustomer…
squarespace_commerce_get_profiles通过 id 读取最多 50 个档案:姓名、电子邮件、地址、营销同意和 transactionsSummary
squarespace_commerce_list_contacts列出联系人(档案的继任者):id、firstName、lastName、email、phone、createdOn、defaultShippingAddress 和 marketing…
squarespace_commerce_search_contacts按名称或电子邮件文本搜索联系人,按要求排序:与 squarespace_commerce_list_contacts 相同的字段。只读,尽管它是一个…
squarespace_commerce_get_contact读取一个联系人:姓名、电子邮件、电话、地址和营销偏好
squarespace_commerce_list_transactions列出按订单或捐赠(文档)分组的财务交易,每页 50 条:id、createdOn、modifiedOn、customerEmail、salesOrderId…
squarespace_commerce_get_transactions通过 id 读取最多 50 个交易文档,包含付款、退款、费用和行项目。只读

示例提示

  • "哪些 Squarespace 订单仍在等待履行?"
  • "用 USPS 跟踪 9400111899223197428490 履行订单 1047 并发送电子邮件给客户。"
  • "哪些产品的库存少于 5 个单位?"
  • "将 20 个单位添加到变体 SKU MUG-WHT-12 的库存中。"
  • "显示上个月的交易和总处理费用。"

下一步

这份指南对你有帮助吗?

2 分钟将 Squarespace Commerce 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Squarespace Commerce,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

相关指南