摘要
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 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Squarespace Commerce,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Squarespace 商务
Squarespace 商务 API 用于一个站点:带有跟踪的订单和履行、库存水平和库存调整、产品和变体、客户档案和联系人,以及财务交易。API 密钥持有者。
设置
设置大约需要 3 分钟。
- 登录到 Squarespace 网站。在左侧导航中打开 Settings,滚动到 Advanced 并点击 Developer API Keys。API 密钥需要 Commerce Advanced 计划。
- 点击 Generate key,命名并选择权限:订单(读取和写入以进行履行)、库存(读取和写入以更改库存)、产品(只读)、档案、联系人和交易(只读)。
- 将密钥复制到
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 的库存中。"
- "显示上个月的交易和总处理费用。"
下一步
这份指南对你有帮助吗?