---
name: deepseek-websearch
description: Deepseek WebSearch 搜索工具。基于红狐 API 调用 Deepseek 联网搜索能力，提交查询后自动轮询等待结果返回。当用户需要使用 Deepseek 搜索、联网搜索、AI 搜索获取实时信息时使用。触发词：Deepseek搜索、deepseek websearch、联网搜索、AI搜索、ds搜索。
---

# Deepseek WebSearch

## 📝 简介

Deepseek WebSearch 是一款 AI 联网搜索助手，通过红狐 API 调用 Deepseek 联网搜索能力，提交查询后自动轮询等待结果返回。

适用于需要联网实时搜索、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. 查看结果

搜索完成后，助手会整理 Deepseek 的回答文本和引用来源，结构化展示给你。

### 常用说法速查

| 意图 | 示例话术 | 效果 |
|------|---------|------|
| 实时信息查询 | 「搜索一下今天的科技新闻」 | 调用 Deepseek 联网搜索，获取最新资讯 |
| 专业知识检索 | 「帮我查一下量子计算的最新进展」 | 搜索并整理专业领域的最新研究成果 |
| 事实验证 | 「搜索验证一下这个说法是否准确」 | 通过联网搜索核实信息准确性 |

---

## 🎯 使用场景

### 场景一：研究人员获取最新资料

**角色**：科研人员 / 学生

**需求**：查询某领域的最新研究进展或论文

**使用方式**：
1. 描述研究方向或具体问题
2. Deepseek 联网搜索相关学术资源
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 详情 |