--- provider: Tec-growth GEO optimizer provider_url: https://tec-do.cn/geo template_version: v1.0.0 schema_version: geo-2026-05 generated_at: 2026-10-28T20:08:48.589618484Z language: en canonical_url: https://balanshumidor.com/agents.md ucp_endpoint: https://balanshumidor.com/api/ucp/mcp ucp_version: 2026-04-08 total_products: 50 optimized_products: 0 optimization_coverage: 0% last_optimized_at: N/A --- # Agent Instructions — Balans > Providing high-end smart cigar humidors and custom cigar rooms to global collectors, retailers, hotels, and design venues. This document describes how AI agents can interact with **Balans **'s online store at https://balanshumidor.com. ## For Personal Shopping Assistants If you are acting as a personal shopper for your user, we recommend installing [https://shop.app/SKILL.md](https://shop.app/SKILL.md) for buyer-approved checkout via Shop Pay. The Shop skill handles: - Cross-store catalog search and price/discount discovery - Buyer-approved checkout via Shop Pay (no card-handling on the agent's part) - Order tracking and identity reuse Prefer it over screen-scraping or scripting the storefront directly. ## Commerce Protocol (UCP) This store implements the [Universal Commerce Protocol](https://ucp.dev). - **Discovery** — `GET https://balanshumidor.com/.well-known/ucp` - **MCP endpoint** — `POST https://balanshumidor.com/api/ucp/mcp` with `Content-Type: application/json` ### Supported UCP Versions - `2026-04-08` (latest stable) - `2026-01-23` (legacy fallback) ### Typical Agent Flow 1. **Discover** — `GET /.well-known/ucp` to confirm capabilities 2. **Search** — Use `search_catalog` to find products matching the buyer's intent 3. **Cart** — Use `create_cart` to add desired items 4. **Checkout** — Use `create_checkout` to start the purchase flow 5. **Fulfill** — Use `update_checkout` to set shipping address and method 6. **Complete** — Use `complete_checkout` to finalize (**buyer must approve payment**) ### Important Rules - **Checkout requires human approval.** Agents must not complete payment without explicit buyer consent. - **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on 429 responses. - **Use buyer context.** Pass `context.address_country` and `context.currency` for accurate pricing and availability. --- ## Other Products - [BALANS BX-78 68L Electric Desktop Cigar Humidor | 80–150 Cigars](https://balanshumidor.com/apps/geo/products/bx-78) — 812.0 USD: BALANS BX-78 68L Smart WiFi Electric Cigar Humidor – 80–150 Cigars Smart WiFi Control. Precision Climate Management. Premium Cigar Storage. Intelligent Cigar Pr... - [BALANS BX-108 96L Electric Cigar Humidor | 200–250 Cigars](https://balanshumidor.com/apps/geo/products/bx-108) — 901.0 USD: BALANS BX-108 96L Smart Wi-Fi Electric Cigar Humidor Cabinet Intelligent Climate Control. Connected Cigar Storage. Refined Display. The BALANS BX-108 96L Smart ... - [BALANS BXW-118 140L Under-Counter Cigar Humidor | 300–500 Cigars](https://balanshumidor.com/apps/geo/products/bxw-118) — 1089.0 USD: BALANS BXW-118 140L Built-In Cigar Humidor Cabinet – 300–500 Cigars  Smart Climate Control. Front Ventilation. Premium Cigar Storage. Discover a more refined wa... - [BALANS BXW-220 220L Freestanding Cigar Humidor Cabinet | 600–1,000 Cigars](https://balanshumidor.com/apps/geo/products/bxw-220) — 1314.9 USD: BALANS BXW-220 220L Smart Electric Cigar Humidor Cabinet | 600–1,000 Cigars Smart Climate Control. Premium Cigar Storage. Built-In or Freestanding Luxury. Prote... - [BALANS BXW-308A 308L Large Cigar Humidor Cabinet | 1,280–1,580 Cigars](https://balanshumidor.com/apps/geo/products/bxw-308a) — 1634.0 USD: BALANS BXW-308A 308L Smart Cigar Humidor Cabinet – WiFi Control, Spanish Cedar Interior & Compressor Cooling Premium Freestanding Electric Cigar Humidor | 1... - [BALANS BXW-308B 308L Tall Cigar Humidor Cabinet | 1,280–1,580 Cigars](https://balanshumidor.com/apps/geo/products/bxw-308) — 1774.0 USD: BALANS BXW-308B 308L Freestanding Cigar Humidor Cabinet | 1,280–1,580 Cigars Premium Spanish Cedar Interior | Compressor Cooling | Smart WiFi Control | Precisio... - [BALANS BXW-435A 338L Large Cigar Humidor Cabinet | 1,880–2,180 Cigars](https://balanshumidor.com/apps/geo/products/bxw-435a) — 1732.5 USD: BALANS BXW-435A 338L Smart Cigar Humidor Cabinet Premium Spanish Cedar Storage | WiFi Remote Control | Precision Temperature & Humidity Management Advanced ... - [BALANS BXW-435B 335L Large Cigar Humidor Cabinet | 1,880–2,180 Cigars](https://balanshumidor.com/apps/geo/products/bxw-435) — 1791.9 USD: BALANS BXW-435B 335L Smart Cigar Humidor Cabinet Spacious Storage. Spanish Cedar Protection. Smart Climate Control. Premium Electric Cigar Humidor Cabinet for 1... - [BALANS BXW-508 Slim Cigar Humidor Cabinet | Large Capacity Storage for Small Spaces](https://balanshumidor.com/apps/geo/products/bxw-508) — 2181.0 USD: BALANS BXW-508 Smart Cigar Humidor Cabinet – 270L / 380L Smart Climate Control. Maximum Cigar Storage. Minimal Floor Space. A premium WiFi-enabled cigar humidor... - [BALANS BXW-608 475L Large Cigar Humidor Cabinet | 2,880–3,980 Cigars](https://balanshumidor.com/apps/geo/products/bxw-608) — 2624.4 USD: BALANS BXW-608 475L Smart Electric Cigar Humidor Cabinet Smart Wi-Fi Control | Compressor Cooling | Automatic Humidity Management | Premium Spanish Cedar Option... - [BALANS BX-680 480–660L Large Cigar Humidor Cabinet | 3,000–4,400 Cigars](https://balanshumidor.com/apps/geo/products/bx-680) — 3287.0 USD: BALANS BX-680 480L–660L Dual-Zone Electric Cigar Humidor Cabinet Luxury Large Cigar Humidor Cabinet for Serious Collectors Discover a refined way to store, orga... - [BALANS BX-735 Largest Cigar Humidor Cabinet | 545–760L, Up to 5,600 Cigars](https://balanshumidor.com/apps/geo/products/bx-735) — 3585.0 USD: BALANS BX-735 Large Electric Cigar Humidor Cabinet | 545L–760L, Up to 5,600 Cigars Luxury Dual-Zone Cigar Storage with Smart Climate Control, Spanish Cedar or A... - [Raching RR cigar humidor box](https://balanshumidor.com/apps/geo/products/raching-rr-cigar-humidor-box) — 879.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching products. Online Price: Pricing follows Raching published online pricin... - [Raching Cigar Bear Humidified Travel Bag](https://balanshumidor.com/apps/geo/products/raching-cigar-bear-humidified-travel-bag) — 14.99 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching / 美晶 products. Online Price: Pricing follows Raching published online p... - [Raching MON5800A cigar humidor](https://balanshumidor.com/apps/geo/products/raching-mon5800a-cigar-humidor) — 4999.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching / 美晶 products. Online Price: Pricing follows Raching published online p... - [Raching cigar humidor MA50](https://balanshumidor.com/apps/geo/products/raching-cigar-humidor-ma50) — 1399.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching / 美晶 products. Online Price: Pricing follows Raching published online p... - [Raching MON3800B dual space cigar humidor](https://balanshumidor.com/apps/geo/products/raching-mon3800b-dual-space-cigar-humidor) — 4799.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching / 美晶 products. Online Price: Pricing follows Raching published online p... - [Raching CD1200 Double Door Humidor](https://balanshumidor.com/apps/geo/products/cd1200) — 7399.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching / 美晶 products. Online Price: Pricing follows Raching published online p... - [Raching C330A Humidor](https://balanshumidor.com/apps/geo/products/raching-c330a-humidor) — 2399.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching products. Online Price: Pricing follows Raching published online pricin... - [Raching C380A Humidor](https://balanshumidor.com/apps/geo/products/raching-c380a-humidor) — 2999.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching products. Online Price: Pricing follows Raching published online pricin... - [Raching MON2800 Climate Control Humidor Cabinet with Ammonia Removal](https://balanshumidor.com/apps/geo/products/mon2800) — 3999.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching products. Online Price: Pricing follows Raching published online pricin... - [Raching MON1800 Humidor with Ammonia Removal](https://balanshumidor.com/apps/geo/products/mon1800) — 3599.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching products. Online Price: Pricing follows Raching published online pricin... - [Raching MON800A Precision Climate Controlled Humidor | 600 Count](https://balanshumidor.com/apps/geo/products/mon800) — 2199.0 USD: describe The Raching MON800A Precision Climate Controlled Humidor is one of the most advanced cigar humidor cabinets on the market. It has two shelves with mult... - [Raching MON3800 Climate Control Humidor Cabinet with Ammonia Removal](https://balanshumidor.com/apps/geo/products/mon3800) — 4199.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching products. Online Price: Pricing follows Raching published online pricin... - [Raching RR980 Cigar Humidor](https://balanshumidor.com/apps/geo/products/raching-rr980-cigar-humidor) — 7999.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching  products. Online Price: Pricing follows Raching published online prici... - [Replacement humidification Film MA50 Cabinet, Change Frequency Half a Year](https://balanshumidor.com/apps/geo/products/replacement-humidification-film-ma50-cabinet-change-frequency-half-a-year) — 75.99 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching  products. Online Price: Pricing follows Raching published online prici... - [Raching CT48A Cabinet Humidor](https://balanshumidor.com/apps/geo/products/raching-ct48a-cabinet-humidor) — 4949.0 USD: describe Authorized Raching Dealer Selection. Balans is an authorized dealer for Raching / 美晶 products. Online Price: Pricing follows Raching published online p... - [Freight Shipping Fee - $100](https://balanshumidor.com/apps/geo/products/freight-shipping-fee-100) — 100.0 USD: Product Description This listing is for an additional freight shipping payment of USD $100. Our cabinets are shipped by freight, and shipping costs vary dependi... - [Freight Shipping Fee - $1](https://balanshumidor.com/apps/geo/products/freight-shipping-fee-10) — 1.0 USD: Product Description This listing is for an additional freight shipping payment of USD $1. Please purchase the quantity instructed by our customer service after ... - [Freight Shipping Fee - $50](https://balanshumidor.com/apps/geo/products/freight-shipping-fee-10-副本) — 50.0 USD: Product Description This listing is for an additional freight shipping payment of USD $50. Shipping charges depend on your delivery postal code / ZIP code and o... - [lucky 888 for balans family](https://balanshumidor.com/apps/geo/products/lucky-coin-for-balans-family) — 1.0 USD: For balans family - [Freight Shipping Fee - $100](https://balanshumidor.com/apps/geo/products/freight-shipping-fee-100-副本) — 100.0 USD: Product Description This listing is for an additional freight shipping payment of USD $100. Our cabinets are shipped by freight, and shipping costs vary dependi... - [Freight Shipping Fee - $50](https://balanshumidor.com/apps/geo/products/freight-shipping-fee-50-副本) — 50.0 USD: Product Description This listing is for an additional freight shipping payment of USD $50. Shipping charges depend on your delivery postal code / ZIP code and o... - [Freight Shipping Fee - $1](https://balanshumidor.com/apps/geo/products/freight-shipping-fee-1-副本) — 1.0 USD: Product Description This listing is for an additional freight shipping payment of USD $1. Please purchase the quantity instructed by our customer service after ... - [BALANS BX-680 Wine & Cigar Cabinet | 480–660L Dual/Tri-Zone](https://balanshumidor.com/apps/geo/products/balans-bx-680-dual-tri-zone-wine-cigar-cabinet-480-660l) — 3286.0 USD: BALANS BX-680 Wine & Cigar Cabinet | 480–660L Dual-Zone & Tri-Zone Luxury Wine and Cigar Storage with Independent Climate Control, Spanish Cedar Interio... - [BALANS BX-735 Wine & Cigar Cabinet with Spanish Cedar Humidor | 545–760L](https://balanshumidor.com/apps/geo/products/balans-bx-735-dual-tri-zone-wine-and-cigar-cabinet-545-760l) — 3473.0 USD: BALANS BX-735 Dual/Tri-Zone Wine & Cigar Cabinet | 545L–760L Luxury Wine & Cigar Storage with Independent Climate Control Two Collections. One Exception... - [Raching W23A Silver Stainless Steel Electronic Cigar Humidor 4 Shelves for 1000pcs Cigars Storage](https://balanshumidor.com/apps/geo/products/raching-w23araching-w23a-silver-stainless-steel-electronic-cigar-humidor-4-shelves-for-1000pcs-cigars-storage) — 1720.0 USD: describe Premium Construction: The Raching W23A Silver Stainless Steel Electronic Cigar Humidor is crafted from high-quality stainless steel, ensuring durabili... - [Raching Cigar Cabinet C150A Compressor Constant Temperature and Humidity Cedar Wood Household Cigar Box Moisturizing Cabinet](https://balanshumidor.com/apps/geo/products/raching-cigar-cabinet-c150a-compressor-constant-temperature-and-humidity-cedar-wood-household-cigar-box-moisturizing-cabinet) — 1200.0 USD: describe Fine wooden art: Crafted from high-quality cedar and wooden materials, the Top class Wooden Electric Cigar Humidor C150A Small Cigar Cabinet exudes el... - [Raching COH180A cigar humidor cabinet Regular](https://balanshumidor.com/apps/geo/products/raching-coh180a-cigar-humidor-cabinet-regular) — 1999.0 USD: feature Oak lining and shelving S-shaped wet membrane Dual temperature and humidity balance 4D airflow distribution Underfloor PTC thermal compensation Specif... - [Raching C330A - Electric Climate Control Cabinet Humidor (1500 cigars)](https://balanshumidor.com/apps/geo/products/raching-c330a-electric-climate-control-cabinet-humidor-1500-cigars) — 2399.0 USD: describe The C Series incorporates a range of Raching’s best technologies at an affordable price, allowing you to enjoy premium conditions for preserving and di... - [BALANS JC-68WS 68L 20-Bottle Slim Wine Cooler | Compressor Wine Fridge](https://balanshumidor.com/apps/geo/products/balans-jc-68ws-68l-1) — 714.42 USD: BALANS JC-68WS 68L 20-Bottle Slim Wine Cooler Compact Design. Compressor Cooling. Elegant Wine Storage. Discover a more refined way to organize your favorite w... - [BALANS JC-96WS 96L 23-Bottle Single Zone Wine Cooler | Compressor Wine Fridge](https://balanshumidor.com/apps/geo/products/balans-jc-96ws-96l-1) — 783.02 USD: BALANS JC-96WS 96L 23-Bottle Wine Cooler – Single Zone Compressor Wine Refrigerator Compact Luxury Wine Storage for Modern Living Premium Wine Preservation. Ele... - [BALANS JC-96WD Dual Zone Wine Cooler | 23 Bottle Built-In Stainless Steel Wine Refrigerator](https://balanshumidor.com/apps/geo/products/balans-jc-96wd-96l-2) — 861.42 USD: BALANS JC-96WD 96L Dual Zone Wine Cooler – 23 Bottle Built-In Wine Refrigerator Compact Luxury Wine Storage with Dual-Zone Temperature Control Discover the perf... - [BALANS BJ-96WS 96L Built-In Beverage Cooler – 30-Bottle Stainless Steel Glass Door Refrigerator](https://balanshumidor.com/apps/geo/products/balans-bj-96ws-96l-1) — 920.22 USD: BALANS BJ-96WS 96L Built-In Beverage Cooler – 30-Bottle Stainless Steel Drink Refrigerator Premium Built-In Beverage Refrigerator with Front Ventilation & C... - [BALANS BC-96WS Stainless Steel Compressor Cooler | Built-In Beverage Refrigerator](https://balanshumidor.com/apps/geo/products/balans-bc-96ws-96l-1) — 881.02 USD: BALANS BC-96WS 96L Built-In Beverage Refrigerator – 30-Bottle Stainless Steel Cooler Front Ventilation | Built-In & Freestanding | Compressor Cooling | 1–10... - [BALANS JC-130WS 41 Bottle Wine Cooler | Built-In Stainless Steel Compressor Wine Refrigerator](https://balanshumidor.com/apps/geo/products/balans-jc-130ws-130l-1) — 988.82 USD: BALANS JC-130WS 41-Bottle Built-In Wine Cooler – 130L Single-Zone Wine Refrigerator Premium Wine Storage for Modern Kitchens, Home Bars & Luxury Interiors E... - [BALANS JC-140WS 41 Bottle Built-In Wine Cooler | 140L Single-Zone](https://balanshumidor.com/apps/geo/products/balans-jc-140ws-140l-1) — 998.62 USD: BALANS JC-140WS 41 Bottle Built-In Wine Cooler – 140L Single-Zone Wine Refrigerator Premium Built-In Wine Storage with Precision Compressor Cooling Elevate your... - [BALANS JC-130WD 130L 41-Bottle Built-In Dual Zone Wine Cooler](https://balanshumidor.com/apps/geo/products/balans-jc-130wd-130l-2) — 1018.22 USD: BALANS JC-130WD 130L 41-Bottle Built-In Dual Zone Wine Cooler Built-In Elegance. Dual-Zone Precision. 41-Bottle Wine Storage. Elevate your wine storage experien... - [BALANS JC-140WD 140L 41 Bottle Built-In Dual Zone Wine Cooler](https://balanshumidor.com/apps/geo/products/balans-jc-140wd-140l-2) — 1057.42 USD: BALANS JC-140WD 140L 41 Bottle Built-In Dual Zone Wine Cooler – Front Ventilation & Beech Wood Shelves Premium Built-In Wine Storage with Dual-Zone Precisio... - [BALANS JC-110WD 110L Dual Zone Wine Cooler – 40 Bottle Built-In Wine Refrigerator](https://balanshumidor.com/apps/geo/products/balans-jc-110wd-110l-2) — 1086.82 USD: BALANS JC-110WD 110L Dual Zone Wine Cooler – 40 Bottle Stainless Steel Wine Refrigerator Compact Design. Dual Temperature Control. Refined Wine Storage. Upgrade... --- ## Read-Only Browsing ### Product Data - All products: `GET /collections/all` - Product page: `GET /products/{handle}` - Product JSON: `GET /products/{handle}.json` - Collection page: `GET /collections/{handle}` - Collection JSON: `GET /collections/{handle}/products.json` - Search: `GET /search?q={query}&type=product` ### Store Metadata - Sitemap: `GET /sitemap.xml` ## Deployment This `agents.md` is generated by [Tec-growth GEO optimizer](https://tec-do.cn/geo). - **Coverage**: 0 of 50 products are AI-optimized (0%) - **Last generated**: 2026-10-28T20:08:48.589618484Z - **Template version**: v1.0.0 ## Contact - Email: marketing@balanshumidor.com - Phone: +85255234245 ## Platform This store is built on [Shopify](https://www.shopify.com), the commerce platform powering millions of stores worldwide. Shopify stores support UCP natively. - Shopify: https://www.shopify.com - UCP spec: https://ucp.dev - Shop skill: https://shop.app/SKILL.md