---
title: "W07 工具说明：DeepSeek 搜索与读取"
---

# DeepSeek 搜索与读取

## 项目介绍

**它是什么。**DeepSeek 在 2026-10-17 开放了两个联网接口：Search 按关键词搜网页，返回标题、链接、摘要、发布时间和权威度；Fetch 给一个网址，返回该页的 Markdown 正文。智能体靠它们查最新的统计发布、政策公告并读回原文，解决“模型只知道训练时的旧信息、给不出原文链接”的问题。两个接口和 DeepSeek 对话 API 用同一个 Key，按成功请求次数计费。

这里的“接口”（API）指一个网址：程序按约定格式向它发请求，它按约定格式返回结果。Key 是你的账号凭证，相当于调用接口时出示的密码。

| 项 | 内容 |
| --- | --- |
| 提供方 | 杭州深度求索人工智能基础技术研究有限公司（DeepSeek）；Search 由 DeepSeek 自研搜索引擎支持（官方文档） |
| 服务性质 | 在线付费服务，不开源，没有许可证和 GitHub 仓库 |
| 上线时间 | 2026-10-17（文档站横幅“Search / Fetch API 已上线”，媒体当日报道） |
| 版本 | 接口无版本号，随服务更新；官方更新日志没有单列这一条（2026-10 核查） |
| GitHub 星数与最近提交 | 不适用。本课用的 `deepseek-web` Skill 是课程自建的（https://github.com/ai-lingnan/sysu-awesome-cc/tree/main/skills/deepseek-web），DeepSeek 没有发布官方 Skill |
| 接入方式 | HTTP 接口，本课包成 CLI＋Skill（下表用法 A）；Claude Code 经 CC Switch 接 DeepSeek 时的 WebSearch 属客户端自带（用法 B） |

**核心能力：**

- Search：一次返回 1～50 条结果，每条带短摘要、长摘要、发布时间、权威度和相关度评分；
- 搜索语法：`site:` 限定网站、排除关键词、`after:`／`before:` 限定时间、`lang:` 限定语言；
- Fetch：按网址取回网页正文，转成 Markdown；
- 与对话 API 共用 Key 和账单，不必另开账号。

**在同类工具里的位置：**它和 Tavily、Exa 这类搜索 API 做同一件事：把“搜索＋读原文”交给智能体。区别是服务由国内厂商提供，和本课主用的 DeepSeek 模型共用一个 Key。本课把它作为国内网络下网页搜索与读取的主线。

**国内网络：**可用，响应快，搜统计局 CPI 这类关键词时，前几条结果就有统计局官网的发布稿。Fetch 首次请求偶尔返回 `failed to fetch URL`，重试一次即可。

本课有两条用法：

| 用法 | 接入类别 | 适用端 | 要不要装东西 |
| --- | --- | --- | --- |
| A. 直接调 Search / Fetch 接口 | HTTP 接口，包成 CLI＋Skill（`deepseek-web`） | Claude Code、WorkBuddy 都能用 | 放一个 Skill 文件夹，配一个环境变量 |
| B. Claude Code 自带的 WebSearch | 客户端自带 | 只限 Claude Code 经 CC Switch 接 DeepSeek | 不用装；同属自带的 WebFetch 在国内网络下不可用（见下文），读网页改用用法 A 的 Fetch |

WorkBuddy 自带的 WebSearch / WebFetch 走的是 WorkBuddy 自己的后端，和 DeepSeek 接口无关；要在 WorkBuddy 里用 DeepSeek 搜索，走用法 A。

## 官方链接

核查日期：2026-10-19（北京时间）。

