In breve
API di Squarespace Commerce per un sito: ordini e evasione con tracciamento, livelli di inventario e aggiustamenti di stock, prodotti e varianti, profili e contatti dei clienti, e transazioni finanziarie. Portatore di chiave API.
Configurazione guidata
Collega Squarespace Commerce a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Squarespace Commerce con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Squarespace Commerce
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Squarespace Commerce, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Squarespace Commerce
API di Squarespace Commerce per un sito: ordini e evasione con tracciamento, livelli di inventario e aggiustamenti di stock, prodotti e varianti, profili e contatti dei clienti, e transazioni finanziarie. Portatore di chiave API.
Configurazione
La configurazione richiede circa 3 minuti.
- Accedi al sito Squarespace. Nella navigazione a sinistra apri Impostazioni, scorri fino a Avanzate e clicca su Chiavi API per sviluppatori. Le chiavi API richiedono un piano Commerce Advanced.
- Clicca su Genera chiave, dagli un nome e scegli i permessi: Ordini (Lettura e Scrittura per evadere), Inventario (Lettura e Scrittura per cambiare stock), Prodotti (Solo Lettura), Profili, Contatti e Transazioni (Solo Lettura).
- Copia la chiave in
SQUARESPACE_API_KEY. Squarespace la mostra solo una volta; non scade mentre il sito è attivo.
Ogni chiamata porta Authorization: Bearer con la chiave e un'intestazione User-Agent, che Squarespace richiede.
Dove iniziare: squarespace_commerce_get_website per confermare il sito, poi squarespace_commerce_list_orders con fulfillment_status PENDING per gli ordini da spedire.
Ordini: squarespace_commerce_list_orders, squarespace_commerce_get_order, e squarespace_commerce_fulfill_order (aggiunge spedizioni con tracciamento e segna l'ordine come evaso; può inviare un'email al cliente). Usa l'id dell'ordine nelle chiamate; orderNumber è ciò che il cliente vede. I rimborsi e le cancellazioni non fanno parte dell'API.
Inventario: squarespace_commerce_list_inventory, squarespace_commerce_get_inventory, squarespace_commerce_adjust_inventory. Ogni aggiustamento necessita di un nuovo idempotency_key (un UUID): reinviare la stessa chiave non fa nulla, il che rende sicuri i tentativi di ripetizione.
Prodotti: squarespace_commerce_list_products e squarespace_commerce_get_products (Products API v2: tipi FISICO, SERVIZIO, CARTA_REGALO e DIGITALE; prezzi e stock su ogni variante). Le modifiche ai prodotti non sono incluse.
Persone: squarespace_commerce_list_contacts, squarespace_commerce_search_contacts, squarespace_commerce_get_contact (Contacts API) e il più vecchio squarespace_commerce_list_profiles, squarespace_commerce_get_profiles (Profiles API, in modalità di manutenzione ma ancora quello con i totali degli ordini per cliente).
Denaro: squarespace_commerce_list_transactions e squarespace_commerce_get_transactions leggono pagamenti, rimborsi e commissioni per ordine o donazione; nulla qui muove denaro.
Paging e date: le liste restituiscono fino a 50 record con pagination.hasNextPage e pagination.nextPageCursor; passa il cursore da solo per ottenere la pagina successiva. modified_after e modified_before devono essere forniti insieme e sono in UTC ISO 8601. I valori monetari sono oggetti con currency e value (una stringa decimale). Gli strumenti get-by-id accettano fino a 50 id separati da virgole.
Limite di richiesta: 300 richieste al minuto per chiave; oltre a questo Squarespace risponde con 429 e blocca la chiave per un minuto.
Prerequisiti: SQUARESPACE_API_KEY
Installa il connettore localmente
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
Apri http://localhost:3000/connectors/store, scegli Squarespace Commerce e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
squarespace_commerce_get_website | Legge informazioni di base sul sito Squarespace a cui appartiene la chiave API: id, siteTitle, url, timeZone, currency, language e location.… |
squarespace_commerce_list_orders | Elenca gli ordini, modificati più di recente per primi, 50 per pagina: id, orderNumber, createdOn, modifiedOn, channel, customerEmail, customerId… |
squarespace_commerce_get_order | Legge un ordine per id: gli stessi campi di squarespace_commerce_list_orders, con tutti gli articoli, sconti, note interne e evasioni |
squarespace_commerce_fulfill_order | Segna un ordine come evaso e aggiunge spedizioni con data di spedizione, corriere, servizio, numero di tracciamento e URL di tracciamento. should_send_notification… |
squarespace_commerce_list_inventory | Elenca lo stock per tutte le varianti di prodotto, 50 per pagina: variantId, sku, descriptor (nome del prodotto e opzioni), isUnlimited e quantity. Prossimo… |
squarespace_commerce_get_inventory | Legge lo stock in tempo reale di varianti specifiche: variantId, sku, descriptor, isUnlimited e quantity |
squarespace_commerce_adjust_inventory | Cambia lo stock delle varianti in una chiamata: incrementa o decrementa di una quantità, imposta una quantità finita, o rende le varianti illimitate. Necessita di un… |
squarespace_commerce_list_products | Elenca i prodotti, 50 per pagina: id, tipo (FISICO, SERVIZIO, CARTA_REGALO, DIGITALE), storePageId, nome, descrizione, url, urlSlug, tags… |
squarespace_commerce_get_products | Legge fino a 50 prodotti per id con le loro varianti, prezzi, stock, attributi e immagini |
squarespace_commerce_list_profiles | Elenca i profili (clienti, iscritti alla mailing list, donatori), 50 per pagina: id, firstName, lastName, email, hasAccount, isCustomer… |
squarespace_commerce_get_profiles | Legge fino a 50 profili per id: nomi, email, indirizzo, consenso al marketing e transactionsSummary |
squarespace_commerce_list_contacts | Elenca i contatti (il successore dei profili): id, firstName, lastName, email, telefono, createdOn, defaultShippingAddress e marketing… |
squarespace_commerce_search_contacts | Cerca contatti per nome o testo email, ordinati come richiesto: gli stessi campi di squarespace_commerce_list_contacts. Solo lettura anche se è un… |
squarespace_commerce_get_contact | Legge un contatto: nomi, email, telefono, indirizzi e preferenze di marketing |
squarespace_commerce_list_transactions | Elenca le transazioni finanziarie raggruppate per ordine o donazione (un documento), 50 per pagina: id, createdOn, modifiedOn, customerEmail, salesOrderId… |
squarespace_commerce_get_transactions | Legge fino a 50 documenti di transazione per id, con pagamenti, rimborsi, commissioni e articoli. Solo lettura |
Esempi di richieste
- "Quali ordini Squarespace sono ancora in attesa di essere evasi?"
- "Evasione dell'ordine 1047 con tracciamento USPS 9400111899223197428490 e invia un'email al cliente."
- "Quali prodotti hanno meno di 5 unità in stock?"
- "Aggiungi 20 unità allo stock della variante SKU MUG-WHT-12."
- "Mostra le transazioni del mese scorso e le commissioni totali di elaborazione."
Prossimi passi
Questa guida ti è stata utile?