knockoutez/wigolo/wigolo-search

wigolo search

Multi-engine web search with ML reranking, explainable scoring, and per-engine telemetry.

Quick Reference

// Basic search
{ "query": "react hooks tutorial" }
// Multi-query array for broader coverage
{ "query": ["react hooks tutorial", "useEffect patterns 2026", "react state management"] }
// Domain-scoped for framework docs
{ "query": "authentication setup", "include_domains": ["nextjs.org", "authjs.dev"] }
// Phrase-exact search
{ "query": "Cannot read properties of undefined", "exact_match": true }
// Time-bounded
{ "query": "AI tools", "time_range": "month" }
// Country-scoped
{ "query": "election results", "country": "gb", "category": "news" }
// Sub-second budget — cache-only
{ "query": "react hooks", "search_depth": "ultra-fast" }
// Direct-answer synthesis
{ "query": "RSC vs SSR differences", "format": "answer" }
// Fresh content (bypass cache)
{ "query": "latest news", "force_refresh": true }

Parameters

Always-Emitted Fields

• engines_used, engine_telemetry — per-engine name, latency, result count, outcome, dedup_kept.
• response_time_ms — alias of total_time_ms for client compatibility.
• Per-result evidence_score — explainable breakdown (relevance + domain quality + lexical alignment + freshness).
• Per-result freshness_signal — published_date + inferred + confidence.
• query_understanding — intent, entities, date hint, language, is_brand_collision_prone, considered rewrites.
• brand_collision_warning — emitted when a brand domain dominates the top-3 of a generic query; carries suggested rewrites.

Patterns

Focused lookup:

{ "query": "prisma migrations guide", "include_domains": ["prisma.io"], "max_results": 3 }

Broad research:

{ "query": ["state management React 2026", "Redux vs Zustand", "Jotai vs Recoil"], "max_results": 10 }

Direct answer:

{ "query": "how does React Suspense work", "format": "answer" }

Anti-Patterns

• DON'T send natural-language questions; use keyword phrases.
• DON'T make N separate calls; use one multi-query array.
• DON'T search without checking the cache first.
• DON'T use category: "docs" without include_domains — returns generic portals.

When NOT to use wigolo-search

• Login-gated pages — wigolo cannot authenticate before fetching; use fetch with use_auth for stored sessions.

See Also

• wigolo-fetch — when you have the URL
• wigolo-research — when you need comprehensive analysis
• wigolo/rules/cache-first.md — check cache before searching