deepseek-websearch · diff
git:20260630.f705547 to git:20260630.46f90d2
16 added, 27 removed. Audit A to A.
---
name: deepseek-websearch
- description: Deepseek WebSearch 搜索工具。基于红狐 API 调用 Deepseek 联网搜索能力，提交查询后自动轮询等待结果返回。当用户需要使用 Deepseek 搜索、联网搜索、AI 搜索获取实时信息时使用。触发词：Deepseek搜索、deepseek websearch、联网搜索、AI搜索、ds搜索。
+ description: Deepseek 联网搜索工具。一键调用 AI 联网搜索能力，快速获取实时信息。当用户需要使用 Deepseek 搜索、联网搜索、AI 搜索获取实时信息时使用。触发词：Deepseek搜索、deepseek websearch、联网搜索、AI搜索、ds搜索。
---
# Deepseek WebSearch
## 📝 简介
- Deepseek WebSearch 是一款 AI 联网搜索助手，通过红狐 API 调用 Deepseek 联网搜索能力，提交查询后自动轮询等待结果返回。
+ Deepseek WebSearch 是一款 AI 联网搜索助手，帮你突破大模型知识截止日期的限制，随时获取最新、准确的实时信息。
- 适用于需要联网实时搜索、AI 辅助信息检索的场景，帮助用户快速获取最新、准确的信息。
+ 适用于需要联网搜索、AI 辅助信息检索的场景，用自然语言描述需求即可获得结构化的搜索结果。
---
## ✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
|---------|---------|---------|
- | 异步提交 | 提交搜索关键词到 Deepseek WebSearch，返回 taskId | 无需等待，立即获取任务标识 |
- | 自动轮询 | 每 5 秒查询任务状态，最多等待 5 分钟 | 自动等待结果，无需手动查询 |
- | 进度反馈 | 轮询期间通过 stderr 实时输出等待状态 | 用户可知搜索进度 |
- | 结果输出 | 状态变为 succeeded 后输出完整 JSON | 结构化数据便于 Agent 解析展示 |
- | 异常处理 | 覆盖 API Key 缺失、提交失败、超时、任务失败四种场景 | 每种异常有明确提示和处理 |
+ | 一键搜索 | 自然语言描述搜索需求，即可发起查询 | 无需记忆命令，降低使用门槛 |
+ | 智能等待 | 搜索发起后自动等待结果，实时反馈进度 | 无需手动刷新，省心省力 |
+ | 结构化输出 | 搜索结果包含详细回答与引用来源 | 信息清晰、便于查阅和引用 |
+ | 异常容错 | 覆盖多种异常场景，每种情况有明确提示 | 遇到问题有指引，不卡流程 |
---
## 🔑 一键安装
### 前置条件
- 已注册红狐 hub 账号并获取 API Key
- 本地已安装 Python 3 环境
### 安装步骤
1. **获取 API Key**
前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 注册并获取 `REDFOX_API_KEY`。
2. **配置环境变量**
```bash
# 方式一：配置文件（如 OpenClaw 的 ~/.openclaw/openclaw.json）
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
# 方式二：终端环境变量
export REDFOX_API_KEY="ak_xxxx..."
```
3. **安装依赖**
```bash
pip3 install requests
```
---
## 📖 使用指南
直接用自然语言描述你的搜索需求即可，无需记忆固定命令。
### 基础使用
#### 1. 发起搜索
告诉助手你想搜索的内容：
> 用户：帮我搜索一下最新的 AI 大模型发展趋势
>
- > 助手：正在为您调用 Deepseek WebSearch 搜索...
-
- #### 2. 等待结果
-
- 脚本会自动提交搜索并轮询等待结果，期间会实时反馈进度：
-
- ```
- ⏳ 已提交搜索请求 (taskId: xxx)，正在等待 Deepseek WebSearch 返回结果…
- ⏳ 第 1 次轮询，状态: queued，继续等待…
- ⏳ 第 2 次轮询，状态: running，继续等待…
- ```
+ > 助手：正在为您搜索，请稍候…
- #### 3. 查看结果
+ #### 2. 获取结果
- 搜索完成后，助手会整理 Deepseek 的回答文本和引用来源，结构化展示给你。
+ 搜索完成后，助手会整理回答文本和引用来源，结构化展示给你。
### 常用说法速查
| 意图 | 示例话术 | 效果 |
|------|---------|------|
- | 实时信息查询 | 「搜索一下今天的科技新闻」 | 调用 Deepseek 联网搜索，获取最新资讯 |
+ | 实时信息查询 | 「搜索一下今天的科技新闻」 | 获取最新资讯 |
| 专业知识检索 | 「帮我查一下量子计算的最新进展」 | 搜索并整理专业领域的最新研究成果 |
| 事实验证 | 「搜索验证一下这个说法是否准确」 | 通过联网搜索核实信息准确性 |
---
## 🎯 使用场景
### 场景一：研究人员获取最新资料
**角色**：科研人员 / 学生
**需求**：查询某领域的最新研究进展或论文
**使用方式**：
1. 描述研究方向或具体问题
- 2. Deepseek 联网搜索相关学术资源
+ 2. 联网搜索相关学术资源
3. 整理并呈现搜索结果
**预期收益**：快速获取最新学术信息，提升研究效率
---
### 场景二：内容创作者追踪热点
**角色**：自媒体博主 / 内容运营
**需求**：追踪行业热点、竞品动态
**使用方式**：
1. 搜索特定话题的最新动态
2. 获取实时新闻和社交媒体讨论
3. 基于搜索结果创作内容
**预期收益**：紧跟热点，产出时效性强的内容
---
### 场景三：开发者技术调研
**角色**：软件工程师 / 技术负责人
**需求**：调研新技术、框架或解决方案
**使用方式**：
1. 搜索技术方案对比信息
2. 获取最新文档和社区反馈
3. 辅助技术决策
**预期收益**：降低技术选型风险，加速开发进程
---
## 🔄 工作流程
> 核心执行流程详见 `references/core_workflow.md`
---
## ⚠️ 错误处理
| 情况 | 处理方式 |
|------|---------|
| 未配置 `REDFOX_API_KEY` | 提示用户前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API Key |
- | 服务返回 502 | 提示可能存在网络不稳定问题，请稍后重试 |
- | 提交失败 | 输出 HTTP 状态码及错误信息，建议用户重试 |
- | 轮询超时（5 分钟） | 提示超时，建议稍后重试 |
- | 任务失败（status=failed） | 输出 failReason 详情 |
+ | 服务返回 502 | 服务返回 502 错误，可能存在网络不稳定问题，请稍后重试 |
+ | 搜索请求失败 | 输出错误信息，建议用户重试 |
+ | 搜索超时 | 提示超时，建议稍后重试 |
+ | 搜索任务失败 | 输出失败原因详情 |