| 项 | 链接 |
| --- | --- |
| 开放平台（申请 Key、充值、看账单） | https://platform.deepseek.com （Key 页：https://platform.deepseek.com/api_keys ） |
| 使用指南（中文） | https://api-docs.deepseek.com/zh-cn/guides/search |
| 使用指南（英文） | https://api-docs.deepseek.com/guides/search |
| Search 接口参考 | https://api-docs.deepseek.com/zh-cn/api/search |
| Fetch 接口参考 | https://api-docs.deepseek.com/zh-cn/api/fetch |
| 接入 Claude Code（含 Web Search 说明） | https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code |
| Anthropic 格式兼容表 | https://api-docs.deepseek.com/zh-cn/guides/anthropic_api |
| 模型价格 | https://api-docs.deepseek.com/zh-cn/quick_start/pricing |
| 更新日志 | https://api-docs.deepseek.com/zh-cn/updates |
| Claude Code 工具说明（WebSearch / WebFetch 行为） | https://code.claude.com/docs/en/tools-reference |
| Claude Code 数据流说明（WebFetch 域名安全检查） | https://code.claude.com/docs/en/data-usage |

**版本与上线日期。**接口没有版本号，随服务更新。上线日期 2026-10-17 的依据：文档站顶部横幅写“Search / Fetch API 已上线”，IT 之家 10-17 报道官方当天上午宣布；DeepSeek 更新日志（核查时最新一条是 2026-09-10）没有单列这一条。

## 能做什么、不能做什么

**能做：**

- Search：一次返回 1～50 条结果（默认 10），每条带 `title`、`url`、`snippet`（100～200 字短摘要）、`summary`（600～800 字长摘要，给模型读）、`date`（UTC 发布时间）、`authority`（权威度 0～4，3 及以上为高权威，-1 为未知）、`rerank_score`（0～3，1.5 及以上为优质）。可选返回正文（`need_content: true`）。
- 搜索语法：`site:`、`-site:`、`-关键词`、`"精确短语"`、`-"短语"`、`lang:zh,en`、`after:2026-09-01`、`before:2026-10-01`，可组合。
- Fetch：抓单个网页，返回 `title` 和 Markdown `content`。

**不能做或做不好：**

