Class SearchProviderService

Service for managing multiple search providers with fallback support

SearchProviderService

Example

const service = new SearchProviderService({
  serperApiKey: 'your-key',
  rateLimit: { maxRequests: 10, windowMs: 60000 }
});

const results = await service.search('query');

Index

Constructors

constructor

Methods

getAvailableProviders multiSearch search getRecommendedProviders normalizeUrl

Constructors

constructor

new SearchProviderService(config: SearchProviderConfig): SearchProviderService
Creates an instance of SearchProviderService
Parameters
- config: SearchProviderConfig
  Configuration for the service
Returns SearchProviderService
- Defined in research/web-search/src/services/searchProvider.ts:98

Methods

getAvailableProviders

getAvailableProviders(): string[]
Gets list of available providers based on configured API keys

Returns string[]
Array of available provider names
- Defined in research/web-search/src/services/searchProvider.ts:220

multiSearch

multiSearch(
query: string,
options?: { maxResults?: number },
): Promise<MultiSearchResponse>
Searches ALL available providers in parallel, then merges, deduplicates, and reranks results by cross-provider agreement.
Parameters
- query: string
- options: { maxResults?: number } = {}
Returns Promise<MultiSearchResponse>
- Defined in research/web-search/src/services/searchProvider.ts:662

search

search(
query: string,
options?: { category?: string; maxResults?: number; provider?: string },
): Promise<ProviderResponse>
Performs a search across available providers with automatic fallback
Parameters
- query: string
  The search query
- options: { category?: string; maxResults?: number; provider?: string } = {}
  Search options
  - Optionalcategory?: string
  - OptionalmaxResults?: number
    Maximum results to return
  - Optionalprovider?: string
    Specific provider to use
Returns Promise<ProviderResponse>
Search results with metadata

Throws
If all providers fail and no fallback is available
- Defined in research/web-search/src/services/searchProvider.ts:126

`Static`getRecommendedProviders

getRecommendedProviders(): {
    description: string;
    freeQuota: string;
    name: string;
    signupUrl: string;
}[]
Gets recommended search providers with signup information

Returns { description: string; freeQuota: string; name: string; signupUrl: string }[]
Array of provider recommendations

Static
- Defined in research/web-search/src/services/searchProvider.ts:769

`Static`normalizeUrl

normalizeUrl(rawUrl: string): string
Normalizes a URL for deduplication — strips www, tracking params, trailing slash.
Parameters
- rawUrl: string
Returns string
- Defined in research/web-search/src/services/searchProvider.ts:555

Class SearchProviderService

Example

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns SearchProviderService

Methods

getAvailableProviders

Returns string[]

multiSearch

Parameters

Returns Promise<MultiSearchResponse>

search

Parameters

`Optional`category?: string

`Optional`maxResults?: number

`Optional`provider?: string

Returns Promise<ProviderResponse>

Throws

`Static`getRecommendedProviders

Returns { description: string; freeQuota: string; name: string; signupUrl: string }[]

Static

`Static`normalizeUrl

Parameters

Returns string

Settings

On This Page

Class SearchProviderService

Example

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns SearchProviderService

Methods

getAvailableProviders

Returns string[]

multiSearch

Parameters

Returns Promise<MultiSearchResponse>

search

Parameters

Optionalcategory?: string

OptionalmaxResults?: number

Optionalprovider?: string

Returns Promise<ProviderResponse>

Throws

StaticgetRecommendedProviders

Returns { description: string; freeQuota: string; name: string; signupUrl: string }[]

Static

StaticnormalizeUrl

Parameters

Returns string

Settings

On This Page

`Optional`category?: string

`Optional`maxResults?: number

`Optional`provider?: string

`Static`getRecommendedProviders

`Static`normalizeUrl