Seekmodo developer docs
Reference for the REST shim, MCP JSON-RPC surface, and storefront connectors. Authenticate with HMAC; replay window is 5 minutes.
Connectors
Pre-built plugins for the popular storefront platforms. Each plugin handles HMAC signing, the search swap-point, and the indexer cron for you.
Available
Drop-in plugin for Zen Cart 1.5.7+. Swaps your storefront search over to Seekmodo and keeps the catalog in sync. Three modes — off, learning, active — let you cut over without surprises.
- Download the connector from your account portal once your trial is set up.
- Drop it into your Zen Cart's zc_plugins/ directory and visit Admin → Plugin Manager → Install.
- Click 'Connect to Seekmodo' in your store admin to pair the install with your Seekmodo account in one step (no API keys to copy).
- Run a week in 'learning' mode to verify, then flip to 'active'.
Available
WordPress 6.2+ plugin for content sites and stores running WooCommerce. Auto-detects Custom Post Types and routes WP search through Seekmodo with WP_Query as the always-on fallback. Activates the bundled WooCommerce vertical automatically when WC is detected.
- Download the latest seekmodo-wordpress-*.zip from your account portal.
- WordPress admin → Plugins → Add New → Upload Plugin → choose the zip → Install Now → Activate.
- Open Settings → Seekmodo and click 'Connect to Seekmodo' — the plugin round-trips to seekmodo.com and pairs your tenant automatically.
- WP search now flows through Seekmodo with WP_Query as the always-on fallback. Run in 'learning' for a week, then flip to 'active'.
- If WooCommerce is installed on the same site, the commerce vertical auto-activates and indexes products on the next bulk-indexer tick (or run `wp seekmodo index --full`). No second plugin needed.
Available
Native WooCommerce product search via the Seekmodo WordPress plugin: variation-aware, on-sale faceted, stock-aware. Same zip as the WordPress connector — install once, light up both verticals.
- Download the latest seekmodo-wordpress-*.zip from your account portal — WooCommerce ships inside the same WordPress connector zip.
- WordPress admin → Plugins → Add New → Upload Plugin → choose the zip → Install Now → Activate.
- On activation the plugin auto-detects WooCommerce. The commerce vertical lights up alongside the content vertical without any toggles.
- Open Settings → Seekmodo and click 'Connect to Seekmodo' to pair the tenant.
- Run `wp seekmodo index --full` (or wait for the bulk-indexer cron tick) to seed products, variations, brands, categories, and stock state into the gateway.
- Run in 'shadow' for a week to verify relevance against your top product searches, then flip to 'active'. WooCommerce's native `WC_Product_Query` stays armed as the always-on fallback.
Available
Magento 2.4+ module for Open Source and Adobe Commerce. Enhanced Native improves catalog search on install; pair for gateway AI search, multi-store indexing, and Growth-tier widgets.
- Download seekmodo-magento-v*.zip from seekmodo.com/plugins/magento or require via Composer: `composer require numinix/module-seekmodo`.
- Enable the module: `bin/magento module:enable Numinix_Seekmodo && bin/magento setup:upgrade && bin/magento cache:flush`.
- Admin → System → Seekmodo → Connect → Connect to Seekmodo to pair your tenant.
- Run `bin/magento seekmodo:index --full` to seed products and CMS pages per store view.
- Run in shadow mode for a week, then flip to active on admin.seekmodo.com. Native OpenSearch/Elasticsearch stays the degradation floor.
Beta
Official BigCommerce App Marketplace connector. OAuth install pairs your store to Seekmodo for AI search, vehicle fitment, VLPs, recommendations, and Script Manager storefront widgets.
- Install Seekmodo from the BigCommerce App Marketplace (or open https://bigcommerce-app.seekmodo.com/install from a store admin session).
- Allow the OAuth scopes (Information read-only, Products, Customers, Content).
- Complete pairing at seekmodo.com/connect — pick or create your Seekmodo tenant.
- Open Apps → Seekmodo to confirm pairing and wait for the first catalog index.
- Map custom fields in the admin iframe if your part numbers use merchant-specific names (e.g. EZ # → ez_number).
- Optional Stencil/Catalyst snippets live in the connector docs/storefront-snippets/ for theme-specific vehicle UI.
Available
Roll your own with the REST or MCP API. Every endpoint is documented and there's an interactive sandbox you can sign requests against with a demo tenant key.
- Grab your tenant_id and shared secret at admin.seekmodo.com → Settings → Developer / API credentials. Rotate the secret any time; old keys stay valid for 10 minutes during rotation.
- Pick a stack — Node, Python, PHP, Ruby, Go all work.
- Sign requests with HMAC-SHA256 (see the REST tab for the canonical request shape).
- Hit POST /v1/search to verify; you should see results within ~50ms.
Want to test a request without writing any code? Try the Sandbox — we sign with a demo tenant key on the server side.
Building a custom PHP storefront connector? The first-party Zen Cart and WordPress connectors all ship on top of the PHP SDK (composer require numinix/seekmodo-connector) — same HMAC + circuit-breaker + mode-FSM + pairing plumbing, ready to drop into your platform-specific glue.