DeepSeek 搜索 API 开放：价格、返回结果与 Hermes Agent 接入教程

这次开放了什么？

2026 年 10 月 17 日，DeepSeek 在发布 DeepSeek-V4.1-Flash-1017 的公告中同时宣布：Search 与 Fetch 接口向所有用户开放。两者都基于 DeepSeek 自研搜索引擎，官方称这个引擎每天在全球处理数亿次请求。

Base URL 是 https://api.deepseek.com，鉴权方式与对话接口相同，都是 Authorization: Bearer 加 DeepSeek API 密钥。来源：官方网页搜索与抓取文档和价格页。

一次搜索能拿到什么？

请求里的 query 长度为 1 到 128 个字符，count 可选 1 到 50 条（默认 10 条）。每条结果包含：

• title、url 和 date（发布时间，未知时为 null）
• snippet：100–200 字的短摘要，适合展示给人看
• summary：600–800 字的长摘要，专门写给模型读
• content：网页正文，只有传 need_content: true 时才返回
• rerank_score（0–3，1.5 以上算高质量）和 authority（权威度 0–4，未知时为 -1）

查询语法会原样保留：site:、-site:、"精确短语"、-排除词、lang:zh,en、after:2026-01-01、before:。对智能体最有用的是现成的 summary 字段：模型往往不必逐个打开网页就能回答。

curl https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "DeepSeek V4.1 Flash 发布 lang:zh", "count": 5}'

curl https://api.deepseek.com/v1/tools/fetch \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://api-docs.deepseek.com/zh-cn/guides/search"}'

实际用起来花多少钱？

按成功请求次数计费，不按 token、也不按返回条数。空结果、报错和超时都不收费，要 50 条和要 5 条价格一样。一个机器人每天搜索 30 次，一个月约 900 次，大约 4.5 元；如果每次搜索后再抓取 2 个网页，再加约 9 元。

智能体阅读这些结果消耗的模型 token，由你使用的模型提供商另行计费。另外，如果你在 Claude Code、Codex 或 DeepSeek Harness 里使用 DeepSeek，它们内置的联网搜索本来就走这套接口，这部分将从北京时间 2026 年 11 月 1 日 00:00 起开始按次收费。

Hermes Agent 支持吗？

目前还没有原生支持。我们在 10 月 17 日检查了 Hermes 官方仓库：main 分支和 v0.22.2 版本都没有 DeepSeek 搜索后端。内置的搜索后端有 SearXNG、Tavily、Exa、Firecrawl、Parallel、Perplexity、Brave 免费版、DuckDuckGo、Keenable、xAI 和 OpenAI 原生搜索，在 config.yaml 里用 web.search_backend 选择。

社区已经在做：两个封装新接口的第三方插件已提交到 Hermes 插件目录（#140154、#140462），#81393 则提议基于 DeepSeek 服务端搜索做一个后端。我们检查时三者都还没有合并。把 API 密钥交给任何插件之前，先读一遍它的代码。

在官方支持落地之前，最简单的办法是写一个技能。Hermes 技能可以声明自己需要的环境变量，并通过终端工具运行脚本，这样 DeepSeek 搜索就成了机器人可以自己选择调用的工具。

第一步：创建技能

Hermes 的技能放在 ~/.hermes/skills/<分类>/<名称>/。把下面内容保存为 ~/.hermes/skills/research/deepseek-search/SKILL.md（技能文件用英文写，模型照样能读懂中文问题）：

---
name: deepseek-search
description: Search the live web and read web pages through the DeepSeek Search & Fetch API.
version: 1.0.0
required_environment_variables:
  - name: DEEPSEEK_API_KEY
    prompt: DeepSeek API key
    help: Create one at https://platform.deepseek.com/api_keys
    required_for: web search and page fetch
metadata:
  hermes:
    tags: [search, web, deepseek]
    category: research
    requires_toolsets: [terminal]
---

# DeepSeek Search

## When to Use
The user asks about current events, prices, releases or anything that needs a live
web source, or asks you to read a specific URL.

## How to Use
Search. Each result has a title, URL, date and a summary written for a model:

    python3 "${HERMES_HOME:-$HOME/.hermes}/skills/research/deepseek-search/scripts/ds_search.py" search "query" 5

Read one page as Markdown:

    python3 "${HERMES_HOME:-$HOME/.hermes}/skills/research/deepseek-search/scripts/ds_search.py" fetch https://example.com/page

## Rules
- Keep a query under 128 characters. Operators work: site:, -site:, "exact phrase",
  lang:zh,en, after:2026-01-01, before:2026-06-01.
- Every successful call is billed to the key owner. Search once, then fetch only the
  pages you actually need.
