Seekmodo developer docs
Reference for the REST shim, MCP JSON-RPC surface, and storefront connectors. Authenticate with HMAC; replay window is 5 minutes.
Installing Seekmodo on Magento 2
The Numinix_Seekmodo module targets Magento Open Source and Adobe Commerce 2.4+. Enhanced Native improves local catalog retrieval on install; pair for gateway AI search, analytics, merchandising, and MCP. Native OpenSearch / Elasticsearch stays the degradation floor.
This guide assumes:
- SSH / CLI access to run
bin/magentocommands. - Admin access for pairing (System → Seekmodo).
- A Seekmodo account when you are ready to pair (pricing).
Platform overview: Magento search module. Ops-focused ES alternative: Magento Elasticsearch alternative.
1. Install the module
Composer (preferred):
composer require numinix/module-seekmodo:^1.0 bin/magento module:enable Numinix_Seekmodo bin/magento setup:upgrade bin/magento cache:flush
Zip: download from /plugins/magento, extract under app/code/Numinix/Seekmodo (or follow the zip README), then run the same module:enable, setup:upgrade, and cache:flush commands.
2. Pair your tenant
- Magento Admin → System → Seekmodo → Connect → Connect to Seekmodo.
- Complete the seekmodo.com pairing flow (pick or create a tenant).
- Confirm pairing status in the module admin and on admin.seekmodo.com.
3. Seed the catalog index
- Run a full index:
bin/magento seekmodo:index --full - Incremental sync runs via Magento cron afterward. Multi-store: each store view indexes into the tenant according to module configuration.
- Large catalogs: watch progress in Admin → System → Seekmodo before judging relevance.
4. Shadow → Active
- Run in shadow / learning mode for about a week against your top product searches.
- Flip to Active on admin.seekmodo.com (or the module admin). Native catalog search remains the fallback if the gateway is unreachable.
Hyvä, Varnish, and Adobe Commerce Cloud
- The module hooks Magento's standard search swap-point — Hyvä themes use the same path. Verify typeahead placement if you customize search templates.
- Full-page cache: catalog search requests should bypass Varnish (normal Magento practice).
- Adobe Commerce Cloud: confirm cron and indexer permissions with your Adobe partner before production cutover.
MCP
Paid plans expose a per-tenant MCP server. Enable from the operator console — see MCP docs.
Verify
- Storefront search returns products from the paired tenant.
- Typeahead responds on the theme search box.
- Stopping the gateway in a staging test falls back to native Magento search.