Shopify

The Shopify adapter talks to the Storefront API and additionally auto-detects UCP. Any domain ending in *.myshopify.com is recognized as Shopify automatically, so you usually don’t even name the adapter explicitly.

import { ShoppingAgent, ShopifyAdapter, GeminiAdapter } from '@agorio/sdk';
 
const agent = new ShoppingAgent({
  llm: new GeminiAdapter({ apiKey: process.env.GEMINI_API_KEY }),
  merchants: [
    new ShopifyAdapter({
      shop: 'acme.myshopify.com',
      accessToken: process.env.SHOPIFY_STOREFRONT_TOKEN,
    }),
  ],
});

Authentication

Provide a Storefront API access token. The Storefront API is the public, customer-facing API, so the token scopes are read-catalog plus checkout creation — exactly what a shopping agent needs.

UCP auto-detection

If the Shopify store also publishes a UCP profile at /.well-known/ucp, the adapter detects it and prefers the UCP capabilities where available. This lets stores progressively adopt UCP without breaking existing Storefront-API-based agents.

Capabilities

List, search, get product, create checkout, and complete checkout. See the adapters registry for the capability matrix across all shipped adapters.

Overview WooCommerce