dsh-webscout

English | 简体中文

WebScout

Tavily-backed web search (Search) and page fetch (Fetch) for DeepSeek Harness — with a clean, two-column settings card.

Features

• Search provider webscout: Tavily /search with depth, topic, time range, answer mode, raw content, domains, country, images, retries and an optional result cache.
• Fetch provider webscout-fetch: one provider that can read a page through Tavily Extract, Firecrawl, or a direct HTTP request.
• Key rotation: several credential references form a ring; a key that keeps failing sits out for 60 seconds.
• Fallback: delegate to the built-in DeepSeek provider when Tavily is unreachable (optional).
• Settings card: live quota from Tavily /usage, connection test, search and fetch controls, and an advanced section for everything else.

Install

dsh plugin --profile <profile> add "file:/path/to/dsh-webscout"

The bundle patch elects webscout for search and webscout-fetch for fetch, so the card never writes the web service's config entry.

Configuration

Open Settings → Plugins → WebScout search. The card edits the plugin's own webscout section; the API key is stored in the local credential store under TAVILY_API_KEY (or the reference you configure).

Search fields

Field	Default	Notes
maxResults	5	1–20
searchDepth	basic	basic / advanced / fast / ultra-fast
topic	general	general / news / finance
includeAnswer	true	false / true / basic / advanced
includeRawContent	false	false / markdown / text
chunksPerSource	3	1–3
timeRange	—	day / week / month / year
days	—	recency window in days
includeDomains / excludeDomains	—	comma or space separated
country	—	country boost
cacheTtlSeconds	0	0 disables the cache
cacheMaxEntries	200	LRU cap
cacheBypassFresh	true	skip cache for news/finance/time-windowed queries
engine	tavily	tavily or deepseek
fallbackEngine	none	none or deepseek
citeFormat	plain	plain or footnote

Fetch fields

Field	Default	Notes
fetchMode	tavily	tavily / http / firecrawl
firecrawlApiKeyEnv	FIRECRAWL_API_KEY	credential reference
firecrawlBaseURL	https://api.firecrawl.dev/v1	endpoint base

License

MIT © 2026 Barry.