- Cite the URLs you used.
- On HTTP 429 wait a second and retry once. On HTTP 402 tell the user the DeepSeek
  balance is empty.

其中 required_environment_variables 这一段让脚本能读到你的密钥：Hermes 会把技能声明的环境变量传给终端沙箱。

第二步：添加脚本

在同一个技能目录下保存为 scripts/ds_search.py。只用 Python 标准库，不需要安装依赖。

#!/usr/bin/env python3
"""DeepSeek Search & Fetch for Hermes Agent.

  ds_search.py search "your query" [count]
  ds_search.py fetch https://example.com/page
"""
import json, os, sys, urllib.error, urllib.request

API = "https://api.deepseek.com/v1/tools/"


def call(endpoint, body):
    key = os.environ.get("DEEPSEEK_API_KEY")
    if not key:
        sys.exit("DEEPSEEK_API_KEY is not set")
    req = urllib.request.Request(
        API + endpoint,
        data=json.dumps(body).encode(),
        headers={"Authorization": "Bearer " + key, "Content-Type": "application/json"},
    )
    try:
        with urllib.request.urlopen(req, timeout=60) as resp:
            return json.load(resp)
    except urllib.error.HTTPError as err:
        sys.exit(f"HTTP {err.code}: {err.read().decode(errors='replace')[:500]}")


if len(sys.argv) < 3 or sys.argv[1] not in ("search", "fetch"):
    sys.exit(__doc__)

if sys.argv[1] == "search":
    count = int(sys.argv[3]) if len(sys.argv) > 3 else 5
    data = call("search", {"query": sys.argv[2][:128], "count": count})
    if not data["results"]:
        print("No results.")
    for r in data["results"]:
        print(f"## {r['title']}\n{r['url']}  {r.get('date') or ''}\n{r['summary']}\n")
else:
    page = call("fetch", {"url": sys.argv[2]})
    print(f"Source: {sys.argv[2]}\n\n{page['content']}")

第三步：填入密钥并重新加载

在 DeepSeek 开放平台创建密钥并确认账户有余额。Hermes 从 ~/.hermes/.env 读取密钥：

H="${HERMES_HOME:-$HOME/.hermes}"
mkdir -p "$H/skills/research/deepseek-search/scripts"

# 把上面两个文件分别保存为：
#   $H/skills/research/deepseek-search/SKILL.md
#   $H/skills/research/deepseek-search/scripts/ds_search.py

# 如果 .env 里已经有 DEEPSEEK_API_KEY，跳过这一行
echo 'DEEPSEEK_API_KEY=你自己的DeepSeek密钥' >> "$H/.env"

hermes skills list | grep deepseek-search
hermes gateway restart   # 仅当你通过 Telegram、Discord、微信等聊天应用使用 Hermes 时需要

完成后开一个新对话，让技能列表重新加载。如果你本来就用 DeepSeek 作为模型提供商，同一个 DEEPSEEK_API_KEY 两边都能用。

第四步：测试

先手动运行一次脚本。这会产生一次计费搜索（不到一分钱）：

H="${HERMES_HOME:-$HOME/.hermes}"
set -a; . "$H/.env"; set +a
python3 "$H/skills/research/deepseek-search/scripts/ds_search.py" search "DeepSeek V4.1 Flash 发布" 3

能看到标题、链接和摘要就说明通了。然后问机器人一个需要最新信息的问题，例如："DeepSeek 这周发布了什么？用 deepseek-search 技能查一下。"用过一次之后就不必再特别提醒。

常见错误码：401 是密钥不对，402 是 DeepSeek 余额不足，429 是超过每秒 5 次，Fetch 返回 404 表示该网页没有可提取的正文。

要不要换掉现在的搜索后端？

这个技能与 Hermes 自带的 web_search 工具并存，不会替换它。现有后端好用就继续用：SearXNG 免费、可自建，Tavily、Exa 等付费后端 Hermes 也已内置。如果你想要固定的低单价、每条结果自带给模型读的摘要，或者想要第二个索引交叉核对答案，DeepSeek 搜索值得一试。更多搜索配置可以参考 联网搜索配置指南。

在 OpenClaw Launch 上

OpenClaw Launch 托管的 Hermes 机器人已经内置联网搜索，不按次收费，也不用自己管理密钥，所以只是想让机器人能上网搜索的话，不需要这个接口。本文主要写给自部署 Hermes 的用户，以及想专门使用 DeepSeek 搜索索引的开发者。

常见问题

延伸阅读

继续了解 DeepSeek V4.1 Flash 接入教程、DeepSeek 机器人、什么是 Hermes Agent 和 Hermes 托管。

部署一个能联网搜索的 Hermes 助手