Resumen
APIs de Comercio de Squarespace para un sitio: pedidos y cumplimiento con seguimiento, niveles de inventario y ajustes de stock, productos y variantes, perfiles y contactos de clientes, y transacciones financieras. Portador de clave API.
Configuración guiada
Conecta Squarespace Commerce a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Squarespace Commerce con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Squarespace Commerce
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Squarespace Commerce, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Squarespace Commerce
APIs de Comercio de Squarespace para un sitio: pedidos y cumplimiento con seguimiento, niveles de inventario y ajustes de stock, productos y variantes, perfiles y contactos de clientes, y transacciones financieras. Portador de clave API.
Configuración
Configurar toma aproximadamente 3 minutos.
- Inicia sesión en el sitio de Squarespace. En la navegación izquierda, abre Configuración, desplázate a Avanzado y haz clic en Claves API de Desarrollador. Las claves API necesitan un plan Commerce Advanced.
- Haz clic en Generar clave, asígnale un nombre y elige los permisos: Pedidos (Leer y Escribir para cumplir), Inventario (Leer y Escribir para cambiar stock), Productos (Solo Lectura), Perfiles, Contactos y Transacciones (Solo Lectura).
- Copia la clave en
SQUARESPACE_API_KEY. Squarespace la muestra solo una vez; no caduca mientras el sitio esté activo.
Cada llamada lleva Authorization: Bearer con la clave y un encabezado User-Agent, que Squarespace requiere.
Por dónde empezar: squarespace_commerce_get_website para confirmar el sitio, luego squarespace_commerce_list_orders con fulfillment_status PENDING para pedidos por enviar.
Pedidos: squarespace_commerce_list_orders, squarespace_commerce_get_order, y squarespace_commerce_fulfill_order (agrega envíos con seguimiento y marca el pedido como cumplido; puede enviar un correo al cliente). Usa el id del pedido en las llamadas; orderNumber es lo que ve el cliente. Los reembolsos y cancelaciones no son parte de la API.
Inventario: squarespace_commerce_list_inventory, squarespace_commerce_get_inventory, squarespace_commerce_adjust_inventory. Cada ajuste necesita un nuevo idempotency_key (un UUID): reenviar la misma clave no hace nada, lo que hace que los reintentos sean seguros.
Productos: squarespace_commerce_list_products y squarespace_commerce_get_products (API de Productos v2: tipos FÍSICO, SERVICIO, TARJETA_DE_REGALO y DIGITAL; precios y stock en cada variante). Los cambios de productos no están incluidos.
Personas: squarespace_commerce_list_contacts, squarespace_commerce_search_contacts, squarespace_commerce_get_contact (API de Contactos) y los más antiguos squarespace_commerce_list_profiles, squarespace_commerce_get_profiles (API de Perfiles, en modo de mantenimiento pero aún la que tiene totales de pedidos por cliente).
Dinero: squarespace_commerce_list_transactions y squarespace_commerce_get_transactions leen pagos, reembolsos y tarifas por pedido o donación; nada aquí mueve dinero.
Paginación y fechas: las listas devuelven hasta 50 registros con pagination.hasNextPage y pagination.nextPageCursor; pasa el cursor solo para obtener la siguiente página. modified_after y modified_before deben darse juntos y son UTC ISO 8601. Los valores monetarios son objetos con currency y value (una cadena decimal). Las herramientas de obtener por id aceptan hasta 50 ids separados por comas.
Límite de tasa: 300 solicitudes por minuto por clave; por encima de eso, Squarespace responde 429 y bloquea la clave durante un minuto.
Requisitos previos: SQUARESPACE_API_KEY
Instalar el conector 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
Abre http://localhost:3000/connectors/store, elige Squarespace Commerce y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
squarespace_commerce_get_website | Lee información básica sobre el sitio de Squarespace al que pertenece la clave API: id, siteTitle, url, timeZone, currency, language y location.… |
squarespace_commerce_list_orders | Lista pedidos, los más recientemente modificados primero, 50 por página: id, orderNumber, createdOn, modifiedOn, channel, customerEmail, customerId… |
squarespace_commerce_get_order | Lee un pedido por id: los mismos campos que squarespace_commerce_list_orders, con todos los artículos, descuentos, notas internas y cumplimientos |
squarespace_commerce_fulfill_order | Marca un pedido como cumplido y agrega envíos con fecha de envío, transportista, servicio, número de seguimiento y URL de seguimiento. should_send_notification… |
squarespace_commerce_list_inventory | Lista stock para todas las variantes de productos, 50 por página: variantId, sku, descriptor (nombre del producto y opciones), isUnlimited y quantity. Siguiente… |
squarespace_commerce_get_inventory | Lee stock en tiempo real de variantes específicas: variantId, sku, descriptor, isUnlimited y quantity |
squarespace_commerce_adjust_inventory | Cambia el stock de variantes en una llamada: incrementa o decrementa por una cantidad, establece una cantidad finita, o hace que las variantes sean ilimitadas. Necesita un… |
squarespace_commerce_list_products | Lista productos, 50 por página: id, type (FÍSICO, SERVICIO, TARJETA_DE_REGALO, DIGITAL), storePageId, name, description, url, urlSlug, tags… |
squarespace_commerce_get_products | Lee hasta 50 productos por id con sus variantes, precios, stock, atributos e imágenes |
squarespace_commerce_list_profiles | Lista perfiles (clientes, suscriptores de listas de correo, donantes), 50 por página: id, firstName, lastName, email, hasAccount, isCustomer… |
squarespace_commerce_get_profiles | Lee hasta 50 perfiles por id: nombres, email, dirección, consentimiento de marketing y transactionsSummary |
squarespace_commerce_list_contacts | Lista contactos (el sucesor de perfiles): id, firstName, lastName, email, phone, createdOn, defaultShippingAddress y marketing… |
squarespace_commerce_search_contacts | Busca contactos por nombre o texto de email, ordenados como se pida: los mismos campos que squarespace_commerce_list_contacts. Solo lectura aunque es un… |
squarespace_commerce_get_contact | Lee un contacto: nombres, email, teléfono, direcciones y preferencias de marketing |
squarespace_commerce_list_transactions | Lista transacciones financieras agrupadas por pedido o donación (un documento), 50 por página: id, createdOn, modifiedOn, customerEmail, salesOrderId… |
squarespace_commerce_get_transactions | Lee hasta 50 documentos de transacción por id, con pagos, reembolsos, tarifas y artículos. Solo lectura |
Ejemplos de prompts
- "¿Qué pedidos de Squarespace aún están esperando ser cumplidos?"
- "Cumple el pedido 1047 con seguimiento de USPS 9400111899223197428490 y envía un correo al cliente."
- "¿Qué productos tienen menos de 5 unidades en stock?"
- "Agrega 20 unidades al stock de la variante SKU MUG-WHT-12."
- "Muestra las transacciones del mes pasado y las tarifas de procesamiento totales."
Próximos pasos
¿Te ha sido útil esta guía?