← all repositories
anthropics/commerce-agents

Anthropic's fake store demos how Claude commerce agents should work

A reference architecture for Claude-powered shopping and merchant agents that keeps every write staged and every brand fictional.

2.7k stars Python AgentsCoding Assistants
commerce-agents
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does

Anthropic open-sourced a two-sided blueprint for AI commerce agents built on Claude. One agent faces customers to search, compare, and fill carts; the other faces staff to analyze performance, adjust listings, and draft campaigns. Four runnable verticals—retail, travel, telecom, and entertainment—demonstrate both roles over the same libraries, though every company and transaction is strictly fictional.

The interesting bit

The merchant agent cannot actually change anything live. Every write is staged until a human approves it, and the checkout flow merely renders a cart for the host system to complete. The README is admirably blunt that this is reference code, not a product, and explicitly states it is unmaintained and accepts no contributions.

Key highlights

  • Three runtime paths: raw Messages API loop, Agent SDK wrapper, or Anthropic Managed Agents via MCP manifest
  • Shared commerce-common library handles fencing, memory, grounding, and safety rules across both shopping and merchant roles
  • Shopping skills cover search, comparison, planning, cart, and memory; merchant skills cover analytics, listings, inventory, pricing, and campaigns
  • Backend interfaces are designed for you to wire to your own catalog, cart, order, and analytics systems
  • Safety docs map each enforced rule to its module, though the examples ship without authentication

Caveats

  • Explicitly unmaintained and does not accept contributions
  • No official MCP connectors ship; integration with warehouses, finance, or delivery platforms is left to your backend implementation
  • The examples bind MCP servers to loopback and lack authentication, so they are demos, not deployment templates

Verdict

Worth studying if you are designing conversational commerce interfaces and need a sane starting point for tool contracts and safety gates. Skip it if you are looking for a drop-in Shopify plugin; this is architecture, not glue.

Frequently asked

What is anthropics/commerce-agents?
A reference architecture for Claude-powered shopping and merchant agents that keeps every write staged and every brand fictional.
Is commerce-agents open source?
Yes — anthropics/commerce-agents is open source, released under the Apache-2.0 license.
What language is commerce-agents written in?
anthropics/commerce-agents is primarily written in Python.
How popular is commerce-agents?
anthropics/commerce-agents has 2.7k stars on GitHub.
Where can I find commerce-agents?
anthropics/commerce-agents is on GitHub at https://github.com/anthropics/commerce-agents.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.