{"schema_version":"agent-card/1.0","name":"候茶 Hou Tea","description":"Premium Chinese tea store — agent-native storefront with x402 USDC checkout on Base chain. Browse, compare, and purchase authentic Chinese teas with no browser required.","url":"https://hou-tea.com","api_base":"https://hou-tea.com","capabilities":{"payment":{"protocol":"x402","standard":"HTTP 402 Payment Required","networks":["base"],"currency":"USDC","checkout_flow":"agent-native","buy_endpoint":"https://hou-tea.com/pay/api/v1/buy","recipient":"0x9d0b947fb0B92F9dCc2c7896BAA8ccC6879b3A54","usdc_contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Standard x402 protocol. POST to /pay/api/v1/buy — returns HTTP 402 with X-Payment-Requirements header. Send USDC on Base chain, retry with X-Payment header containing tx_hash. No browser or human interaction required."},"catalog":true,"recommendation":true,"comparison":true,"bundle_suggestion":true,"constraint_filtering":true,"product_explanation":true},"authentication":{"type":"api_key","header":"X-Agent-Key","description":"Contact store operator to obtain an Agent API key."},"skills":[{"id":"catalog","name":"Browse Product Catalog","description":"List all active products with full semantic metadata. Filter by category, price range, season, difficulty. Each product includes a `card` object (name, price, image, images[], url, variants) ready to render as a buyer-facing product card.","method":"GET","endpoint":"https://hou-tea.com/api/agent/catalog","parameters":{"store_id":{"type":"string","default":"fengshui"},"category":{"type":"string","example":"green tea"},"price_min":{"type":"number"},"price_max":{"type":"number"},"season":{"type":"string","example":"spring"},"difficulty":{"type":"string","enum":["beginner","intermediate","advanced"]},"page":{"type":"integer","default":1},"per_page":{"type":"integer","default":20}},"product_card_fields":{"card.id":"skill_id — use in create-order","card.name":"English product name","card.name_zh":"Chinese product name","card.tagline":"One-sentence sales pitch","card.price":"USD retail price","card.image":"Primary display image URL","card.images":"Array of up to 6 stable image URLs (permanent CDN / wp-content only)","card.url":"WooCommerce product page URL","card.variants":"Available sizes/options with prices, e.g. [{option:'100g', price:28}, ...]"}},{"id":"recommend","name":"Get Product Recommendations","description":"Semantic recommendation from a natural-language query. Returns ranked products with intent parsing and match reasoning.","method":"POST","endpoint":"https://hou-tea.com/api/agent/recommend","body":{"query":{"type":"string","required":true,"example":"light floral tea for summer afternoon"},"store_id":{"type":"string","default":"fengshui"},"budget_max":{"type":"number","example":40},"occasion":{"type":"string","example":"gift"},"limit":{"type":"integer","default":3}}},{"id":"compare","name":"Compare Products","description":"Side-by-side comparison of 2–4 products across sensory, price, and use-case dimensions.","method":"POST","endpoint":"https://hou-tea.com/api/agent/compare","body":{"skill_ids":{"type":"array","items":"string","required":true},"store_id":{"type":"string","default":"fengshui"}}},{"id":"explain","name":"Explain Product","description":"Full knowledge package: story, brewing guide, health info, talking points, cultural context, and cross-sell suggestions.","method":"GET","endpoint":"https://hou-tea.com/api/agent/explain/{skill_id}","path_params":{"skill_id":{"type":"string","required":true}},"query_params":{"store_id":{"type":"string","default":"fengshui"}}},{"id":"bundle","name":"Find Bundle & Pairings","description":"Return the configured bundle partners and season/element pairings for a product.","method":"POST","endpoint":"https://hou-tea.com/api/agent/bundle","body":{"skill_id":{"type":"string","required":true},"store_id":{"type":"string","default":"fengshui"}}},{"id":"constraints","name":"Filter by Health Constraints","description":"Return only products safe for given conditions (e.g. pregnant, insomnia, children, diabetic).","method":"POST","endpoint":"https://hou-tea.com/api/agent/constraints","body":{"conditions":{"type":"array","items":"string","required":true,"example":["insomnia","pregnant"]},"store_id":{"type":"string","default":"fengshui"},"limit":{"type":"integer","default":10}}},{"id":"buy","name":"Buy Product (Standard x402)","description":"Standard HTTP 402 x402 payment endpoint. POST without X-Payment → 402 + payment requirements. POST with X-Payment (tx_hash) → 200 + order confirmation. Compatible with Coinbase AgentKit and any x402 wallet client.","method":"POST","endpoint":"https://hou-tea.com/pay/api/v1/buy","requires_auth":false,"body":{"product_name":{"type":"string","required":true,"description":"Product name from catalog"},"unit_price":{"type":"string","required":true,"description":"Price in USDC e.g. '35.00'"},"quantity":{"type":"integer","default":1},"currency":{"type":"string","default":"usdc"}},"payment_flow":{"step1":"POST without X-Payment → HTTP 402 + X-Payment-Requirements header","step2":"Send USDC to 'to' address on Base chain, get tx_hash","step3":"POST same request + X-Payment: base64({x402Version:1,scheme:'exact',network:'base-mainnet',payload:{tx_hash:'0x...'}})","step4":"HTTP 200 → {status:'confirmed', order_id:'ord_xxx'}"},"x402_requirements_format":{"x402Version":1,"accepts":[{"scheme":"exact","network":"base-mainnet","maxAmountRequired":"<amount in USDC units, 6 decimals>","to":"0x9d0b947fb0B92F9dCc2c7896BAA8ccC6879b3A54","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]}},{"id":"order_status","name":"Check Order Status","description":"Poll order status after payment. Status: pending_payment → confirmed.","method":"GET","endpoint":"https://hou-tea.com/pay/api/v1/orders/{order_id}","path_params":{"order_id":{"type":"string","required":true}}}],"example_flow":[{"step":1,"action":"GET https://hou-tea.com/api/agent/catalog","note":"Browse products, find product_name and unit_price (in USDC)"},{"step":2,"action":"POST https://hou-tea.com/api/agent/recommend","note":"Optional: natural language recommendation"},{"step":3,"action":"POST https://hou-tea.com/pay/api/v1/buy","note":"No X-Payment header → HTTP 402 with X-Payment-Requirements (amount + recipient address)"},{"step":4,"action":"Send USDC on Base chain","note":"Transfer to 0x9d0b947fb0B92F9dCc2c7896BAA8ccC6879b3A54, USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"step":5,"action":"POST https://hou-tea.com/pay/api/v1/buy  (with X-Payment header)","note":"X-Payment: base64({{x402Version:1,scheme:'exact',network:'base-mainnet',payload:{{tx_hash:'0x...'}}}})"},{"step":6,"action":"HTTP 200 OK","note":"Response: {status: 'confirmed', order_id: 'ord_xxx'} — purchase complete"}],"contact":{"support_email":"support@hou-tea.com","docs_url":"https://hou-tea.com/agent-card"}}