# BasketBooster Recommender

> AI product recommendations, visually similar products, typo-tolerant
> search, search-by-photo and Shop-the-Look for online stores. One script
> tag. These docs cover the integration for WooCommerce and custom
> (non-Shopify) storefronts.

MCP server (list/read/search tools): https://api.basketbooster.eu/mcp

## Docs

- [Getting Started (non-Shopify stores)](https://api.basketbooster.eu/docs-md/getting-started.md): Sign up, connect your catalog, embed the widget, send events — the 15-minute integration path for WooCommerce and custom storefronts.
- [Widget Embed Guide](https://api.basketbooster.eu/docs-md/widget-embed.md): The <product-recs>, <product-search> and <shop-the-look> web components: script tags, every data-* attribute, purchase tracking, theming.
- [API Reference](https://api.basketbooster.eu/docs-md/v1-api-reference.md): The public /v1 widget API (publishable key) and the server API: catalog push /v1/items, single-order sync /v1/orders, order-history upload, integration endpoints (X-API-Key).
- [WooCommerce Plugin](https://api.basketbooster.eu/docs-md/woocommerce-plugin.md): Install the plugin, connect it with your keys, sync the catalog, and place widgets via auto-inject, shortcodes or Gutenberg blocks.
- [Integration Data Checklist](https://api.basketbooster.eu/docs-md/data-quality-checklist.md): Which fields to send to which endpoint and what each unlocks: sku + stock_qty on catalog pushes, quantity/price/timestamps on orders, customer ids, session continuity, source echoes — the audit list for upgrading a custom integration.
- [Customer Intelligence Feed](https://api.basketbooster.eu/docs-md/customer-feed.md): Pull per-customer segments, churn risk, CLV, replenishment triggers and personalized product recommendations into Klaviyo, Mailchimp or any email/CRM tool (X-API-Key).
- [Publishable Keys & CORS](https://api.basketbooster.eu/docs-md/publishable-keys-and-cors.md): pk_ vs secret API keys, where each belongs, and how the per-key origin allowlist controls which sites may use your widget.
- [Plans & Billing](https://api.basketbooster.eu/docs-md/plans-and-billing.md): The 14-day card-less trial, plan lineup and quotas, overage behaviour, quota headers, and how over-quota serving degrades gracefully.
- [Demand Forecasting](https://api.basketbooster.eu/docs-md/forecasting.md): Daily per-product forecasts with p10/p90 bands, honest accuracy metrics, stockout alerts, replenishment with supplier purchase orders, overstock/markdowns with margin floors, a promo calendar and manual overrides.
- [Прогноза на търсенето (Demand Forecasting, Bulgarian)](https://api.basketbooster.eu/docs-md/forecasting-bg.md): Българското издание на Demand Forecasting: дневни прогнози по продукт, аларми преди изчерпване, зареждане с поръчки към доставчици, залежала стока и намаления, промо календар и ръчни корекции.
- [Search Settings](https://api.basketbooster.eu/docs-md/search-settings.md): Tune product search from the dashboard: field weights, synonyms, Latin↔Cyrillic matching, and AI (semantic) search with your own OpenAI key — and which changes need a reindex.

## API reference

- [Interactive Swagger UI](https://api.basketbooster.eu/docs)