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

Install Seekmodo on Shopify

Seekmodo for Shopify is a hosted Cloudflare Worker app at shopify-app.seekmodo.com. It installs via Shopify OAuth (same shape as our BigCommerce connector), pairs to a Seekmodo tenant, and injects storefront widgets through a Theme App Extension — not by rewriting theme Liquid in your repo.

1. Install the app

  1. Open the listing on the Shopify App Store (or visit shopify-app.seekmodo.com/auth).
  2. Select your shop and approve the OAuth scopes.
  3. Choose a Managed Pricing plan (Hobby / Starter / Growth). A 14-day trial is available; Enhanced Native search works without a paid plan.

2. Pair to Seekmodo

After OAuth you are redirected to seekmodo.com/connect with a short-lived install_token. Sign in, pick or create a tenant, and complete pairing. The embedded Apps → Seekmodo panel shows pairing state afterward.

3. Enable the App embed (suggest)

  1. Online Store → Customize → App embeds → enable Seekmodo.
  2. Click Save. Shopify does not allow apps to turn embeds on via API — a merchant click is required.

That lights up typeahead (suggest) on your theme. SerpSurface defaults to suggest_only: pressing Enter still opens Shopify's native /search?q=… until you add the search-results block (next section).

4. Enable Seekmodo search results (optional)

Unlike BigCommerce's Script Manager paint-over, Shopify SERP is an App Block on the Search template:

ModeWhat shoppers see
suggest_only (default)Suggest on; Enter → native Shopify search
serp_blockSearch template hosts the Seekmodo SERP app block; View-all → /search?q=
theme_ownedCustom theme sets __seekmodoThemeSearchOwned and owns the results shell
  1. Online Store → Customize → open the Search template.
  2. Add app block Seekmodo search results (SERP) to the main section.
  3. Hide or remove the theme's native "Search results" section so only Seekmodo renders.
  4. Save. The connector detects the block and sets SerpSurface to serp_block.

Deep link pattern (replace store handle and API key from the Apps → Seekmodo checklist):

https://admin.shopify.com/store/{store}/themes/current/editor?template=search&addAppBlockId={api_key}/serp&target=mainSection

Other blocks (recommendations, vehicle, VIN) follow the same Theme Editor pattern. Details live in the connector repo docs/THEME_BLOCKS.md.

5. Index & go live

Pairing registers webhooks and triggers a full catalog index. Search mode starts in active (with Shopify native fallback). Use the embedded admin to reindex, map metafields, or change search mode.

6. Verify

  • Header search typeahead returns products from your catalog.
  • With the SERP app block enabled, Enter on search shows Seekmodo results on /search?q=….
  • Optional: enable Recommendations / Vehicle / VIN blocks on product or home templates.

Privacy & compliance

Privacy: /legal/shopify-privacy · Security: /legal/security · DPA: /legal/dpa. We implement Shopify's mandatory GDPR webhooks (customers/data_request, customers/redact, shop/redact).

← Plugin overviewConnectors hubBigCommerce install