API: ranking/rerank

better-web-search-mcp


better-web-search-mcp / ranking/rerank

ranking/rerank#

Interfaces#

RankedResult#

Defined in: src/ranking/rerank.ts:10

A ranked result: the original result plus its computed relevance score.

Extends#

Properties#

PropertyTypeDescriptionInherited fromDefined in
published?stringISO date string of publication, when the provider exposes it.SearchResult.publishedsrc/providers/types.ts:19
relevancenumberCombined relevance score in [0, 1].-src/ranking/rerank.ts:12
score?numberA 0-1 relevance/quality score assigned by the provider, when available.SearchResult.scoresrc/providers/types.ts:21
snippetstringA short text snippet / description of the result.SearchResult.snippetsrc/providers/types.ts:17
sourcestringThe name of the provider that produced this result.SearchResult.sourcesrc/providers/types.ts:23
titlestringThe result title.SearchResult.titlesrc/providers/types.ts:13
urlstringThe canonical URL of the result.SearchResult.urlsrc/providers/types.ts:15

Functions#

rerank()#

rerank(results, query, recencyDays?): RankedResult[]

Defined in: src/ranking/rerank.ts:24

Re-rank search results against a query.

Score = 0.5 * termOverlap + 0.2 * domainScore + 0.2 * recencyBoost + 0.1 * normalizedOriginalScore

Pure function: does not mutate the input array. Results are returned sorted by relevance descending.

Parameters#

ParameterTypeDefault value
resultsreadonly SearchResult[]undefined
querystringundefined
recencyDaysnumberDEFAULT_RECENCY_DAYS

Returns#

RankedResult[]