Search Enhance for DeepSeek Harness

English | 简体中文

dsh-search-enhance is a search extension for DeepSeek Harness. It uses a Grok-compatible Search API for primary web answers and can optionally use Context7, Exa, Tavily, and Firecrawl for documentation lookup, supplementary discovery, page extraction, and site mapping.

The plugin handles search, source retention, and page retrieval as separate steps. web_search and docs_search return an answer or documentation snippets with visible sources; the complete source record can be stored under a source_ref and paged later. Important pages can then be retrieved with web_extract, so search snippets remain distinct from fetched page content.

Bring your own endpoints and credentials. The plugin ships no API keys. A Grok-compatible endpoint is required for web_search; Context7, Exa, Tavily, and Firecrawl are optional.

Key characteristics

• web_search uses the Grok-compatible endpoint for the main answer, adds Exa for documentation-oriented queries, and uses Tavily or Firecrawl within the configured supplementary budget.
• Sources are normalized, de-duplicated, and reordered using source category, requested version, and publication-time signals before they are shown.
• source_ref keeps the complete source record in private durable storage, allowing the Agent to paginate beyond the links included in the initial result.
• docs_search uses Context7 only with an explicit library_name or library_id; requests without a library identity use Exa discovery.
• web_extract follows the fixed Tavily → Firecrawl → smart_direct → direct route and reports the retrieval route, evidence level, and available page metadata.
• Source pagination, Context7 detail operations, site mapping, research planning, and diagnostics are disclosed on demand through search_tools and search_call.
• Native Tool Mode and Code Mode use the same fixed tool surface and canonical outputs. DSH Settings, Credentials, Agent Presets, guards, and lifecycle cleanup continue to apply.
• Optional Providers are skipped when unconfigured. Tavily and Firecrawl supplementary-search budgets default to 0, and optional Provider failures remain visible in the result.

For the complete routing, evidence, and progressive-disclosure flow, see Search workflow architecture.

Quick start

1. Install

Install the published bundle into the DSH web profile:

dsh plugin --profile web add dsh-search-enhance@latest

2. Start DSH Web

dsh web

3. Configure search

Open:

Settings → Plugins → Plugin configuration → dsh-search-enhance

Under Grok search backend, configure:

1. the xAI endpoint or an explicit Grok-compatible gateway;
2. the matching completions or responses protocol;
3. a model supported by that endpoint;
4. the Grok credential in the card's Credentials section.

The default credential reference is SEARCH_API_KEY. Credential values are stored through DSH Credentials and are not exposed as model parameters.

Save the settings, restart DSH, and ask a current-information question. A successful run shows a Search tool row, an answer, and source links.

Example requests

Use normal language; the plugin gives the Agent routing guidance.

…