工具说明：DeepSeek 搜索与读取

项目介绍

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

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

核心能力：

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

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

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

本课有两条用法：

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

官方链接

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

**版本与上线日期。**接口没有版本号，随服务更新。上线日期 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 或 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 里都能用，把方括号换成实际路径：

请帮我把一个名为 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。

它会请求的权限：

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

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 装：

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

给 WorkBuddy 装：

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

自查（不发请求）：

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

macOS：

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 直接写进命令）：

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 时能不能用

**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 直连。

怎样确认装好了

使用教程：查最新 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 通用）

请用 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 元；模型费用另计。

产出文件与验收

验收：

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 在国内网络下不可用）：

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

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

常见问题与排错

费用、额度、隐私与安全

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

• 只有 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。

参考链接