Seekmodo

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 WordPress / WooCommerce

One plugin covers both verticals. On a content-only WordPress site you get AI site search for posts, pages, and custom post types. When WooCommerce is installed on the same site, the commerce vertical activates automatically — variation-aware product results, stock and on-sale signals, no second zip.

This guide assumes:

  • WordPress 6.2+ (block editor or classic themes).
  • Admin access to install plugins.
  • Optional: WooCommerce for product search (see WooCommerce notes).
  • A Seekmodo account when you are ready to pair for cloud AI search (pricing — Enhanced Native works before you subscribe).

Stuck after install? See Troubleshooting.

1. Download the plugin

  1. Download the latest seekmodo-wordpress-*.zip from /plugins/wordpress (or from your account portal after signup).
  2. Verify the SHA-256 on the plugins page matches the file you downloaded.

2. Upload and activate

  1. WordPress admin → Plugins → Add New → Upload Plugin → choose the zip → Install Now → Activate.
  2. WordPress unpacks into wp-content/plugins/seekmodo-search/. Activation creates the events table and seeds defaults (MODE=off until you pair).

3. Enhanced Native (before you pair)

After activation, Enhanced Native improves local multi-field retrieval and typeahead with no Seekmodo account. Shoppers and readers already see better results; cloud AI ranking, analytics, merchandising, and MCP start when you pair and flip to Active.

4. Pair your tenant

  1. Open Settings → Seekmodo (or Seekmodo Search) and click Connect to Seekmodo.
  2. Sign in (or create an account) on seekmodo.com, pick or create a tenant, and complete the browser round-trip. The plugin stores your tenant ID and HMAC secret — no manual key paste.
  3. If the browser flow fails (firewall, Wordfence), use CLI: wp seekmodo connect --tenant=… --secret=… — details in Troubleshooting.

5. Index content (and products)

  1. Wait for the bulk-indexer cron tick, or run wp seekmodo index --full to seed posts/pages (and WooCommerce products when present).
  2. Confirm status under Settings → Seekmodo and on admin.seekmodo.com.

6. Learning / shadow → Active

  1. Run in learning or shadow mode for a few days to compare relevance against your top queries.
  2. Flip to Active from the connector admin or admin.seekmodo.com. WP_Query (and WooCommerce's native product query) remain the always-on fallback if the gateway is unreachable.

WooCommerce notes

  • Same zip as WordPress content search — no second plugin. On activation the commerce vertical lights up when WooCommerce is detected.
  • Product index includes variations, brands, categories, and stock / on-sale state used for facets.
  • SEO landing pages: WooCommerce AI search and WordPress content search.

Multisite

Network-activate when every site on the network should share the same connector package; pair each site (or blog) to its own Seekmodo tenant unless you have an agency multi-tenant arrangement. Contact [email protected] for federated WordPress farms.

MCP (agent-ready catalog)

After pairing on a paid plan, enable MCP from the operator console so ChatGPT, Claude, and Cursor can query the same index. See MCP docs and public MCP discovery.

Verify

  • Front-end search returns expected posts or products.
  • Typeahead responds on the theme search box.
  • Disconnecting the gateway in test still falls back to native WordPress / WooCommerce search.

Support