DeepSeek Harness

dsh-s1 is a native DeepSeek Harness (DSH) plugin that gives your dsh agent live web access through Search1API — web search, news search, readable page retrieval, sitemap discovery, and trending topics.

Unlike an MCP bridge, the plugin registers these capabilities as first-class DSH tools — the same layer as read, bash, and subagent — and runs in-process against the official @search1api/client SDK.

Install

Add the plugin to a DSH profile:

dsh plugin --profile web add dsh-s1

For a local checkout, use a path spec after building the package:

cd /path/to/dsh-s1
npm run build
cd ~/.dsh
dsh plugin --profile web add file:/path/to/dsh-s1

Credentials

1. Create a key in the Search1API dashboard.
2. Export it as S1_KEY:

export S1_KEY=...

The SDK reads the key lazily, so a missing key fails the tool call rather than plugin activation.

What your agent can do

• Live web search across Google, Bing, DuckDuckGo, Reddit, GitHub, YouTube, arXiv, and more
• News aggregation from multiple sources
• Page crawling with clean content extraction from a public URL
• Sitemap discovery to map a site's URLs or all public links
• Trending topics to surface what is hot right now

Every operation is read-only. Search results include source URLs that the agent can follow up on with a crawl.

Configuration

Each capability can be disabled independently in the plugin config:

Credits

Search and news requests cost one credit each; crawling a page costs one additional credit per successfully crawled page. New accounts receive 100 credits without a credit card. See Credits and limits for current rates.

Source

github.com/superagents-lab/dsh-s1 · npm · awesome-dsh-plugin