Seekmodo developer docs

Reference for the REST shim, MCP JSON-RPC surface, and storefront connectors. Authenticate with HMAC; replay window is 5 minutes.

← Back to Connectors

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/magento commands.
  • 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

  1. Magento Admin → System → Seekmodo → Connect Connect to Seekmodo.
  2. Complete the seekmodo.com pairing flow (pick or create a tenant).
  3. Confirm pairing status in the module admin and on admin.seekmodo.com.

3. Seed the catalog index

  1. Run a full index: bin/magento seekmodo:index --full
  2. Incremental sync runs via Magento cron afterward. Multi-store: each store view indexes into the tenant according to module configuration.
  3. Large catalogs: watch progress in Admin → System → Seekmodo before judging relevance.

4. Shadow → Active

  1. Run in shadow / learning mode for about a week against your top product searches.
  2. 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.

Support