Project Files

.claude

settings.local.json

src

bing

build-urls.ts

index.ts

parse-results.ts

search-images.ts

cache

image-search-results-payload.ts

index.ts

search-cache-key.ts

ttl-cache.ts

web-search-results-payload.ts

config

auto-sentinel.ts

config-defaults.ts

config-schematics.ts

resolve-config.ts

duckduckgo

build-urls.ts

index.ts

parse-results.ts

search-web.ts

web-search-result.ts

enrichment

enrich-search-results.ts

index.ts

metascraper-helpers.d.ts

metascraper.ts

errors

abort-error.ts

error-message.ts

index.ts

no-results-error.ts

tool-error.ts

unsupported-content-type-error.ts

index.ts

lmstudio-home.ts

markdown-path.ts

url-filename.ts

http

challenge.ts

decode.ts

fetch-error.ts

fetch-retry.ts

fetch.ts

impit-client.ts

impit-error.ts

index.ts

parse-content-type.ts

redirects.ts

response-body.ts

ssrf.ts

url-schema.ts

url.ts

images

download-image.ts

download-images.ts

index.ts

page

fetch-page.ts

fetched-page.ts

index.ts

page-kind.ts

parsers

image-extensions.ts

index.ts

page-images.ts

page-text.ts

parse-html.ts

pdf-text.ts

renderers

image-results.ts

index.ts

page-result.ts

retrieval

chunking.ts

excerpt.ts

index.ts

relevance.ts

selection.ts

index.ts

safe-search.ts

search-page-parameter.ts

text

escape-markdown.ts

html-to-markdown.ts

html-to-text.ts

index.ts

normalize-blank-lines.ts

normalize-text.ts

timing

index.ts

per-host-rate-limiter.ts

rate-limiter.ts

tools

fetch-images-tool.ts

image-search-tool.ts

visit-website-tool.ts

web-search-tool.ts

index.ts

tools-provider.ts

.gitignore

.prettierrc.json

CLAUDE.md

eslint.config.mjs

knip.json

LICENSE

manifest.json

package-lock.json

package.json

QWEN.md

README.md

thumbnail.png

tsconfig.json

tsdoc.json

src / duckduckgo / search-web.ts

/**
 * DuckDuckGo web-search entry point.
 */

import { fetchOrThrow } from "../http"

import { buildWebSearchUrl } from "./build-urls"
import { parseDuckDuckGoResults } from "./parse-results"

import type { RequestOptions } from "../http"
import type { SearchParameters } from "./build-urls"
import type { WebSearchResult } from "./web-search-result"
import type { Impit } from "impit"

/**
 * Perform a DuckDuckGo web search and return the parsed result records.
 *
 * @param impit - Shared HTTP client used for the request.
 * @param parameters - Query and pagination parameters for the search.
 * @param maxResults - Upper bound on the number of parsed results returned; `Infinity` for no cap.
 * @param options - Options controlling the outbound request.
 * @returns The parsed search results, ready for enrichment.
 */
export async function searchWeb(
  impit: Impit,
  parameters: SearchParameters,
  maxResults: number,
  options: RequestOptions
): Promise<WebSearchResult[]> {
  const url = buildWebSearchUrl(parameters).toString()
  const response = await fetchOrThrow(impit, url, options)
  const html = await response.text()

  return parseDuckDuckGoResults(html, maxResults)
}

web-tools