AI NewsDev toolsAnnouncement

Shopify published two open reference agents for stores and merchants

Shopify has published an Apache-licensed pair of reference agents built on Anthropic's commerce-agents reference code, one for a storefront shopping assistant against a real Shopify store and one for a merchant agent over the Admin API.

AI News

Editorial2 min read

LinkedInX
GitHub social card for the Shopify claude-for-commerce-examples repository

Image: GitHub

Why it mattersA team building a commerce agent no longer has to design the structure from nothing: they can start from Shopify's own implementation of the UCP and Admin API integrations and change only the parts that differ.

Shopify has published claude-for-commerce-examples, a pair of working agents built on Anthropic's commerce-agents reference code that connect directly to a real Shopify store. The repository is in the Shopify GitHub organisation, uses the Apache 2.0 licence, was created on 1 September, and has gained 95 stars in its first three days.

The storefront agent

The storefront/ example runs the reference code's shopping agent against a live Shopify store over the UCP endpoints Shopify documents at /docs/agents. Given any domain that serves /.well-known/ucp, the agent searches the store's catalog, builds a real cart, answers questions from the store's own policies and FAQs, and sends the buyer to Shopify's checkout page for payment. The web app takes its branding from the store: name, logo, colours, and best-sellers all come from the same source. The example never places an order or takes payment; checkout, shipping, and payment all happen on Shopify's own pages.

Sign in with Shop is optional

With Shop app credentials, buyers can sign in and the catalog search returns personalised results. Without them, the sign-in routes return 503 and every session is a guest, with an identical experience to running with no credentials at all. Buyer tokens are kept server-side, keyed by session, and never reach the model, the browser, or the logs; each catalog request pairs the token with the buyer's IP address as the catalog requires.

The merchant agent

The merchant/ example is the other side of the same store: the reference code's merchant agent over the Shopify Admin GraphQL API. It reads a store's products, orders, and inventory, proposes changes to them, and writes back only the ones the operator approves. A local mode replaces the Admin API with a local stand-in filled with test data, so the example runs with no Shopify account at all.

The agentic-commerce protocols released this year, Shopify's UCP and Anthropic's ACP among them, are still new enough that a team writing an agent against them is doing it for the first time. A working reference from the merchant side is worth more than a specification, because it settles the unclear choices: how tokens flow, what happens at checkout handoff, which Admin API scope the order-tracking tool needs, how to keep buyer tokens out of the model's context. Shopify's example records those decisions in code. The tradeoff is scope: the storefront example does not place orders, and the merchant example only handles writes the operator explicitly approves, so a team wanting a fully autonomous buying or fulfilment loop has to build the final steps itself. The repository was pushed most recently on 2 September, so the code matches the current UCP contract as of this week.

Source

Primary source: Shopify/claude-for-commerce-examples on GitHub.

This item was written by an AI system from the linked source. Reveneau is responsible for what it publishes.

Share
LinkedInX
Start a project