DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-web-search-searchapi

d

dsh-web-search-searchapi

Manifest valid

SearchApi search provider for the built-in web_search tool: one GET to SearchApi's Google engine per search, organic results mapped to sources (title, snippet, ISO publication date), and Google's goto

hasBundlePatch

dsh-web-search-searchapi

A SearchApi search provider for the DeepSeek Harness web seam (ctx.web).

One backend, one job: the web_search tool sends the query to SearchApi's Google engine and gets the organic results back as sources, in dsh web, dsh-TUI and headless runs. No settings card, no fan-out, no state. web_fetch is unchanged.

  • Single GET to https://www.searchapi.io/api/v1/search?engine=google
  • Key from the credentials service, then $SEARCHAPI_API_KEY (or a literal apiKey in your profile patch)
  • organic_results[] mapped to { url, title, snippet, publishedAt }; maxResults honored
  • Google's google.com/goto redirect links are followed one hop, in parallel, so sources cite the real page
  • Clear failures: missing key, non-2xx with SearchApi's own error message, timeout, cancellation

Requirements

  • DeepSeek Harness with the web service (any profile that mounts @deepseek-ai/dsh-base); tested against dsh 0.2.2-rc.1
  • Node 20.3 or newer
  • A SearchApi API key: https://www.searchapi.io/

Install

dsh plugin --profile web add github:gabsferreira/dsh-web-search-searchapi

The package ships its own bundle patch: it mounts the provider and points the web seam's searchProvider at searchapi (keeping fetchProvider: http). Nothing else to wire up; only the key is missing.

Store the key

Either through the credentials service, in $DSH_HOME/.credentials.yaml (keep it at chmod 600):

version: 1
refs:
  SEARCHAPI_API_KEY: your-key

or in the environment that launches dsh:

SEARCHAPI_API_KEY=your-key dsh web

The key is resolved at every search (credentials service first, then the environment), so a rotated key applies without a restart.

Verify

Ask for something current. A missing key surfaces as SearchApi search has no API key: …, a wrong one as SearchApi returned HTTP 401: Invalid API key..

Configuration

All optional. Set them on the web-search-searchapi row in your profile patch ($DSH_HOME/profiles/<profile>/cordis.patch.yml):

- id: web-search-searchapi
  config:
    apiKeyEnv: SEARCHAPI_API_KEY
    gl: br
    hl: pt
keydefaultwhat it does
apiKeyEnvSEARCHAPI_API_KEYcredential reference and environment variable the key is read from
apiKeya literal key; prefer the credentials service
enginegoogleany SearchApi engine that returns organic_results (bing, duckduckgo, …)
gl, hlGoogle country and language
resolveLinkstruetrue: follow Google's goto redirect links one hop from this process; 'api': ask SearchApi for link=resolved instead (complete, but 26 to 28 s slower per search, see below); false: leave them
linkTimeoutMs3000per redirect link, in the default mode
timeoutMs30000whole search
baseURLhttps://www.searchapi.io/api/v1/searchthe endpoint

A patch entry's config replaces the row's config, so repeat apiKeyEnv when you add keys to the row.

How it maps

  • num is not sent: Google phased it out and SearchApi documents it as a constant 10. maxResults is applied to the mapped sources, and the seam enforces it again.
  • publishedAt is an ISO calendar date (2026-10-12) built from SearchApi's date when it is an absolute date; relative dates ("2 days ago") are dropped rather than guessed.
  • Google serves part of the organic links as https://www.google.com/goto?url=…, a 302 to the page. In the default mode each one is followed exactly one hop (a tenth of a second each, in parallel, never reading the body). Google sometimes answers with a "verifying your request" page instead of the redirect; that link is kept as it came, and still redirects when opened. SearchApi's own link=resolved waits that check out server-side, which is why 'api' mode is complete but slow.
  • Errors are the host's WebError, so tool results keep a structured code: WEB_PROVIDER_CREDENTIAL_MISSING, WEB_PROVIDER_ERROR (with status on HTTP failures), WEB_ABORTED. SearchApi's error message rides on the error when the body is JSON; the key never does.

Development

npm install
npm test                 # unit (mock SearchApi on loopback) + contract (real @deepseek-ai/dsh-web seam)
DSH_BIN=<dsh>/lib/bin.js npm test   # also composes the bundle with a real dsh (--dump-config)

No network leaves the box during tests.

License

MIT. Built by Gabs Ferreira, developer advocate at SearchApi.

Comments

Loading…

Similar plugins

dsh-search

by 439436269-ctrl

Web search, page fetch and one-call research through DeepSeek's official Search and Fetch API; needs a DeepSeek API key.

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Nov 7, 2026

dsh plugin --profile web add @vfvrpq/dsh-search

by bug-huntter

Switchable web-search provider for DSH: native DeepSeek web search or an OpenAI-compatible custom backend. Installation automatically routes DSH web searches to the plugin; only provider, API key and

Tools & CapabilitiesManifest valid

★ 0

↓ 445/wk

TypeScript

Sep 28, 2026

dsh plugin --profile web add @lp181818/web-search-advanced

by SeaViod

Switch DSH's built-in web_search between the DeepSeek Search API (/v1/tools/search) and the default account search, with automatic fallback, a settings page and a sidebar switch.

Tools & CapabilitiesManifest valid

★ 2

MIT

JavaScript

Oct 17, 2026

dsh plugin --profile web add dsh-plugin-deepsearch

by ForeverYoungPp

Multi-provider third-party web search for the DeepSeek Harness: routes the native web_search tool through a configurable provider fallback chain, with an isolated provider settings page.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Sep 1, 2026

dsh plugin --profile web add @deepseek-ai/dsh-web-search

by aaronlei

DSH web search provider with three selectable protocols: any OpenAI-compatible Responses API gateway exposing the native web_search tool, Zhipu's Web Search API (basic retrieval), and Zhipu's Web Search in Chat (answer augmentation). Registers a ctx.web search provider and overrides the shared searchProvider to it; UI copy follows the app language (zh / en).

Terminal & ClientsManifest valid

★ 5

↓ 449/wk

MIT

JavaScript

Oct 20, 2026

dsh plugin --profile web add dsh-web-search-diy

by Oxygen640

Zero-key web search provider for the built-in web_search tool: scrapes Bing China, 360 and SearXNG through a backend fallback chain and returns real URLs with snippets and publish dates. No API key an

Tools & CapabilitiesManifest valid

★ 1

MIT

JavaScript

Oct 25, 2026

dsh plugin --profile web add dsh-plugin-nuaa-search