# Send Squarespace to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "squarespace",
    "name": "Squarespace",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/byungkyu/squarespace",
    "canonicalUrl": "https://clawhub.ai/byungkyu/squarespace",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/squarespace",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=squarespace",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "LICENSE.txt"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "squarespace",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-09T09:18:45.540Z",
      "expiresAt": "2026-05-16T09:18:45.540Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=squarespace",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=squarespace",
        "contentDisposition": "attachment; filename=\"squarespace-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "squarespace"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/squarespace"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/squarespace",
    "downloadUrl": "https://openagent3.xyz/downloads/squarespace",
    "agentUrl": "https://openagent3.xyz/skills/squarespace/agent",
    "manifestUrl": "https://openagent3.xyz/skills/squarespace/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/squarespace/agent.md"
  }
}
```
## Documentation

### Squarespace

Access the Squarespace Commerce API with managed OAuth authentication. Manage products, inventory, orders, customer profiles, and transactions.

### Quick Start

# List all products (v2 API)
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/squarespace/v2/commerce/products')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('User-Agent', 'MyClaude/1.0')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

### Base URL

https://gateway.maton.ai/squarespace/{native-api-path}

Replace {native-api-path} with the actual Squarespace API endpoint path. The gateway proxies requests to api.squarespace.com and automatically injects your OAuth token.

### Authentication

All requests require the Maton API key in the Authorization header:

Authorization: Bearer $MATON_API_KEY

Environment Variable: Set your API key as MATON_API_KEY:

export MATON_API_KEY="YOUR_API_KEY"

### Getting Your API Key

Sign in or create an account at maton.ai
Go to maton.ai/settings
Copy your API key

### Connection Management

Manage your Squarespace OAuth connections at https://ctrl.maton.ai.

### List Connections

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=squarespace&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

### Create Connection

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'squarespace'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

### Get Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "connection": {
    "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
    "status": "ACTIVE",
    "creation_time": "2025-12-08T07:20:53.488460Z",
    "last_updated_time": "2026-01-31T20:03:32.593153Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "squarespace",
    "metadata": {}
  }
}

Open the returned url in a browser to complete OAuth authorization.

### Delete Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

### Specifying Connection

If you have multiple Squarespace connections, specify which one to use with the Maton-Connection header:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/squarespace/v2/commerce/products')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('User-Agent', 'MyClaude/1.0')
req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

If omitted, the gateway uses the default (oldest) active connection.

### Inventory

List All Inventory

GET /squarespace/1.0/commerce/inventory

Query parameters:

cursor (optional): Pagination cursor from previous response

Response:

{
  "inventory": [
    {
      "variantId": "5ba1418df4204bb2d21eac3f",
      "sku": "SQ0001",
      "descriptor": "Product Name - Size: Medium",
      "isUnlimited": false,
      "quantity": 25
    }
  ],
  "pagination": {
    "hasNextPage": true,
    "nextPageCursor": "abc123",
    "nextPageUrl": "https://api.squarespace.com/1.0/commerce/inventory?cursor=abc123"
  }
}

Get Specific Inventory

GET /squarespace/1.0/commerce/inventory/{variantIds}

{variantIds}: Comma-separated variant IDs (max 50)

Adjust Stock Quantities

POST /squarespace/1.0/commerce/inventory/adjustments
Content-Type: application/json
Idempotency-Key: unique-key-here

{
  "incrementOperations": [{"variantId": "variant-id-1", "quantity": 5}],
  "decrementOperations": [{"variantId": "variant-id-2", "quantity": 2}],
  "setFiniteOperations": [{"variantId": "variant-id-3", "quantity": 100}],
  "setUnlimitedOperations": ["variant-id-4"]
}

Response: 204 No Content on success

### Orders

List All Orders

GET /squarespace/1.0/commerce/orders

Query parameters:

customerId (optional): Filter by customer ID
modifiedAfter (conditional): ISO 8601 datetime (e.g., 2024-01-01T00:00:00Z) - required with modifiedBefore
modifiedBefore (conditional): ISO 8601 datetime - required with modifiedAfter
cursor (optional): Pagination cursor
fulfillmentStatus (optional): PENDING, FULFILLED, or CANCELED

Note: Cannot combine cursor with date range parameters. Date filters must be used together.

Response:

{
  "result": [
    {
      "id": "order-id",
      "orderNumber": "1001",
      "createdOn": "2024-01-15T10:30:00Z",
      "modifiedOn": "2024-01-15T12:00:00Z",
      "channel": "web",
      "testmode": false,
      "customerEmail": "customer@example.com",
      "fulfillmentStatus": "PENDING",
      "lineItems": [...],
      "subtotal": {"value": "99.99", "currency": "USD"},
      "shippingTotal": {"value": "9.99", "currency": "USD"},
      "taxTotal": {"value": "8.50", "currency": "USD"},
      "grandTotal": {"value": "118.48", "currency": "USD"}
    }
  ],
  "pagination": {
    "hasNextPage": true,
    "nextPageCursor": "abc123",
    "nextPageUrl": "..."
  }
}

Get Specific Order

GET /squarespace/1.0/commerce/orders/{orderId}

Create Order

POST /squarespace/1.0/commerce/orders
Content-Type: application/json
Idempotency-Key: unique-key-here

{
  "channelName": "External Store",
  "externalOrderReference": "ORDER-12345",
  "customerEmail": "customer@example.com",
  "lineItems": [
    {
      "lineItemType": "PHYSICAL_PRODUCT",
      "variantId": "variant-id",
      "quantity": 2,
      "unitPricePaid": {"currency": "USD", "value": "29.99"}
    }
  ],
  "subtotal": {"currency": "USD", "value": "59.98"},
  "priceTaxInterpretation": "EXCLUSIVE",
  "grandTotal": {"currency": "USD", "value": "59.98"},
  "createdOn": "2024-01-15T10:30:00Z"
}

Response: 201 Created with Order object

Note: subtotal must equal the sum of lineItems.unitPricePaid.value * quantity.

Fulfill Order

POST /squarespace/1.0/commerce/orders/{orderId}/fulfillments
Content-Type: application/json

{
  "shouldSendNotification": true,
  "shipments": [
    {
      "shipDate": "2024-01-16T08:00:00Z",
      "carrierName": "USPS",
      "service": "Priority Mail",
      "trackingNumber": "9400111899223456789012",
      "trackingUrl": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400111899223456789012"
    }
  ]
}

Response: 204 No Content on success

### Products

List Store Pages

GET /squarespace/1.0/commerce/store_pages

Query parameters:

cursor (optional): Pagination cursor

Response:

{
  "storePages": [
    {
      "id": "store-page-id",
      "title": "Main Store",
      "isEnabled": true,
      "urlSlug": "store"
    }
  ],
  "pagination": {...}
}

List All Products

GET /squarespace/v2/commerce/products

Query parameters:

modifiedAfter (optional): ISO 8601 datetime
modifiedBefore (optional): ISO 8601 datetime
type (optional): Comma-separated types: PHYSICAL, SERVICE, GIFT_CARD, DIGITAL
cursor (optional): Pagination cursor

Note: Cannot combine cursor with date/type filters.

Response:

{
  "products": [
    {
      "id": "product-id",
      "type": "PHYSICAL",
      "storePageId": "store-page-id",
      "name": "Product Name",
      "description": "<p>HTML description</p>",
      "url": "https://example.squarespace.com/store/product-slug",
      "urlSlug": "product-slug",
      "tags": ["tag1", "tag2"],
      "isVisible": true,
      "variants": [...],
      "images": [...],
      "createdOn": "2024-01-01T00:00:00Z",
      "modifiedOn": "2024-01-15T12:00:00Z"
    }
  ],
  "pagination": {...}
}

Get Specific Products

GET /squarespace/v2/commerce/products/{productIds}

{productIds}: Comma-separated product IDs (max 50)

Create Product

POST /squarespace/v2/commerce/products
Content-Type: application/json

{
  "type": "PHYSICAL",
  "storePageId": "store-page-id",
  "name": "New Product",
  "description": "<p>Product description</p>",
  "urlSlug": "new-product",
  "tags": ["new", "featured"],
  "isVisible": true,
  "variants": [
    {
      "sku": "SKU-001",
      "pricing": {
        "basePrice": {"currency": "USD", "value": "49.99"}
      },
      "stock": {"quantity": 100, "unlimited": false}
    }
  ]
}

Response: 201 Created with Product object

Update Product

POST /squarespace/v2/commerce/products/{productId}
Content-Type: application/json

{
  "name": "Updated Product Name",
  "description": "<p>Updated description</p>",
  "isVisible": true,
  "tags": ["updated", "sale"]
}

Response: 200 OK with Product object

Delete Product

DELETE /squarespace/v2/commerce/products/{productId}

Response: 204 No Content on success

### Product Variants

Create Variant

POST /squarespace/v2/commerce/products/{productId}/variants
Content-Type: application/json

{
  "sku": "SKU-002",
  "pricing": {
    "basePrice": {"currency": "USD", "value": "59.99"},
    "salePrice": {"currency": "USD", "value": "49.99"},
    "onSale": true
  },
  "stock": {"quantity": 50, "unlimited": false},
  "attributes": {"Size": "Large"},
  "shippingMeasurements": {
    "weight": {"unit": "POUND", "value": 1.5},
    "dimensions": {"unit": "INCH", "length": 10, "width": 8, "height": 4}
  }
}

Response: 201 Created with ProductVariant object

Note: To use attributes, the product must first have matching variantAttributes set via Update Product (e.g., "variantAttributes": ["Size"]).

Update Variant

POST /squarespace/v2/commerce/products/{productId}/variants/{variantId}
Content-Type: application/json

{
  "sku": "SKU-002-UPDATED",
  "pricing": {
    "basePrice": {"currency": "USD", "value": "64.99"},
    "onSale": false
  }
}

Response: 200 OK with ProductVariant object

Note: Stock and images cannot be updated via this endpoint.

Delete Variant

DELETE /squarespace/v2/commerce/products/{productId}/variants/{variantId}

Response: 204 No Content on success

Note: Cannot delete the only variant of a product.

### Product Images

Upload Image

POST /squarespace/v2/commerce/products/{productId}/images
Content-Type: multipart/form-data

curl "https://gateway.maton.ai/squarespace/v2/commerce/products/{productId}/images" \\
  -H "Authorization: Bearer $MATON_API_KEY" \\
  -H "User-Agent: MyClaude/1.0" \\
  -X POST \\
  -F file=@image.png

Response: 202 Accepted

{
  "imageId": "image-id"
}

Requirements:

Dimensions: less than 60MP
File types: JPEG, JPG, PNG, GIF
Max file size: 20MB (under 500KB recommended)
Max 100 images per product

Check Upload Status

GET /squarespace/v2/commerce/products/{productId}/images/{imageId}/status

Response:

{
  "status": "PROCESSING"
}

Status values: PROCESSING, READY, ERROR

Update Image (Alt Text)

POST /squarespace/v2/commerce/products/{productId}/images/{imageId}
Content-Type: application/json

{
  "altText": "Product image description"
}

Response: 200 OK with ProductImage object

Reorder Image

POST /squarespace/v2/commerce/products/{productId}/images/{imageId}/order
Content-Type: application/json

{
  "afterImageId": "other-image-id"
}

Use null for afterImageId to move image to the top.

Response: 204 No Content

Assign Image to Variant

POST /squarespace/v2/commerce/products/{productId}/variants/{variantId}/image
Content-Type: application/json

{
  "imageId": "image-id"
}

Use null for imageId to remove the image from the variant.

Response: 204 No Content

Delete Image

DELETE /squarespace/v2/commerce/products/{productId}/images/{imageId}

Response: 204 No Content

### Profiles (Customers)

List All Profiles

GET /squarespace/1.0/profiles

Query parameters:

cursor (optional): Pagination cursor
filter (optional): Semicolon-separated filters (e.g., isCustomer,true;hasAccount,true)
sortDirection (optional): asc or dsc (default: dsc)
sortField (optional): createdOn, id, email, or lastName (default: id)

Filter options:

isCustomer,true or isCustomer,false
hasAccount,true or hasAccount,false
email,customer@example.com

Response:

{
  "profiles": [
    {
      "id": "profile-id",
      "firstName": "John",
      "lastName": "Doe",
      "email": "john@example.com",
      "hasAccount": true,
      "isCustomer": true,
      "createdOn": "2024-01-01T00:00:00Z",
      "address": {
        "address1": "123 Main St",
        "city": "New York",
        "state": "NY",
        "countryCode": "US",
        "postalCode": "10001"
      },
      "acceptsMarketing": true,
      "transactionsSummary": {
        "orderCount": 5,
        "totalOrderAmount": {"value": "499.95", "currency": "USD"}
      }
    }
  ],
  "pagination": {...}
}

Get Specific Profiles

GET /squarespace/1.0/profiles/{profileIds}

{profileIds}: Comma-separated profile IDs (max 50)

### Transactions

List All Transactions

GET /squarespace/1.0/commerce/transactions

Query parameters:

modifiedAfter (conditional): ISO 8601 datetime - required with modifiedBefore
modifiedBefore (conditional): ISO 8601 datetime - required with modifiedAfter
cursor (optional): Pagination cursor

Note: Date filters must be used together (both modifiedAfter and modifiedBefore are required when filtering by date).

Response:

{
  "documents": [
    {
      "id": "document-id",
      "createdOn": "2024-01-15T10:30:00Z",
      "modifiedOn": "2024-01-15T12:00:00Z",
      "customerEmail": "customer@example.com",
      "salesOrderId": "order-id",
      "voided": false,
      "totalSales": {"value": "99.99", "currency": "USD"},
      "totalNetSales": {"value": "99.99", "currency": "USD"},
      "totalTaxes": {"value": "8.50", "currency": "USD"},
      "total": {"value": "108.49", "currency": "USD"},
      "payments": [
        {
          "id": "payment-id",
          "amount": {"value": "108.49", "currency": "USD"},
          "creditCardType": "VISA",
          "provider": "STRIPE",
          "paidOn": "2024-01-15T10:35:00Z"
        }
      ]
    }
  ],
  "pagination": {...}
}

Get Specific Transactions

GET /squarespace/1.0/commerce/transactions/{documentIds}

{documentIds}: Comma-separated document IDs (max 50)

### Pagination

Squarespace uses cursor-based pagination. Response includes:

{
  "pagination": {
    "hasNextPage": true,
    "nextPageCursor": "cursor-value",
    "nextPageUrl": "https://api.squarespace.com/..."
  }
}

To get the next page, use the cursor parameter:

GET /squarespace/v2/commerce/products?cursor=cursor-value

### JavaScript

const response = await fetch(
  'https://gateway.maton.ai/squarespace/v2/commerce/products',
  {
    headers: {
      'Authorization': \`Bearer ${process.env.MATON_API_KEY}\`,
      'User-Agent': 'MyClaude/1.0'
    }
  }
);
const data = await response.json();
console.log(data.products);

### Python

import os
import requests

response = requests.get(
    'https://gateway.maton.ai/squarespace/v2/commerce/products',
    headers={
        'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}',
        'User-Agent': 'MyClaude/1.0'
    }
)
products = response.json()['products']

### Notes

Products API uses version v2 (e.g., /squarespace/v2/commerce/products)
Store Pages endpoint uses version 1.0 (e.g., /squarespace/1.0/commerce/store_pages)
Inventory, Orders, Profiles, and Transactions APIs use version 1.0
All requests require a User-Agent header describing your application
Requests without a custom User-Agent are subject to stricter rate limits
Maximum 50 items per batch request (inventory, products, profiles, transactions)
Create Order has a stricter rate limit: 100 requests per hour per website
Idempotency-Key header is required for stock adjustments and order creation
IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments

### Rate Limits

General: 300 requests per minute (5 per second)
Create Order: 100 requests per hour per website (with API key auth)
Exceeding limits returns 429 Too Many Requests with a one-minute cooldown

### Error Handling

StatusMeaning400Invalid request parameters or missing Squarespace connection401Invalid or missing Maton API key404Resource not found405Method not allowed for product type409Conflict (duplicate SKU, concurrent modification, etc.)429Rate limited4xx/5xxPassthrough error from Squarespace API

### Troubleshooting: API Key Issues

Check that the MATON_API_KEY environment variable is set:

echo $MATON_API_KEY

Verify the API key is valid by listing connections:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

### Troubleshooting: Invalid App Name

Ensure your URL path starts with squarespace. For example:

Correct: https://gateway.maton.ai/squarespace/1.0/commerce/products
Incorrect: https://gateway.maton.ai/1.0/commerce/products

### Resources

Squarespace Commerce APIs Overview
Inventory API
Orders API
Products API
Profiles API
Transactions API
Maton Community
Maton Support
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: byungkyu
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-09T09:18:45.540Z
- Expires at: 2026-05-16T09:18:45.540Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/squarespace)
- [Send to Agent page](https://openagent3.xyz/skills/squarespace/agent)
- [JSON manifest](https://openagent3.xyz/skills/squarespace/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/squarespace/agent.md)
- [Download page](https://openagent3.xyz/downloads/squarespace)