← webaz.xyz

WebAZ: AI-Native Commerce

Developer documentation / 开发者文档 · Find the same item / AI找同款

Shopping agent API: read-only quickstart · 购物Agent API与MCP接入指南

Build an AI shopping agent that discovers and compares products from independent merchants. WebAZ provides public HTTP and MCP access to product information, with separately authorized ordering and x402 payment paths. Public shopping is read-only.

WebAZ AI 原生电商:让购物 agent 通过公开 HTTP 或 MCP 查找、比较独立商家的商品。公开查询只读;建单与 x402 付款是需要单独授权的后续操作。

Browse products / 浏览商品 · Connect an agent / 连接 agent · x402 integration / 接入文档

No setup needed — just open a link: https://webaz.xyz/api/products?fuzzy=true&q=<keywords>&ship_to=<ISO country, e.g. SG> returns JSON with price (USDC + local-currency estimate), delivered estimate, delivery days, return policy, weight and size (null = not provided by the seller; see compare.missing). Product detail: https://webaz.xyz/api/products/<id>. Human page: https://webaz.xyz/product/<id>. Plain-text version: /llms.txt.

中文说明 / Chinese guide

让 AI 查找商品、连接独立商家。公开购物接口只读,无需登录,不建单、不付款。价格、库存、配送与售后以实时商品信息为准;缺失信息请向卖家核实。

通用接口支持匿名查询、OAuth(启用时)或本地配对的限权委托、账号 API key。工具可见不等于有权执行;切换界面角色不增加授权,缺少权限需重新授权。

限权委托的建单流程是报价→草稿→提交请求→本人批准→服务端重新校验并建单;付款时再由本人用 Passkey(直付)或钱包(USDC)确认。提交请求不等于已下单或已付款。账号 API key 的直接建单是另一条路径,不经过同一逐单审批;只给可信客户端,并按需撤销。

直付由买家向卖家场外付款,WebAZ 不托管该本金。符合条件且渠道开放时,可用 Base 主网 USDC 合约担保;合约有单笔上限,未经第三方审计,买家建单后仍需钱包存款。示意流程不代表所有操作都受同一种人工确认保护。

下方提供可复制的接口地址、客户端配置和只读提示词;当前能力以连接后的 tools/list 及服务端授权为准。STDIO 是联网桥,不是本地业务数据库。

Grok 公开购物使用 https://webaz.xyz/mcp/grok-search-v1,无需鉴权,仅提供 webaz_search;账户连接仍是兼容性预览,不推荐默认配置。连接器是否可用取决于客户端与套餐,不等于商品自动进入所有用户的 AI 搜索结果。

✅ Your AI can (no login)

  • Search & compare products available on the public shopping surface
  • Read price (USDC display pricing), stock, delivery ETA, return & handling terms
  • See decision flags (e.g. order protection, dispute losses, shop paused) and honest unknowns

🚫 It cannot

  • Place an order or move funds from this public surface — it is discovery-only
  • Use account permissions merely because a tool is visible
  • Verify unstated compatibility — ask the seller about missing facts

🔑 Where a human approves

  • With a scoped grant: quote → draft → submit an order request
  • That request needs human approval (a tap on webaz.xyz) and server re-validation before order creation; payment then needs the human's Passkey (Direct Pay) or wallet (USDC)
  • Account API keys are different: direct order creation does not use this per-order approval queue

AI agent ecommerce: from product research to a purchase decision

AI ecommerce can mean tools that help a merchant write listings or answer questions. Here, agentic commerce means a shopping agent working with structured merchant information: finding candidates, comparing options against a buyer's needs, and handing off an explicitly authorized next step. AI-native commerce makes those interfaces part of the shopping workflow, rather than relying only on a browser checkout.

AI 电商不只是生成商品文案。这里的 agent 电商,是让 AI 根据买家需求读取结构化商品信息、比较候选商品,再交接经过明确授权的下一步。AI 原生电商把这些接口纳入购物流程,而不只依赖网页结账。

For shopping agent developers / 面向购物 agent 开发者

Start with anonymous product search and detail reads. Compare the selected variant, quantity, destination, delivery terms and missing facts. Before any purchase, obtain a fresh quote for that exact selection; an estimated or cheaper item price is not permission to buy. Use the MCP access guide and integration contract to choose the appropriate credential and supported route.

先用匿名商品查询验证用途,比较规格、数量、目的地、配送条件与缺失信息。购买前针对具体选择重新报价;估价或更低的单价不等于购买授权。按接入文档选择权限与支持的路径。

For merchants / 面向商家

Make products comparable: describe variants, dimensions, compatibility, stock and destination-specific delivery and return terms accurately. A public product page gives people a shareable reference; structured data lets connected agents compare the same facts. Missing or conflicting information should remain unknown, not become an invented selling point.

商品需要可比较:准确填写规格、尺寸、兼容性、库存、配送与退货条件。独立商品页方便分享,结构化数据让已连接的 agent 比较相同事实;缺失或冲突的信息不能编造成卖点。

