Overview
The Seekmodo Magento 2 module (Numinix_Seekmodo) routes catalog search, indexer cron, click beacon, and typeahead through the Seekmodo gateway at mcp.seekmodo.com, while keeping Magento's native OpenSearch/Elasticsearch catalog search as the permanent degradation floor.
Enhanced Native improves multi-field product retrieval, popularity ranking, cached synonyms/pins, and local typeahead on the merchant server without a subscription. Pairing unlocks AI search, LTR, analytics, and the admin console.
What the module swaps
- Catalog search (SERP) — plugin on
CatalogSearch\Model\ResourceModel\Fulltext\Collectionreorders results by Seekmodo / Enhanced Native IDs. - Indexer cron — commerce + CMS content upserts in 500-document batches via
seekmodo_index_tick. - Click beacon —
/seekmodo/clickmirrors search and result-click events. - Typeahead —
/seekmodo/typeaheadJSON endpoint plus optional<seekmodo-suggest>web component when paired.
Requirements
| Requirement | Version |
|---|---|
| Magento | 2.3.4+ (Open Source or Adobe Commerce); 2.4.6+ recommended for new installs |
| PHP | 7.1.3+ (Magento 2.3.x) or 8.1+ (Magento 2.4+) |
| PHP extensions | ext-json, ext-hash; ext-sodium or paragonie/sodium_compat for pairing |
| Seekmodo subscription | seekmodo.com/pricing (optional for Enhanced Native) |
Operating modes
| Mode | Storefront behaviour |
|---|---|
off | Bypass Seekmodo; native Magento search only. |
shadow | Gateway called for observation; native result still served. |
active | Auto-promotes shadow → enforce based on gateway health. |
enforce | Gateway primary; native ES fallback when circuit breaker opens. |
Troubleshooting
- Verify module enabled:
bin/magento module:status Numinix_Seekmodo. - Check pairing:
bin/magento seekmodo:pair-status. - If search looks unchanged while paired, confirm mode is not
offon admin.seekmodo.com. - Gateway outages fall back to Enhanced Native, then native Elasticsearch — the storefront should never blank.