# Galeria Heban

## Store

- **Currency**: PLN
- **Location**: Warszawa, PL
- **Logo**: https://galeria.heban.pl/wp-content/uploads/2026/01/LogoCzarne.svg
- **Support**: store@heban.pl

## Browse

- **Shop archive**: https://galeria.heban.pl/shop/?utm_medium=referral&utm_id=woo_llms
- **Search**: `https://galeria.heban.pl/?s={search_term}&post_type=product&utm_medium=referral&utm_id=woo_llms` — replace `{search_term}` with the buyer's query
- **Sitemaps** (exhaustive URL lists for full-catalog enumeration):
  - https://galeria.heban.pl/wp-sitemap.xml
  - https://galeria.heban.pl/sitemap.xml
  - https://galeria.heban.pl/sitemap_index.xml

## Catalog

Top categories by product count. This is a sample, not exhaustive: full enumeration via the sitemaps under Browse, or `POST /wp-json/wc/ucp/v1/catalog/search`.

- [Outlet](https://galeria.heban.pl/outlet-1/) (101 products)
- [Bez kategorii](https://galeria.heban.pl/bez-kategorii/) (66 products)
- [Meble](https://galeria.heban.pl/meble/) (1225 products)
- [Oświetlenie](https://galeria.heban.pl/oswietlenie/) (114 products)
- [Dekoracje](https://galeria.heban.pl/dekoracje/) (197 products)
- [Ogród](https://galeria.heban.pl/ogrod/) (41 products)
- [Akcesoria](https://galeria.heban.pl/akcesoria/) (1634 products)
- [Lifestyle](https://galeria.heban.pl/lifestyle-dekorracje/) (1 product)
- [Przedpokój](https://galeria.heban.pl/przedpokoj-mebke/) (2 products)
- [OŚWIETLENIE](https://galeria.heban.pl/oswietlenie-2/) (7 products)

Specializes in: Outlet, Bez kategorii, Meble, Oświetlenie, Dekoracje, Ogród, Akcesoria, Lifestyle, Przedpokój, OŚWIETLENIE.

## Shipping & Returns

- **Ships from**: PL
- **Returns**: https://galeria.heban.pl/zwroty-i-reklamacje/

## Policies

- **Privacy**: https://galeria.heban.pl/polityka-prywatnosci/
- **Terms**: https://galeria.heban.pl/regulamin/

## Structured data

Product pages emit schema.org/Product JSON-LD with `BuyAction.urlTemplate` for the per-product cart link, plus `MerchantReturnPolicy`, `OfferShippingDetails`, brand, price, availability, SKU, and GTIN where set. The `BuyAction` URL is the canonical deterministic cart link: it routes correctly across simple, variable, bundle, and grouped product types. The homepage emits `OnlineBusiness` with `hasOfferCatalog` and `SearchAction`.

## Rules for agents

- **Pace requests.** This store is rate-limited; on HTTP 429, back off and retry after a short delay.
- **Checkout is buyer-confirmed on this store.** There is no delegated or in-chat payment. Create a checkout session (or follow a product BuyAction link) and send the buyer the `continue_url` to complete payment on the merchant's own checkout.
- **Send `context.currency`** (ISO 4217) on catalog and checkout requests for accurate pricing. Accepted currencies are listed under Store.

## Typical agent flow

1. **Discover** — `GET https://galeria.heban.pl/.well-known/ucp` confirms capabilities and the supported UCP version, and advertises the REST API base (`https://galeria.heban.pl/wp-json/wc/ucp/v1`) plus the MCP transport (`https://galeria.heban.pl/wp-json/wc/ucp/v1/mcp`).
2. **Search** — `POST https://galeria.heban.pl/wp-json/wc/ucp/v1/catalog/search` (or `GET https://galeria.heban.pl/wp-json/wc/ucp/v1/catalog/search?q={query}`) to find products matching the buyer's intent. Send `context.currency` for accurate pricing.
3. **Look up** — `POST https://galeria.heban.pl/wp-json/wc/ucp/v1/catalog/lookup` (or `GET https://galeria.heban.pl/wp-json/wc/ucp/v1/catalog/lookup?ids={ids}`) for full details on the ids you selected.
4. **Create a checkout session** — `POST https://galeria.heban.pl/wp-json/wc/ucp/v1/checkout-sessions` with the line items; the response returns a `continue_url`.
5. **Hand off to the buyer** — redirect the buyer to that `continue_url` to review and pay on the store's own checkout. This store is buyer-confirmed: there is no delegated or in-chat payment to complete programmatically.

MCP-capable agents can drive the same flow over the MCP transport (`POST https://galeria.heban.pl/wp-json/wc/ucp/v1/mcp`) using the `catalog_search`, `catalog_lookup`, and `checkout_create` tools (call `tools/list` to discover their schemas).

## For agents

- **Agent doc**: `https://galeria.heban.pl/agents.md` (canonical agent doc; the same document is served at `/llms.txt`)
- **UCP manifest**: `https://galeria.heban.pl/.well-known/ucp` — capability discovery (what the store supports)
- **UCP API base**: `https://galeria.heban.pl/wp-json/wc/ucp/v1` — REST root for search, lookup, checkout
- **Batch lookup**: `GET https://galeria.heban.pl/wp-json/wc/ucp/v1/catalog/lookup?ids=prod_50431,prod_50425` — fetch up to 100 products in one request (or `POST /catalog/lookup`). Prefer this over many single lookups.
- **Checkout API**: `POST https://galeria.heban.pl/wp-json/wc/ucp/v1/checkout-sessions` — server returns a `continue_url`; redirect the buyer there. Product-specific cart links are also available via JSON-LD `BuyAction.urlTemplate` on each product page (deterministic across product types).

## Read-only browsing

For agents that only need to read catalog data without transacting:

- **Search** — `GET https://galeria.heban.pl/wp-json/wc/ucp/v1/catalog/search?q={query}` (UCP, structured, currency-aware)
- **Look up** — `GET https://galeria.heban.pl/wp-json/wc/ucp/v1/catalog/lookup?slug=sifas-krzeslo-basket` (UCP, structured, by product handle) or `?ids={ids}` for batch
- **All products (one file)** — `GET https://galeria.heban.pl/products.json` (Shopify-compatible; whole catalog, no params, no POST — simplest for fetch-only agents)
- **Product JSON** — `GET https://galeria.heban.pl/products/{handle}.json` (Shopify-compatible)
- **Collection JSON** — `GET https://galeria.heban.pl/collections/{handle}/products.json`
- **Collection list** — `GET https://galeria.heban.pl/collections.json`
- **Product images** — image URLs are in the `*.json` feeds above (`images[].src`). Page `<img>` tags and JSON-LD `image` are stripped by markdown-extraction fetch tools, so read product photos from the feeds, not the page HTML.

Prefer the UCP catalog endpoints for structured, currency-aware access; the `*.json` paths are a Shopify-compatible convenience.

<a id="ucp-extension"></a>
## Extension schema

Machine-readable JSON Schema for the `com.woocommerce.ai_storefront` UCP extension: `https://galeria.heban.pl/wp-json/wc/ucp/v1/extension/schema`