Does listing here mean every AI assistant will find it? / 上架后所有 AI 都能搜到吗?

No. Public web discovery, a manually connected MCP client, and a platform's own shopping index are different routes. Client support varies; publishing a page or connecting WebAZ does not guarantee Google indexing, search ranking, or inclusion in every ChatGPT conversation.

不是。公开网页检索、手动连接 MCP 和平台自身的购物索引是不同入口。发布页面或连接 WebAZ 不保证 Google 收录、搜索排名,也不代表所有 ChatGPT 对话默认能发现商品。

Connect an endpoint

Discovery-only · no authhttps://webaz.xyz/mcp/shopping-v1
Account actions · credential-dependenthttps://webaz.xyz/mcp
Scoped grants expose tools derived from approved capabilities. Changing your WebAZ screen role does not add permissions; missing capabilities require fresh authorization.

The shopping endpoint exposes one read-only tool (webaz_search). The general endpoint also supports anonymous reads, OAuth when enabled, locally paired grants, and account API keys. Prefer scoped access; share an account key only with a trusted client. See access documentation.

Nothing found? On the general endpoint, webaz_demand creates a private find-it-for-me draft. Send its review_url to the buyer to review the public fields and publish with their Passkey on WebAZ. Shops answer with quotes; nothing is bought automatically.

Paying in USDC (x402)? With an account API key, read the order: when it carries payment.x402, call webaz_pay_order (or POST its resource_url) → 402 PaymentRequired → your wallet signs the EIP-3009 authorization → call again with the PAYMENT-SIGNATURE. The account owner switches this on once on the WebAZ Me page (Passkey).

Client setup

Try these prompts

1 · Phone-stand comparison

Using the WebAZ shopping tool, find phone stands and compare all results in a table: price, stock, delivery ETA to Singapore, return window, handling time, and every decision flag. Separate facts the seller states from facts that are missing, and do not assume compatibility with any phone model unless it is stated. Which would you shortlist for a desk, and why?

2 · Laptop-stand known / unknown test

Search WebAZ for “Metal Laptop Cooling Stand”. Produce two lists: (A) facts the listing actually states, with values; (B) facts a careful buyer would want that are NOT stated (for example exact dimensions, supported laptop size range, maximum load). For list B, say “unknown” — do not fill gaps with typical values for similar products.

3 · Order-safety walkthrough (read-only)

Using WebAZ public documentation, distinguish public shopping, scoped order requests with human approval, and direct account-key ordering. Explain payment separately for Direct Pay and eligible USDC escrow. State who acts and what changes. Do not create an order, submit a request, pay, or call any state-changing tool.

Scoped order-request flow / 限权委托建单流程

Discoverpublic · read-only
Compare / detailpublic · read-only
Quoteauthenticated
Draftauthenticated
Submit requestauthenticated
🔑 Human approvalhuman only
Order existspayment still required

Submitting a request is not an order or a payment. This flow applies to scoped order requests, not every account-key action. After approval and successful re-validation, Direct Pay is paid off-platform; USDC escrow requires a separate wallet deposit.

Access paths, clearly separated

ModeCredentialWhat it can touch
Network read-onlynoneLive reviewed catalog via /mcp/shopping-v1 (or the stdio package without a key). Discovery only.
Authenticated network: scoped grantOAuth or locally paired grantAllowed reads and supported operations only. Order quote / draft / submit requires order:draft; human approval executes the order request.
Authenticated network: account keyapi_keyDirect account actions, including webaz_place_order, subject to server checks. Not a blanket per-action Passkey gate. Keep keys private and revoke unused access.
Local STDIO bridgeoptional api_key or local scoped grantThe same live Remote MCP full surface through a local process, plus local webaz_pair. It is not a local business database.

Honest facts, honest unknowns

Use current listing data, not a frozen example. Prices, stock and delivery terms can change.

Known (stated by the listing)

  • Check the current product page for price, stock and options
  • Read the seller's delivery estimate and return terms for your destination
  • Use the seller information and decision flags actually returned

Unknown (and reported as unknown)

  • Mark dimensions, compatibility or load limits unknown when the listing does not state them
  • Missing delivery or return terms are not a promise
  • Do not fill gaps with “typical” values — ask the seller before relying on them

Browse current products / 浏览当前商品. Public shopping provides discovery; account actions follow the access paths above.

Payment-method prices / 付款方式价格

Prices differ by payment method. The listed price is the card price and is never surcharged; non-card methods (PayNow, bank transfer, x402 USDC) get an automatic discount set by the platform fee table — the card fee minus that method's fee; a seller can only lower it. Products carry best_price (the cheapest non-card “from” price) and quotes list payment_options cheapest first: choose the cheapest. USDC escrow gets the same discount (escrow costs 0, like PayNow); its entry has rail usdc_escrow and no account_id. 各付款方式价格不同:标价即刷卡价,非卡付款按平台费率表自动优惠,选最省的;链上担保同享(按 rail 区分,担保条目无 account_id)。