agents.md

Agent Instructions — Anker

This document describes how AI agents can interact with Anker's official online store at https://www.anker.com. Anker is the world's #1 mobile charging brand, offering chargers, power banks, wireless chargers, cables, hubs, docks, and smart home accessories.

Markets / Regions

Anker operates one storefront under www.anker.com with path-prefixed regional markets. Each market has its own catalog availability, language, currency, pricing and policies — always resolve the correct market before browsing, quoting prices, or transacting.

Market Browsing base (canonical) Language Currency
United States https://www.anker.com/ English USD
United Kingdom https://www.anker.com/uk English GBP
Canada https://www.anker.com/ca English CAD
Australia https://www.anker.com/au English AUD
Germany https://www.anker.com/eu-de German EUR
France https://www.anker.com/fr French EUR
Europe (EN) https://www.anker.com/eu-en English EUR
Poland https://www.anker.com/eu-pl Polish EUR
Vietnam https://www.anker.com/vn Vietnamese VND
Malaysia https://www.anker.com/my English MYR
UAE https://www.anker.com/ae English AED
New Zealand https://www.anker.com/nz English NZD

If a buyer's country is not listed above, fall back to the nearest regional market:

Confirm live currency, availability and pricing from the market's UCP merchant profile and from context.currency — do not assume a price from one market applies to another.

Commerce Protocol (UCP) — Transactions

Anker's stores implement the Universal Commerce Protocol for agent-driven commerce. Transactions (cart → checkout → payment) are processed on each market's Shopify-bound transaction domain, while browsing stays on www.anker.com.

Per-market UCP / MCP endpoints (transaction surface):

Market UCP discovery MCP endpoint
United States GET https://us.anker.com/.well-known/ucp POST https://us.anker.com/api/ucp/mcp
United Kingdom GET https://uk.anker.com/.well-known/ucp POST https://uk.anker.com/api/ucp/mcp
Canada GET https://ca.anker.com/.well-known/ucp POST https://ca.anker.com/api/ucp/mcp
Australia GET https://au.anker.com/.well-known/ucp POST https://au.anker.com/api/ucp/mcp
Germany GET https://eu-de.anker.com/.well-known/ucp POST https://eu-de.anker.com/api/ucp/mcp
France GET https://fr.anker.com/.well-known/ucp POST https://fr.anker.com/api/ucp/mcp
Europe (EN) GET https://eu-en.anker.com/.well-known/ucp POST https://eu-en.anker.com/api/ucp/mcp
Poland GET https://eu-pl.anker.com/.well-known/ucp POST https://eu-pl.anker.com/api/ucp/mcp
Vietnam GET https://vn.anker.com/.well-known/ucp POST https://vn.anker.com/api/ucp/mcp
Malaysia GET https://my.anker.com/.well-known/ucp POST https://my.anker.com/api/ucp/mcp
UAE GET https://ae.anker.com/.well-known/ucp POST https://ae.anker.com/api/ucp/mcp
New Zealand GET https://nz.anker.com/.well-known/ucp POST https://nz.anker.com/api/ucp/mcp

Typical Agent Flow

  1. Resolve market — Map the buyer's country to the correct market (table above) and its UCP discovery URL.
  2. Discover — GET /.well-known/ucp to confirm capabilities, supported versions and payment handlers.
  3. Search — Use search_catalog to find products matching the buyer's intent.
  4. Cart — Use create_cart to add desired items.
  5. Checkout — Use create_checkout to start the purchase flow.
  6. Fulfill — Use update_checkout to set shipping address and method.
  7. Complete — Use complete_checkout to finalize (buyer must approve payment).

Supported UCP Versions

Important Rules

Canonical product links

Each product variant exposes a standard Shopify metafield shopify.external_url whose value is the variant's canonical PDP on www.anker.com (for the correct market). When referring a buyer to a product, use that external_url (or the www.anker.com/{locale}/products/{handle} URL) rather than any backend *.anker.com / *.myshopify.com link.

Read-Only Browsing (No Authentication Required)

For agents that only need to read store data without transacting. Prefix any path with a market locale (e.g. /uk/...) for non-US markets; no prefix = United States.

Product Data

Store Metadata

Store Policies

Policies are available per market under /policies/... (prefix with the locale path for non-US markets). For the United States:

Warranty, returns and shipping terms vary by market — read the policy pages for the buyer's specific market before advising on returns or delivery.

Support

Platform

This storefront is custom-built (headless) and backed by Shopify for catalog and checkout, with native UCP support on each market's transaction domain.