dsh-web-search-serper
基于 Serper.dev 的 DSH (DeepSeek Harness) Web 能力接口 (ctx.web) 搜索提供程序——一行插入，通过配置 / 环境变量 / 凭据存储提供密钥
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Dingpenghui-good/dsh-web-search-serper#801dce68bad986612d9dcb64b921b62da9218f6cWeb Search Serper 以 dsh-web-search-serper 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
@dingpenghui/dsh-web-search-serper is a web search provider plugin backed by the Serper.dev API, for the current DeepSeek Harness (DSH) web capability seam (ctx.web, @deepseek-ai/dsh-web 0.2.0-rc.x).
Serper.dev is an official Google Search partner providing fast, structured Google search results API. Free tier: 2,500 queries per month, no credit card required.
cordis.patch.yml; key resolved lazily per search (config → env → credential store), no restart on change# 作为 profile bundle 装入（推荐）：
# 1. 在 profile 的 package.json `dependencies` 加：
# "dsh-web-search-serper": "link:<本目录绝对路径>"
# 2. 同步 `dsh.profile.bundles` 加 "dsh-web-search-serper"
# 与 cordis.patch.yml 加 insert 行（或直接复制本包自带 cordis.patch.yml 的内容）
pnpm install
pnpm run build
Add to your DSH cordis.patch.yml (profile patch layer):
- insert:
- id: web-search-serper
name: 'dsh-web-search-serper'
No config is required: the API key is resolved lazily per search in this order:
config.apiKey (explicit, when you add a config block to the row — editable on the plugin detail page, hot-applied after save);SERPER_API_KEY environment variable of the DSH host process;SERPER_API_KEY reference in the DSH credential store
($DSH_HOME/.credentials.yaml refs: — resolved per search, no restart on change).To pin the key and options in the composition instead:
- insert:
- id: web-search-serper
name: 'dsh-web-search-serper'
config:
apiKey: your-serper-api-key
gl: cn # Optional: set default country code
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
apiKey | string | No | $SERPER_API_KEY, then credential reference SERPER_API_KEY | Serper API key (secret, volatile) |
baseURL | string | No | https://google.serper.dev | API endpoint base |
gl | string | No | - | Country code (e.g., us, cn, jp) |
cr | string | No | - | Region code (e.g., us; sent as the cr parameter) |
numResults | number | No | omitted (Serper defaults to 10) | Default result count, capped at 100 |
import { apply } from 'dsh-web-search-serper'
// Used by the Cordis loader; no direct calls needed in most deployments.
// In a Cordis plugin:
// apply(ctx)
const result = await ctx.web.search({
query: 'latest AI developments 2026',
maxResults: 5,
})
console.log(result.sources)
// [
// { url: '...', title: '...', snippet: '...' },
// ...
// ]
| Error Code | Meaning | Resolution |
|---|---|---|
WEB_PROVIDER_CONFIGURED_MISSING | Configured provider not registered | Check if plugin is loaded correctly |
WEB_PROVIDER_CONFIGURED_UNAVAILABLE | Provider registered but no key available | Check API key: config / $SERPER_API_KEY / credential reference |
WEB_ABORTED | Request was aborted | Check AbortSignal |
WEB_PROVIDER_ERROR | API request failed | Check network / API key / rate limits |
MIT License — See LICENSE file