- 不能点击、翻页、填表、登录。要操作网页用 [Playwright MCP](https://ai.lingnan.top/materials/2026-autumn/w07/tool-03-playwright-mcp) 或 [agent-browser](https://ai.lingnan.top/materials/2026-autumn/w07/tool-05-agent-browser)。
- Fetch 读不了列表页。统计局“最新发布”这类列表页是动态页面（打开后由脚本生成内容），Fetch 只能取回页脚或栏目标题，拿不到文章链接。找具体文章要靠 Search，再 Fetch 具体发布稿。
- Fetch 首次请求可能返回 `failed to fetch URL`，同一网址重试一次即可。
- `site:stats.gov.cn` 会同时命中各省调查总队子域（如 `tjzd.stats.gov.cn`），要按标题区分全国与地方数据。
- 部分站点会被拒（403 安全策略）或抓不到正文（404）。
- `query` 最长 128 个字符。

**适合本课的任务：**查最新宏观数据并给原文链接（CPI、PPI、GDP 发布稿）、找政策原文、核对新闻里的数字是否与官方原文一致、为研究报告收集带日期和出处的资料。

## 安装与配置

### 前置条件

1. 一个 DeepSeek 开放平台账号，账户有余额（402 错误就是余额不足）。用 CC Switch 接 DeepSeek 的同学已经有 Key，可以沿用同一个，也可以新建一个专门给搜索用的 Key，方便单独停用。
2. 用法 A 需要 Python 3。WorkBuddy 自带 Python；Claude Code 端需要本机有 Python（Windows 装官方安装包，勾选“Add python.exe to PATH”；不要用 Microsoft Store 的 `python3` 占位符）。安装包优先从国内镜像下载：npmmirror https://registry.npmmirror.com/-/binary/python/ 或华为云 https://repo.huaweicloud.com/python/ ，按版本号进目录选 `python-3.x.x-amd64.exe`；python.org 国内也能打开。脚本只用标准库，不需要配 pip 源。
3. 技能文件夹 `deepseek-web`：在课程技能仓库 sysu-awesome-cc（https://github.com/ai-lingnan/sysu-awesome-cc/tree/main/skills/deepseek-web），W04 下载过整个仓库的，重新下载一次即可拿到；内含 `SKILL.md` 和 `scripts/ds_web.py`。脚本只用 Python 标准库，Key 只从环境变量读、不打印。整个文件夹拷贝使用，不要往里放任何含 Key 的文件。

### 第一步（首选）：把提示词交给智能体，让它装 Skill

Skill 放到哪个目录、脚本能不能跑，可以交给智能体做。下面提示词在 Claude Code 或 WorkBuddy 里都能用，把方括号换成实际路径：

```txt
请帮我把一个名为 deepseek-web 的技能装进当前项目，要求如下：

1. 技能在课程仓库 https://github.com/ai-lingnan/sysu-awesome-cc/tree/main/skills/deepseek-web 。已经下载过 sysu-awesome-cc 的，用本地 skills/deepseek-web 文件夹：[完整路径]。
2. 如果你是 Claude Code，复制到 <当前项目>/.claude/skills/deepseek-web/；
   如果你是 WorkBuddy，复制到 <当前工作区>/.workbuddy/skills/deepseek-web/。
   只复制这两个文件，保持目录结构，不要改脚本内容。
3. 不要安装任何新软件，不要用 pip 装包（脚本只用标准库）。
4. 检查本机能用哪个 Python：Windows 先试 python --version 和 py -3 --version，Mac 试 python3 --version。告诉我结果。
5. 运行一次不带网络请求的自查：python <技能目录>/scripts/ds_web.py --help，确认能输出用法。
6. 运行 ds_web.py check 检查 Key：结果是 KEY_OK 就告诉我可以用了；是 KEY_MISSING 或 KEY_INVALID，就把脚本给出的申请和配置步骤告诉我，停下来等我自己配好，不要向我索要 Key。
7. 最后列出技能装到了哪个路径，以及我在对话里输入 / 能否看到 deepseek-web。
```

**它会请求的权限：**

| 请求 | 怎么处理 |
| --- | --- |
| 读取技能源文件夹、在项目里新建 `.claude/skills/` 或 `.workbuddy/skills/` | 允许 |
| 运行 `python --version`、`ds_web.py --help`、`ds_web.py check` | 允许（check 只查 Key 是否有效和余额，不计费、不显示 Key） |
| 其他检查环境变量的命令 | 看清命令里没有 `echo $DEEPSEEK_API_KEY`、`env` 全量输出这类会显示 Key 值的写法；有就拒绝 |
| `pip install`、下载安装 Python、替你运行 `setup` | 拒绝。Key 由你自己配（见第二步） |
| 改 Claude Code 的 `settings.json` | 本步不需要，拒绝 |

### 第二步：要你亲手做的部分

1. **申请 Key。**登录 https://platform.deepseek.com/api_keys ，新建 Key，复制保存到自己的密码管理器或本地记事本。Key 只显示一次。
2. **把 Key 写进本机环境变量。**在终端运行技能自带的配置命令，按提示粘贴 Key（输入时不显示），它先验证 Key 能用，再写进环境变量 `DEEPSEEK_API_KEY`：
   - Windows（PowerShell）：`py .claude\skills\deepseek-web\scripts\ds_web.py setup`（WorkBuddy 的项目把 `.claude` 换成 `.workbuddy`）
   - macOS：`python3 .claude/skills/deepseek-web/scripts/ds_web.py setup`
   环境变量是操作系统替程序保管的一组“名字＝值”，程序启动时从这里读取，Key 就不用写进项目文件。macOS 上重启电脑后也会自动恢复。
3. **重启客户端。**WorkBuddy 要完全退出再打开；Claude Code 关掉终端窗口重开再运行 `claude`。Key 要在客户端启动前进入环境，运行中设置不会生效；第一次报“没有 Key”多半是这个原因，重启后即可。
4. **WorkBuddy 沙箱弹窗。**脚本首次访问 `api.deepseek.com` 时如果弹出网络授权，看清域名是 `api.deepseek.com` 再点允许。

### 第三步（参考）：手动安装

智能体装不上时，对照下面手动做，或用来检查它装得对不对。

Windows 11（PowerShell，在项目目录下执行；源路径换成实际位置）。给 Claude Code 装：

```txt
New-Item -ItemType Directory -Force .claude\skills | Out-Null
Copy-Item -Recurse "<sysu-awesome-cc 所在位置>\skills\deepseek-web" .claude\skills\
```

给 WorkBuddy 装：

```txt
New-Item -ItemType Directory -Force .workbuddy\skills | Out-Null
Copy-Item -Recurse "<sysu-awesome-cc 所在位置>\skills\deepseek-web" .workbuddy\skills\
```

自查（不发请求）：

```txt
python .claude\skills\deepseek-web\scripts\ds_web.py --help
```

macOS：

```txt
mkdir -p .claude/skills .workbuddy/skills
cp -R <sysu-awesome-cc 所在位置>/skills/deepseek-web .claude/skills/        (Claude Code)
cp -R <sysu-awesome-cc 所在位置>/skills/deepseek-web .workbuddy/skills/     (WorkBuddy)
python3 .claude/skills/deepseek-web/scripts/ds_web.py --help
```

不用 Skill、直接调接口的官方写法（macOS 或 Git Bash；Key 从环境变量取，不要把 Key 直接写进命令）：

```txt
curl https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "国家统计局 居民消费价格 site:stats.gov.cn after:2026-10-01", "count": 5}'

curl https://api.deepseek.com/v1/tools/fetch \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.stats.gov.cn/sj/zxfb/202610/t20261014_1965477.html"}'
```

### 两端各自的要点

**Claude Code（经 CC Switch 接 DeepSeek）**

- 技能目录：项目级 `.claude/skills/deepseek-web/`，个人级 `~/.claude/skills/deepseek-web/`（Windows 为 `C:\Users\<你的用户名>\.claude\skills\`）。
- CC Switch 里填的 DeepSeek Key 会作为 `ANTHROPIC_AUTH_TOKEN` 交给 Claude Code，脚本读的是 `DEEPSEEK_API_KEY`，两者不通用，仍要按第二步单独设置。
- 用法 B 不需要装任何东西，见下一节。

**WorkBuddy**

- 技能目录：项目级 `<工作区>/.workbuddy/skills/deepseek-web/`，个人级 `~/.workbuddy/skills/`；也可在“专家·技能·连接器”页面上传技能包。在对话框输入 `/` 能看到 `deepseek-web` 即为识别成功。
- 不需要配 MCP 或连接器。

### Claude Code 自带 WebSearch / WebFetch 接 DeepSeek 时能不能用

| 工具 | 能否用 | 谁在执行 | 怎么计费 | 依据 |
| --- | --- | --- | --- | --- |
| WebSearch | 能。DeepSeek 文档写明“原生支持 Claude Code 中的 Web Search 功能” | 服务端工具：请求发到 DeepSeek，由 DeepSeek 用自己的 Search 接口搜 | ① 搜索请求按 Search 价格计次：**2026-11-01 00:00（北京时间）前不收**，之后 5 元 / 千次成功请求；② 搜索结果要再经模型总结，产生额外模型 Token 费 | DeepSeek 官方文档；Anthropic 兼容表列 `server_tool_use`、`web_search_tool_result` 为“支持” |
| WebFetch | 国内网络下不可用，本课不用 | 客户端工具：Claude Code 在本机下载网页，转成 Markdown，再用一次单独的模型调用（Haiku 档，经 DeepSeek 映射为 `deepseek-flash`）提取内容 | 不经 DeepSeek Fetch 接口计次；产生提取那一次的模型 Token 费 | Anthropic 工具说明；DeepSeek 模型映射说明 |

**WebFetch 在国内网络下不可用。**Anthropic 文档说明：WebFetch 抓取前会把域名发到 `api.anthropic.com` 做安全检查，与用哪家模型无关。国内网络下这一步通不过，WebFetch 读不到网页。本课不用它；读网页用用法 A 的 Fetch，要点击、翻页时用 Playwright MCP 或 agent-browser 等本地浏览器类工具。

**WebFetch 是有损的。**即使在能用的网络下，它返回的也是模型按提示词提取后的结果，不是原网页。核对数字时用用法 A 的 Fetch 存下正文，或让 Claude Code 用 `curl` 取原页。

**与 DeepSeek Fetch 接口的关系。**DeepSeek 计费说明提到用户在 DeepSeek Harness / Claude Code / Codex 中“通过 Server 端工具调用访问到 Search/Fetch 接口”。按 Anthropic 文档，Claude Code 的 WebFetch 在本机抓取，不属于服务端工具，所以 Claude Code 里走 DeepSeek 计费的应是 WebSearch；Fetch 接口的服务端调用可能来自 Harness 或 Codex。这是根据两份文档推断的，以平台账单为准。

**CC Switch 的影响。**CC Switch 直连模式把 `ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic` 等写进 Claude Code 配置，请求直达 DeepSeek，国内网络下能连通。如果开了 CC Switch 的本地代理或路由后 WebSearch 失效，先切回直连模式排查。社区有 CC Switch 代理下 WebSearch 故障的个案（issue #5363，Codex OAuth 场景），不能推广到 DeepSeek 直连。

### 怎样确认装好了

| 检查 | 期望结果 |
| --- | --- |
| `python ds_web.py --help`（Mac 用 `python3`） | 打印 `search`、`fetch` 两个子命令 |
| 在客户端输入 `/` | 列表里有 `deepseek-web` |
| 让智能体执行 `ds_web.py search "国家统计局" --count 1` | 打印 `1 results` 和一条带 `authority=` 的结果；出现 `DEEPSEEK_API_KEY is not set` 说明 Key 没进环境，重新做第二步并重启客户端 |
| Claude Code 用法 B：问“搜一下今天国家统计局发布了什么” | 界面出现 `Web Search(...)` 工具调用并列出链接 |

## 使用教程：查最新 CPI 并给原文链接

任务目标：让智能体找到国家统计局最新一期全国居民消费价格指数（CPI）发布稿，读回正文，报出数据月份、同比、环比和发布日期，并附原文链接。

例如 2026 年 10 月中旬搜索，前几条结果里就有统计局发布稿《2026年9月份居民消费价格同比上涨0.9%》（`https://www.stats.gov.cn/sj/zxfb/202610/t20261014_1965477.html`），正文约 6,000 字，其中写明“9 月份，全国居民消费价格同比上涨 0.9%，环比上涨 0.2%”。你做的时候最新一期可能已经更新，以搜到的结果为准。

### 提示词（Claude Code 和 WorkBuddy 通用）

```txt
请用 deepseek-web 技能查最新一期全国居民消费价格指数（CPI），要求：

1. 只用 deepseek-web 的脚本联网，不要用 WebSearch、WebFetch 或浏览器。
2. 先 search，再从结果里选国家统计局官网（www.stats.gov.cn，全国数据，不是各省调查总队）且发布日期最新的页面；
   如果第一次搜到的官网页面不是最新月份，用 site:、after: 或精确短语再搜，不要自己猜网址。
3. 对选中的链接执行 fetch，把正文存成 cpi-page.md，搜索结果存成 cpi-search.json。
   fetch 返回 failed to fetch URL 时，对同一链接重试一次；不要 fetch 统计局“最新发布”这类列表页，它是动态页面，只能取回页脚。
4. 从正文里读出：数据月份、全国 CPI 同比、环比、发布日期，并逐条附上正文原句。
5. 结果写进 cpi-result.md，写明来源名称、链接、发布日期；说明你选这个页面的理由。
6. 全程不要打印或保存 DEEPSEEK_API_KEY。
```

### 预期看到的工具调用

1. Skill 读取 `deepseek-web/SKILL.md`。
2. Bash 执行若干次 `python ds_web.py search ...`。搜索结果随时间变化：有时一次搜索的前几条就有月度 CPI 发布稿；有时主搜索返回的官网页面不是最新月份，智能体会用 `site:stats.gov.cn 2026年9月份居民消费价格同比` 这类精确短语补搜几次。补搜属正常。
3. Bash 执行 `python ds_web.py fetch "<选中的发布稿链接>" --out cpi-page.md`。它也可能选中季度国民经济运行情况的发布稿（其中一节给出当月 CPI）；首次返回 `failed to fetch URL` 时会再执行一次。
4. Write 生成 `cpi-result.md`。

一次这样的任务通常是 3～7 次 search、1～2 次 fetch，按 5 元 / 千次计不到 0.05 元；模型费用另计。

### 产出文件与验收

| 文件 | 内容 |
| --- | --- |
| `cpi-search.json` | 搜索原始返回，含 `authority`、`date`、`snippet` |
| `cpi-page.md` | 选中页正文（月度 CPI 稿约 6,000 字；季度经济运行稿约 2 万字） |
| `cpi-result.md` | 四个字段、正文原句、来源与选择理由 |

验收：

1. 打开 `cpi-result.md` 里的链接，域名是 `www.stats.gov.cn`。
2. 在 `cpi-page.md` 里搜“同比上涨”，能找到报告引用的原句，数字一致。
3. 注意 `date` 是 UTC 时间：`2026-10-18T16:00:00+00:00` 是北京时间 10-19 00:00。报告里的发布日期应以正文页头为准。
4. 选月度 CPI 专稿或季度经济运行稿都可以，报告写明选的是哪一篇即合格；编造网址不合格。

### Claude Code 用法 B 的对照做法

搜索这一步可以不用 Skill，让 Claude Code 用自带的 WebSearch 做，用来对比服务端工具与 Skill 脚本两种调用；读原文仍用 deepseek-web 的 fetch（WebFetch 在国内网络下不可用）：

```txt
用 WebSearch 查国家统计局最新一期全国 CPI 的官网发布页，不要用 WebFetch。
找到链接后用 deepseek-web 技能的 fetch 读取正文，失败就重试一次。
告诉我数据月份、同比、环比、发布日期和原文链接，并对比 WebSearch 和 deepseek-web search 返回的内容有什么不同。
```

预期：出现 `Web Search` 工具调用，随后是 Bash 执行 `ds_web.py fetch`。如果没有出现 `Web Search` 调用，看排错表里“Claude Code 没有调用 WebSearch”一行。

## 常见问题与排错

| 现象 | 原因 | 处理 |
| --- | --- | --- |
| `KEY_MISSING` | 环境变量没设，或设了但客户端没重启 | 运行 `ds_web.py setup` 配好后，完全退出并重开客户端，再运行 `ds_web.py check` 看到 `KEY_OK` |
| Windows 设了环境变量仍报上一条 | 客户端在设置前已启动；或设在了另一个用户名下 | 注销或重启电脑最稳妥；在新开的 PowerShell 里用 `if ($env:DEEPSEEK_API_KEY) {"有"} else {"没有"}` 检查（只显示有无） |
| `python` 不是内部或外部命令，或弹出 Microsoft Store | 没装 Python，或只有 Store 占位符 | 从国内镜像或 python.org 装官方安装包并勾选 PATH；或改用 `py -3` |
| 中文输出乱码（Windows） | 控制台编码不是 UTF-8 | 脚本已自动切换 UTF-8；仍乱码时先执行 `chcp 65001`，或只看 `--out` 写出的文件 |
| `HTTP 401 invalid key` | Key 复制不全、有空格，或已删除 | 平台上新建 Key，重新设置 |
| `HTTP 402 insufficient balance` | 账户余额不足 | 充值后再试 |
| `HTTP 429 rate limited` | 超过每账号每秒 5 次，或 Fetch 对同一域名请求过快 | 等几秒重试；让智能体逐条请求，不要并发 |
| `HTTP 403` / `HTTP 404`（Fetch） | 被安全策略拒绝；目标站拦截、页面无正文或格式不支持 | 换一个来源页；PDF 等非网页内容改用下载后本地读取 |
| 搜索结果日期都是旧的 | 搜索词太泛 | 加 `after:2026-10-01`、`site:stats.gov.cn` 或标题里的精确短语 |
| `site:stats.gov.cn` 结果混入省级数据 | 子域名也被匹配 | 按标题和正文区分“全国”与省名；或写 `site:www.stats.gov.cn` |
| Fetch 返回 `failed to fetch URL` | 首次抓取偶发失败 | 同一网址重试一次；仍失败再换来源页 |
| Fetch 列表页只取回页脚，或只有标题没有链接 | 列表页是动态页面；接口返回的是正文 Markdown | 用 Search 找具体发布稿，再 Fetch 那一篇 |
| Claude Code 的 WebFetch 一直失败，提示无法验证域名 | WebFetch 的域名安全检查在国内网络下通不过 | 不用 WebFetch，改用用法 A 的 Fetch |
| Claude Code 没有调用 WebSearch | 模型判断不需要搜索；或 CC Switch 代理没透传 | 提示词里写明“用 WebSearch”；切回 CC Switch 直连模式再试 |
| 智能体把 Key 打印出来了 | 提示词没约束，或允许了 `env` 类命令 | 立即到平台删除该 Key 并新建；清掉对话截图；以后拒绝显示环境变量值的命令 |

## 费用、额度、隐私与安全

**价格（中文文档，2026-10-19 核查）：**

| 项 | 价格 |
| --- | --- |
| Search | 5 元 / 1,000 次成功请求 |
| Fetch | 5 元 / 1,000 次成功请求 |
| Claude Code 内 WebSearch 触发的搜索 | 2026-11-01 00:00（北京时间）前不收搜索费，之后按 Search 价格计次；总结搜索结果的模型 Token 照常收费 |

- 只有 HTTP 200 且有结果的请求计费（Search 结果非空、Fetch 有正文）；失败、无结果、超时不计费。`count` 不影响单价。
- 英文文档标价为每千次 0.75 美元，Claude Code / Codex 免费期写的是“上线后前两周”，与中文页的“11 月 1 日起”一致。人民币账户以中文页为准。
- 限速：每账号 Search、Fetch 各 5 QPS（每秒 5 次请求），与用哪个 Key 无关；Fetch 另有按目标域名的限速。
- 模型 Token 另计。`deepseek-flash` 价格分高峰（工作日 9:00–12:00、14:00–18:00）与空闲时段，空闲半价，见价格页。

**Key 与隐私：**

- Key 只放用户环境变量。不写进 `SKILL.md`、脚本、项目文件、提示词，也不贴进任何聊天窗口。共享项目或交流截图前确认画面里没有 Key。
- `deepseek-web` 脚本从环境变量读 Key、不打印。
- 不要把 Key 交给智能体“帮你设置”：智能体执行的命令和输出会进入对话记录。
- 搜索词和抓取的网址会发给 DeepSeek。不要在搜索词里放个人信息、未公开的研究数据。
- Claude Code 的 WebFetch 会把域名发到 `api.anthropic.com`（只发域名，不发完整网址和网页内容）；本课不用 WebFetch，可在提示词里写明“不要用 WebFetch”。
- Fetch 只读公开网页，不能也不应读需要登录的页面。

## 与同类工具的一句对比

和 Tavily MCP 比，DeepSeek Search / Fetch 与对话模型共用一个 Key 和账户、国内网络直连可用、按人民币计次，但没有官方 MCP 服务器，需要用 Skill＋脚本或 Claude Code 的 WebSearch 接入；Tavily 有官方 MCP，需另申请 Key。

## 参考链接

| 内容 | 来源 |
| --- | --- |
| 接口地址、鉴权、请求字段、搜索语法、返回字段、错误码、计费、限速、Claude Code 免费至 11-01 | https://api-docs.deepseek.com/zh-cn/guides/search |
| 英文版价格 0.75 美元、免费期写法 | https://api-docs.deepseek.com/guides/search |
| Claude Code 原生支持 Web Search、额外 Token 费、模型名映射 | https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code |
| `server_tool_use`、`web_search_tool_result` 支持，`mcp_tool_use` 不支持 | https://api-docs.deepseek.com/zh-cn/guides/anthropic_api |
| 模型价格与峰谷时段 | https://api-docs.deepseek.com/zh-cn/quick_start/pricing |
| 更新日志 | https://api-docs.deepseek.com/zh-cn/updates |
| WebSearch / WebFetch 行为、WebFetch 有损、读取上限 10 万字符 | https://code.claude.com/docs/en/tools-reference |
| WebFetch 域名安全检查 | https://code.claude.com/docs/en/data-usage |
| 2026-10-17 上线（IT 之家报道） | https://www.163.com/dy/article/L9EUCRSP0511B8LM.html |
| CC Switch 代理下 WebSearch 故障个案 | https://github.com/farion1231/cc-switch/issues/5363 |