pp-squarespace

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/commerce/squarespace/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Squarespace — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `squarespace-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install squarespace --cli-only
   ```
2. Verify: `squarespace-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/commerce/squarespace/cmd/squarespace-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## Account Dashboard Auth

Commerce commands use `COMMERCE_AUTHORIZATION`. Account dashboard commands use a Cookie header from an authenticated `account.squarespace.com` browser session:

```bash
export SQUARESPACE_ACCOUNT_COOKIE_FILE="$HOME/.config/squarespace/account-cookie.txt"
```

Prefer `--name example.com` over internal IDs. The CLI resolves `/api/account/1/domains/byName/<domain>` first, then uses the returned domain, website, and contract IDs for follow-on calls. Do not bake account-specific Squarespace IDs into scripts or docs.

## Account Dashboard Commands

Use these for read-only domain, DNS, email forwarding, Google Workspace, and billing metadata:

```bash
squarespace-pp-cli account domain-summaries --page-size 50 --json
squarespace-pp-cli account domain get --name example.com --json
squarespace-pp-cli account domain custom-records --name example.com --json
squarespace-pp-cli account domain email-forwarding --name example.com --json
squarespace-pp-cli account domain email-mx-conflicts --name example.com --json
squarespace-pp-cli account domain billing-eligibility --name example.com --json
squarespace-pp-cli account domain billing-valid-terms --name example.com --json
squarespace-pp-cli account domain google-workspace-pricing --country-code US --json
```



## Command Reference

**1-0** — Manage 1 0

- `squarespace-pp-cli 1-0 adjust-inventory-stock-levels` — Adjusts stock quantities for product variants. Stock quantities can be added or subtracted, set with a given number,...
- `squarespace-pp-cli 1-0 create-order` — Creates an order using information from a third-party sales channel. A successful request creates an Order resource.
- `squarespace-pp-cli 1-0 create-webhook-subscription` — Creates a webhook subscription. A successful request returns the created Webhook Subscription resource.
- `squarespace-pp-cli 1-0 delete-webhook-subscription` — Deletes a webhook subscription.
- `squarespace-pp-cli 1-0 fulfill-order` — Updates the status of a specific order to fulfilled, with options to include shipment information and send a...
- `squarespace-pp-cli 1-0 get-documents-by-id` — Retrieves information for specific transaction Documents. The response contains up to 50 Documents. Multiple...
- `squarespace-pp-cli 1-0 get-documents-by-updated-on` — Retrieves all financial transactions for orders and donations. Per order and donation, the response groups...
- `squarespace-pp-cli 1-0 get-inventory-items` — Retrieves real-time stock information for all product variants. Stock information is stored in an InventoryItem for...
- `squarespace-pp-cli 1-0 get-member-profile` — Retrieves basic details about the Squarespace member who owns the provided OAuth token
- `squarespace-pp-cli 1-0 get-order` — Retrieves information for a specific order. The response contains order information in an Order.
- `squarespace-pp-cli 1-0 get-orders` — Retrieves information about all orders. Orders can be filtered by Customer ID and date ranges. The response contains...
- `squarespace-pp-cli 1-0 get-profiles` — Retrieves all profiles; profiles can be filtered and sorted. The response contains up to 50 Profiles and supports...
- `squarespace-pp-cli 1-0 get-specific-inventory-items` — Retrieves real-time stock information for specific product variants. Stock information is stored in an InventoryItem...
- `squarespace-pp-cli 1-0 get-specific-profiles` — Retrieves information for specific profiles. The response contains a list of up to 50 Profiles. Multiple Profiles...
- `squarespace-pp-cli 1-0 get-store-pages` — Retrieves information for all store pages on the website. The response supports dynamic cursors for pagination.
- `squarespace-pp-cli 1-0 get-webhook-subscription` — Retrieves information for a specific webhook subscription.
- `squarespace-pp-cli 1-0 get-webhook-subscriptions` — Retrieves information for all webhook subscriptions. The response contains up to 25 Webhook Subscriptions.
- `squarespace-pp-cli 1-0 get-website-profile` — Retrieves basic details about the website that owns the provided API key or OAuth token
- `squarespace-pp-cli 1-0 rotate-subscription-secret` — Rotates a webhook subscription's secret. The previous secret for a subscription is no longer valid after a new one...
- `squarespace-pp-cli 1-0 send-test-notification-for-webhook-subscription` — Sends a notification to a subscribed webhook endpoint for testing purposes. This is a one-time notification, and...
- `squarespace-pp-cli 1-0 update-webhook-subscription` — Updates information for a webhook subscription. A successful request returns the updated Webhook Subscription resource.

**commerce** — Manage commerce

- `squarespace-pp-cli commerce associate-product-variant-image` — Assigns a product image to a product variant. Specifying imageId of null will delete the association.
- `squarespace-pp-cli commerce create-product` — Creates a product with appropriate subresources based on product type.
- `squarespace-pp-cli commerce create-product-variant` — Creates a variant of a product. Creating a variant for a physical or service product requires that the product...
- `squarespace-pp-cli commerce delete-product` — Delete specified product
- `squarespace-pp-cli commerce delete-product-image` — Delete one product image
- `squarespace-pp-cli commerce delete-product-variant` — Delete one product variant
- `squarespace-pp-cli commerce get-product-image-processing-status` — Retrieves the processing status for an uploaded product image. A successful request indicates that a ProductImage is...
- `squarespace-pp-cli commerce get-products` — Retrieves information for products; products can be filtered within a date range and by product type. The response...
- `squarespace-pp-cli commerce get-specific-products` — Retrieves information for specific products, including information for any variants or images. Up to 50 products can...
- `squarespace-pp-cli commerce update-product` — Updates information for a product. The endpoint supports partial updates.
- `squarespace-pp-cli commerce update-product-image` — Updates information for a product image. Currently, the endpoint only supports updates to the alt text for an image.
- `squarespace-pp-cli commerce update-product-image-order` — Updates the ordering of a product image on the product details page.
- `squarespace-pp-cli commerce update-product-variant` — Updates a variant of a product. The endpoint supports partial updates.
- `squarespace-pp-cli commerce upload-product-image` — Uploads an image for a product. Uploading an image doesn't set the