Welcome to Neuroon
Neuroon is an AI-powered semantic search engine for e-commerce. It replaces traditional lexical search (LIKE, full-text) with Neuroon AI, which understands user intent and converses, not just matches keywords.
This documentation describes what exists today in production. It is not a roadmap and does not list planned capabilities as if they were available. If a capability is not listed here, assume it is not yet implemented and check What's not supported.
Who Neuroon is for
- Stores with a catalog of at least several hundred products where lexical search already fails (synonyms, long descriptions, heterogeneous attributes).
- Teams that can sync the catalog through the API (server-to-server) and embed a widget in the front end.
- Heterogeneous stacks: WordPress/WooCommerce, .NET / WordPress, custom stores in Node, PHP, Python, Java, or Ruby.
Product map
Neuroon ships three surfaces that integrate independently:
- Widget: Preact component embedded via a
<script>tag from the CDN (cdn.neuroon.ai). There is no officialnpmpackage. - API Widget (
/api/widget/*): consumed by the browser, authenticated with a Widget Token (headerX-Widget-Token). - API Plugin (
/api/plugin/shops/*): consumed by your server (WordPress, custom) to sync products, verify the domain, and report conversions. Authenticated withX-Shop-API-Key.
How Neuroon integrates with your store
A minimal viable integration consists of:
- Provisioning a shop in Neuroon (Dashboard) and issuing a
Shop API Key(sk_<32hex>) and aWidget Token. - Syncing the catalog via
POST /api/plugin/shops/{shopId}/products/sync. Batches of up to 500 products per request. - Embedding the widget through a
<script>tag withdata-*attributes (data-token,data-container,data-locale,data-api-url). - Tracking clicks and conversions to close the learning loop.
Continue
- Quickstart — minimal integration in 5 steps, 5–10 minutes.
- Architecture — data flow, eventual consistency, dual authentication.
- What's not supported — honest list of what does not exist.