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 MediaWiki

The Seekmodo extension targets MediaWiki 1.39+ for public and internal knowledge bases. It routes Special:Search through Seekmodo when paired and active, with native MediaWiki search and CirrusSearch as the always-on fallback. Sign up with the Knowledge base vertical.

This guide assumes:

  • Shell access to run maintenance/*.php scripts.
  • A sysop account for Special:Seekmodo pairing.
  • A Seekmodo account when you are ready to pair (pricing — Enhanced Native works on install before you subscribe).

Product overview: MediaWiki search extension. Broader KB intent: Knowledge base search.

1. Download and extract

  1. Download seekmodo-mediawiki-v*.zip from /plugins/mediawiki.
  2. Extract into extensions/Seekmodo/ (folder name must be Seekmodo).

2. Enable the extension

Add to LocalSettings.php:

wfLoadExtension( 'Seekmodo' );

Then apply schema updates:

php maintenance/update.php

3. Seed the index

php extensions/Seekmodo/maintenance/SeekmodoIndex.php --full
php maintenance/runJobs.php

Incremental updates use MediaWiki's JobQueue so new revisions become searchable without blocking editors. Keep runJobs.php (or a job runner) healthy in production.

4. Pair as sysop

  1. As a sysop, open Special:Seekmodo → Connect to Seekmodo.
  2. Complete the seekmodo.com pairing flow with a Knowledge base tenant.
  3. Confirm status on Special:Seekmodo and admin.seekmodo.com.

5. Enhanced Native → Active

Enhanced Native improves local retrieval before you pair. After pairing, run in learning / shadow for a short validation window, then flip to Active. If the gateway is unreachable, Special:Search falls back to native or CirrusSearch automatically.

CirrusSearch coexistence

Seekmodo does not require you to uninstall CirrusSearch. Keep it (or native search) as the degradation floor. When Seekmodo is paired and active, Special:Search and typeahead route through the gateway.

Namespaces and private wikis

Configure namespace filters in the extension admin before the first full index if only some namespaces should be searchable. Private wikis: SSO stays MediaWiki's job; Seekmodo indexes what the connector syncs under your visibility rules. Federated multi-wiki farms: contact us for provisioning.

MCP for internal copilots

Paid plans expose per-tenant MCP so Claude, Cursor, and ChatGPT can query the live wiki index. See MCP docs and public MCP discovery.

Verify

  • Special:Search returns expected articles for a known title and a typo-laden query.
  • Typeahead responds where the skin exposes it.
  • With the gateway blocked in staging, Special:Search still returns native / Cirrus results.

Support