Commercetools Anthropic Agents — AI skill for Claude Code

commercetools-anthropic-agents

A shopping agent and a merchant agent for commercetools, built on [`anthropics/commerce-agents`](https://github.com/anthropics/commerce-agents).

The agents reach commercetools through a backend this project owns, and their tools run in this process. That is deliberate: the gates that matter — provenance on every cart write, quantity caps, fencing of everything the platform returns — run *before* the commercetools call, and the shopper's identity never enters the model's context at all.

Both halves work end to end against a live project. On the storefront, a chat turn fills the cart and checkout takes a real card through commercetools Checkout and the deployed Stripe connector. In the portal, the merchant assistant reads the store's real numbers and stages changes that only apply when the operator approves them.

Install the plugin

This repo is also a Claude Code plugin marketplace, carrying one plugin — `commercetools-commerce-agent` — that scaffolds a new shopping or merchant agent using this repo's backend, config, and decision record as the reference.

/plugin marketplace add commercetools/commercetools-anthropic-agents
/plugin install commercetools-commerce-agent@commercetools-anthropic-agents

That gives you the `/scaffold-commercetools-agent` command:

/scaffold-commercetools-agent a shopping agent for project key my-store-prod

It interviews you on the details that actually change per project — transport, catalogue shape, identity binding, checkout ownership — then scaffolds the backend from this repo's `ct_common/` and decision record.

Run it

python3.13 -m venv .venv && source .venv/bin/activate
pip install -r requirements-dev.txt
cp .env.example .env          # commercetools credentials + an org ANTHROPIC_API_KEY
uvicorn service.main:app --port 8000

cd web && npm install
cd storefront && npx next dev -p 3005     # the shop
cd web/portal && npx next dev -p 3105     # the back office

T