Seekmodo

Seekmodo developer docs

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

seekmodo-sdk

Full-featured Go module for the Seekmodo gateway. One module ships connector, storefront, admin, MCP, and tools packages covering the complete platform surface.

When to reach for this

Use connector for Go microservices and indexing workers. Use storefront in a Gin/Echo BFF that mints browser JWTs server-side. Use admin for ops automation. For browser widgets, prefer the JavaScript SDK.

Install

go get github.com/numinix/[email protected]

Requires Go >=1.22.

Connector quick start

import (
    "context"
    "github.com/numinix/seekmodo-sdk/connector"
    "github.com/numinix/seekmodo-sdk/connector/storage"
)

signer := connector.NewHmacSigner("your-tenant-id", "your-shared-secret")
breaker := connector.NewCircuitBreaker(storage.NewMemoryBreakerStore())
client := connector.NewClient(signer, connector.WithCircuitBreaker(breaker))

results, err := client.Search(ctx, map[string]any{
    "q": "red sneakers", "per_page": 24,
})
snapshot, err := client.TenantSnapshot(ctx) // POST /v1/tenant.snapshot

Packages

  • connector/ — HMAC client, circuit breaker, mode FSM, pairing, events, tenant snapshot poller.
  • storefront/ — JWT transport: Search, Suggest, SearchByImage, Chat, Event, Recommend.*, Bundle.Suggest.
  • admin/ — Admin-key REST client for synonyms, pins, LTR, analytics.
  • mcp/ — JSON-RPC Initialize, ToolsList, ToolsCall.
  • tools/ — Dynamic registry over connector paths.

Wire contract tests

Run go test ./tests/contracts/... — same 10 gateway wire tests as the PHP and Python SDKs.

Repo: github.com/numinix/seekmodo-go-sdk.