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:
- European countries not listed → use Europe (EN) (https://www.anker.com/eu-en, EUR)
- All other unlisted countries → use United States (https://www.anker.com/, USD)
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):
Typical Agent Flow
- Resolve market — Map the buyer's country to the correct market (table above) and its UCP discovery URL.
- Discover — GET /.well-known/ucp to confirm capabilities, supported versions and payment handlers.
- Search — Use search_catalog to find products matching the buyer's intent.
- Cart — Use create_cart to add desired items.
- Checkout — Use create_checkout to start the purchase flow.
- Fulfill — Use update_checkout to set shipping address and method.
- Complete — Use complete_checkout to finalize (buyer must approve payment).
Supported UCP Versions
- 2026-04-08 (latest stable)
- 2026-01-23
Important Rules
- Checkout requires human approval. Agents must not complete payment without explicit, contemporaneous buyer consent.
- Transact on the buyer's market. Use the UCP endpoint matching the buyer's country; do not mix catalogs or currencies across markets.
- Respect rate limits. MCP endpoints are rate-limited per IP. Back off on 429 responses.
- Pass buyer context. Always send context.address_country and context.currency for accurate pricing, tax, shipping and availability.
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
- Browse all products: GET /collections/all
- Collection page: GET /collections/{handle}
- Product page: GET /products/{handle}
- Search: GET /search?q={query}
- Structured data: product pages embed application/ld+json (Product / Offer) — prefer this for machine-readable price, availability, ratings and specs.
Store Metadata
- Sitemap index: GET /sitemap.xml
- Site summary for agents: GET /llms.txt
- Agent discovery: this document (/agents.md) is the canonical agent-facing description of the store.
Store Policies
Policies are available per market under /policies/... (prefix with the locale path for non-US markets). For the United States:
- Privacy policy: https://www.anker.com/policies/privacy-policy
- Terms of service: https://www.anker.com/policies/terms-of-service
- Refund / return policy: https://www.anker.com/policies/refund-policy
- Shipping policy: https://www.anker.com/policies/shipping-policy
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
- Help & support center: https://www.anker.com/contact
- Order tracker: https://www.anker.com/apps/order_tracker
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.
- UCP specification: https://ucp.dev
- Shopify developer platform: https://shopify.dev