Claude Skill

deepseek-websearch

Deepseek 联网搜索工具。一键调用 AI 联网搜索能力，快速获取实时信息。当用户需要使用 Deepseek 搜索、联网搜索、AI 搜索获取实时信息时使用。触发词：Deepseek搜索、deepseek websearch、联网搜索、AI搜索、ds搜索。

LLM Mart · 0 points · 0 0 0

Virus-scanned Reviewed automatically before listing.

Full trust report

Download redfox-data-redfox-community-skills_deepseek-websearch-5e7b435.zip · 8 KB

redfox-data/redfox-community 413 55 forks Updated 2d ago

Part of redfox-data/redfox-community — 66 skills

Install

skills CLI npx skills add https://github.com/redfox-data/redfox-community/tree/main/skills/deepseek-websearch

Claude Code

claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install redfox-data-redfox-community@llmmart

Git git clone https://github.com/redfox-data/redfox-community.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole redfox-data/redfox-community collection as a plugin from our marketplace. Git is the plain clone.

README

Deepseek 联网搜索 / deepseek-websearch

简介

Deepseek 联网搜索帮你突破大模型知识截止日期的限制，一键调用 AI 联网搜索能力，随时获取最新、准确的实时信息。

核心价值

实时联网搜索：突破知识截止日期限制，随时获取最新资讯。
省心体验：搜索发起后自动等待结果，无需手动干预或刷新。
结构化结果：搜索结果包含详细回答与引用来源，便于查阅和引用。

适用对象

🔍 研究人员 / 学生 — 快速检索最新学术进展与专业资料。
📰 内容创作者 / 运营 — 追踪热点话题，获取创作素材。
💻 开发者 / 技术负责人 — 技术调研、方案对比与文档查询。

功能特性

核心功能

一键搜索：自然语言描述搜索需求即可发起查询，无需记忆命令。
智能等待：搜索发起后自动等待结果，实时反馈进度，无需手动刷新。
结构化输出：搜索结果包含详细回答与引用来源，信息清晰、便于查阅。
异常容错：覆盖多种异常场景，每种情况有明确提示，不卡流程。

密钥获取与安全说明

本技能需要使用环境变量：REDFOX_API_KEY。
REDFOX_API_KEY 由红狐 hub (https://redfox.hk)提供。
请前往红狐 hub 注册账号，获取 REDFOX_API_KEY。
配置设备环境变量 REDFOX_API_KEY 后使用本技能。
在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。

使用指南

直接用自然语言描述你的搜索需求即可，无需记忆固定命令。

常用说法速查

意图	示例话术	效果
实时信息查询	「搜索一下今天的科技新闻」	获取最新资讯
专业知识检索	「帮我查一下量子计算的最新进展」	搜索并整理专业领域的最新研究成果
事实验证	「搜索验证一下这个说法是否准确」	通过联网搜索核实信息准确性
技术方案调研	「对比一下 React 和 Vue 的最新版本特性」	获取技术文档和社区反馈，辅助决策

输出示例

搜索完成后，你将收到结构化的搜索结果，包含：

详细回答：针对你问题的完整解答
引用来源：搜索结果中引用的网页链接，便于进一步查阅

使用场景

场景	角色	示例问法	收益
学术资料检索	科研人员 / 学生	「搜索大语言模型最新论文」	快速获取前沿研究，提升科研效率
热点话题追踪	自媒体博主 / 运营	「搜一下最近的 AI 热点新闻」	紧跟行业动态，产出时效性内容
技术方案调研	软件工程师	「对比几种数据库方案的优劣」	获取最新技术文档，降低选型风险
事实核查验证	记者 / 内容审核	「验证这条新闻的真实性」	通过多源信息交叉验证，确保准确

Skill manifest

Deepseek WebSearch

📝 简介

Deepseek WebSearch 是一款 AI 联网搜索助手，帮你突破大模型知识截止日期的限制，随时获取最新、准确的实时信息。

适用于需要联网搜索、AI 辅助信息检索的场景，用自然语言描述需求即可获得结构化的搜索结果。

✨ 功能特性

功能模块	能力描述	核心价值
一键搜索	自然语言描述搜索需求，即可发起查询	无需记忆命令，降低使用门槛
智能等待	搜索发起后自动等待结果，实时反馈进度	无需手动刷新，省心省力
结构化输出	搜索结果包含详细回答与引用来源	信息清晰、便于查阅和引用
异常容错	覆盖多种异常场景，每种情况有明确提示	遇到问题有指引，不卡流程

🔑 一键安装

前置条件

已注册红狐 hub 账号并获取 API Key
本地已安装 Python 3 环境

安装步骤

获取 API Key

前往红狐hub 注册并获取 REDFOX_API_KEY。

配置环境变量

# 方式一：配置文件（如 OpenClaw 的 ~/.openclaw/openclaw.json）
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

# 方式二：终端环境变量
export REDFOX_API_KEY="ak_xxxx..."

安装依赖
```
pip3 install requests
```

📖 使用指南

直接用自然语言描述你的搜索需求即可，无需记忆固定命令。

基础使用

1. 发起搜索

告诉助手你想搜索的内容：

用户：帮我搜索一下最新的 AI 大模型发展趋势

助手：正在为您搜索，请稍候…

2. 获取结果

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

常用说法速查

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

🎯 使用场景

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

角色：科研人员 / 学生

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

使用方式：

描述研究方向或具体问题
联网搜索相关学术资源
整理并呈现搜索结果

预期收益：快速获取最新学术信息，提升研究效率

场景二：内容创作者追踪热点

角色：自媒体博主 / 内容运营

需求：追踪行业热点、竞品动态

使用方式：

搜索特定话题的最新动态
获取实时新闻和社交媒体讨论
基于搜索结果创作内容

预期收益：紧跟热点，产出时效性强的内容

场景三：开发者技术调研

角色：软件工程师 / 技术负责人

需求：调研新技术、框架或解决方案

使用方式：

搜索技术方案对比信息
获取最新文档和社区反馈
辅助技术决策

预期收益：降低技术选型风险，加速开发进程

🔄 工作流程

核心执行流程详见 references/core_workflow.md

⚠️ 错误处理

情况	处理方式
未配置 `REDFOX_API_KEY`	提示用户前往红狐hub 获取 API Key
服务返回 502	服务返回 502 错误，可能存在网络不稳定问题，请稍后重试
搜索请求失败	输出错误信息，建议用户重试
搜索超时	提示超时，建议稍后重试
搜索任务失败	输出失败原因详情

Files (redfox-community)

references

core_workflow.md 954 B

# Core Workflow

## Step 1：提取搜索关键词

从用户自然语言描述中提取搜索意图和关键词，作为 `inquiryText` 传入。

## Step 2：调用搜索脚本

```bash
python3 ~/.agents/skills/deepseek-websearch/scripts/deepseek_search.py "<搜索关键词>"
```

脚本自动完成以下流程：
1. **提交搜索**：`POST /story/api/deepSearch/dsSubmit`，传入 `{"inquiryText": "...", "source": "Deepseek WebSearch-GitHub"}`
2. **轮询结果**：每 5 秒 `POST /story/api/deepSearch/dsResult` 查询一次，直到状态为 `succeeded`
3. **实时反馈**：轮询期间通过 stderr 输出等待提示（状态：queued → running → succeeded）
4. **最终输出**：状态 `succeeded` 后输出完整 JSON 结果到 stdout

## Step 3：展示结果

脚本返回 JSON 后，提取 `data.result.content` 中的 Deepseek 回答文本和 `data.result.search_result` 中的引用来源，结构化整理后向用户展示。

scripts

deepseek_search.py 5.3 KB

#!/usr/bin/env python3
"""
Deepseek WebSearch — 提交搜索查询并轮询结果

用法:
    python3 deepseek_search.py "<搜索关键词>"

环境变量:
    REDFOX_API_KEY — 红狐 API Key（必填）
"""

import os
import sys
import json
import time

import requests

# Windows 控制台 UTF-8 编码修复
if sys.platform == "win32":
    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
    sys.stderr.reconfigure(encoding="utf-8", errors="replace")

API_BASE = "https://redfox.hk/story/api/deepSearch"
API_KEY = os.environ.get("REDFOX_API_KEY")
MAX_ATTEMPTS = 60  # 最多轮询 5 分钟
POLL_INTERVAL = 5  # 轮询间隔（秒）


def main():
    if not API_KEY:
        print(
            json.dumps(
                {
                    "error": (
                        "未配置 REDFOX_API_KEY 环境变量，"
                        "请前往 https://redfox.hk/settings/api-keys?source=github 获取 API Key"
                    )
                },
                ensure_ascii=False,
            )
        )
        sys.exit(1)

    if len(sys.argv) < 2:
        print(json.dumps({"error": "请提供搜索关键词"}, ensure_ascii=False))
        sys.exit(1)

    query = sys.argv[1]

    headers = {
        "REDFOX_API_KEY": API_KEY,
        "Content-Type": "application/json",
    }

    # ── Step 1: 提交搜索 ──────────────────────────────────────────────
    try:
        submit_resp = requests.post(
            f"{API_BASE}/dsSubmit",
            json={"inquiryText": query, "source": "Deepseek WebSearch-GitHub"},
            headers=headers,
            timeout=30,
        )
        submit_resp.raise_for_status()
        submit_data = submit_resp.json()
    except requests.HTTPError as e:
        status_code = e.response.status_code if e.response is not None else None
        if status_code == 502:
            print(
                json.dumps(
                    {
                        "error": (
                            "服务返回 502 错误，可能存在网络不稳定问题，"
                            "请稍后重试"
                        )
                    },
                    ensure_ascii=False,
                )
            )
        else:
            print(
                json.dumps(
                    {"error": f"提交搜索请求失败 (HTTP {status_code}): {e}"},
                    ensure_ascii=False,
                )
            )
        sys.exit(1)
    except requests.RequestException as e:
        print(json.dumps({"error": f"提交搜索请求失败: {e}"}, ensure_ascii=False))
        sys.exit(1)

    task_id = submit_data.get("data", {}).get("taskId")
    if not task_id:
        print(
            json.dumps(
                {"error": f"提交失败，未获取到 taskId: {submit_data}"},
                ensure_ascii=False,
            )
        )
        sys.exit(1)

    print(
        f"⏳ 已提交搜索请求 (taskId: {task_id})，正在等待 Deepseek WebSearch 返回结果…",
        file=sys.stderr,
    )

    # ── Step 2: 轮询结果 ──────────────────────────────────────────────
    for attempt in range(1, MAX_ATTEMPTS + 1):
        time.sleep(POLL_INTERVAL)

        try:
            result_resp = requests.post(
                f"{API_BASE}/dsResult",
                json={"taskId": task_id},
                headers=headers,
                timeout=30,
            )
            result_resp.raise_for_status()
            result_data = result_resp.json()
        except requests.HTTPError as e:
            status_code = e.response.status_code if e.response is not None else None
            if status_code == 502:
                print(
                    f"⚠️ 第 {attempt} 次轮询遇到 502 错误（网络不稳定），继续重试…",
                    file=sys.stderr,
                )
            else:
                print(
                    f"⚠️ 第 {attempt} 次查询结果失败 (HTTP {status_code}): {e}，继续重试…",
                    file=sys.stderr,
                )
            continue
        except requests.RequestException as e:
            print(
                f"⚠️ 第 {attempt} 次查询结果失败: {e}，继续重试…",
                file=sys.stderr,
            )
            continue

        status = result_data.get("data", {}).get("status", "")

        if status in ("succeeded", "completed"):
            # 成功：输出最终结果到 stdout
            print(json.dumps(result_data, ensure_ascii=False))
            return

        if status == "failed":
            fail_reason = result_data.get("data", {}).get("failReason", "")
            print(
                json.dumps(
                    {"error": f"搜索任务失败: {fail_reason or result_data}"},
                    ensure_ascii=False,
                )
            )
            sys.exit(1)

        # 仍在处理中，提示用户进度 (queued / running)
        print(
            f"   ⏳ 第 {attempt} 次轮询，状态: {status}，继续等待…",
            file=sys.stderr,
        )

    print(
        json.dumps({"error": "搜索超时（已等待 5 分钟），请稍后重试"}, ensure_ascii=False)
    )
    sys.exit(1)


if __name__ == "__main__":
    main()

README.en.md 3.7 KB

# Deepseek Web Search / deepseek-websearch

---

## Overview

Deepseek Web Search helps you break through the knowledge cutoff limitation of large models. With one click, access AI-powered web search to retrieve the latest, most accurate real-time information anytime.

**Core Value**

- **Real-time web search**: Break through the knowledge cutoff limitation and access the latest information anytime.
- **Effortless experience**: After submitting a search, results are retrieved automatically—no manual intervention or refreshing needed.
- **Structured results**: Search results include detailed answers and source citations for easy review and reference.

**Intended Users**

- 🔍 **Researchers / Students** — Quickly retrieve the latest academic advances and professional resources.
- 📰 **Content creators / Operators** — Track trending topics and gather creative material.
- 💻 **Developers / Tech leads** — Technical research, solution comparison, and documentation lookup.

---

## Features

### Core Capabilities

- **One-click search**: Describe your search need in natural language to start—no commands to memorize.
- **Smart waiting**: After submitting a search, results are retrieved automatically with real-time progress feedback—no manual refreshing needed.
- **Structured output**: Search results include detailed answers and source citations, clearly organized for easy review.
- **Fault tolerance**: Covers multiple exception scenarios with clear prompts for each, so your workflow never gets stuck.

---

## API Key Acquisition & Security

- This skill requires the environment variable: `REDFOX_API_KEY`.
- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=github) (`https://redfox.hk`)
- Register at [RedFoxHub](https://redfox.hk?source=github) to obtain `REDFOX_API_KEY`.
- Configure `REDFOX_API_KEY` on your device before using this skill.
- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.
- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.

---

## Usage Guide

Simply describe your search need in natural language—no fixed commands to memorize.

### Quick Reference

| Intent | Example phrase | Result |
|--------|---------------|--------|
| Real-time info query | "Search for today's tech news" | Retrieves the latest news |
| Professional knowledge lookup | "Look up the latest advances in quantum computing" | Searches and organizes the latest research in the field |
| Fact verification | "Verify whether this claim is accurate" | Cross-references via web search to confirm accuracy |
| Tech solution research | "Compare the latest features of React and Vue" | Retrieves documentation and community feedback to aid decisions |

### Output Example

After the search completes, you receive structured results including:

- **Detailed answer**: A comprehensive response to your query
- **Source citations**: Webpage links referenced in the search results for further reading

---

## Use Cases

| Scenario | Role | Example question | Benefit |
|----------|------|-----------------|---------|
| Academic research | Researcher / Student | "Search for the latest LLM papers" | Quickly access cutting-edge research and improve efficiency |
| Trending topic tracking | Creator / Operator | "Search for the latest AI hot topics" | Stay on top of industry trends and produce timely content |
| Tech solution research | Software engineer | "Compare the pros and cons of several database solutions" | Access the latest documentation and reduce selection risk |
| Fact-checking | Journalist / Content reviewer | "Verify the authenticity of this news" | Cross-verify from multiple sources to ensure accuracy |

---

README.md 3.2 KB

# Deepseek 联网搜索 / deepseek-websearch

---

## 简介

Deepseek 联网搜索帮你突破大模型知识截止日期的限制，一键调用 AI 联网搜索能力，随时获取最新、准确的实时信息。

**核心价值**

- **实时联网搜索**：突破知识截止日期限制，随时获取最新资讯。
- **省心体验**：搜索发起后自动等待结果，无需手动干预或刷新。
- **结构化结果**：搜索结果包含详细回答与引用来源，便于查阅和引用。

**适用对象**

- 🔍 **研究人员 / 学生** — 快速检索最新学术进展与专业资料。
- 📰 **内容创作者 / 运营** — 追踪热点话题，获取创作素材。
- 💻 **开发者 / 技术负责人** — 技术调研、方案对比与文档查询。

---

## 功能特性

### 核心功能

- **一键搜索**：自然语言描述搜索需求即可发起查询，无需记忆命令。
- **智能等待**：搜索发起后自动等待结果，实时反馈进度，无需手动刷新。
- **结构化输出**：搜索结果包含详细回答与引用来源，信息清晰、便于查阅。
- **异常容错**：覆盖多种异常场景，每种情况有明确提示，不卡流程。

---

## 密钥获取与安全说明

- 本技能需要使用环境变量：`REDFOX_API_KEY`。
- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=github) (`https://redfox.hk`)提供。
- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。
- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。
- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。

---

## 使用指南

直接用自然语言描述你的搜索需求即可，无需记忆固定命令。

### 常用说法速查

| 意图 | 示例话术 | 效果 |
|------|---------|------|
| 实时信息查询 | 「搜索一下今天的科技新闻」 | 获取最新资讯 |
| 专业知识检索 | 「帮我查一下量子计算的最新进展」 | 搜索并整理专业领域的最新研究成果 |
| 事实验证 | 「搜索验证一下这个说法是否准确」 | 通过联网搜索核实信息准确性 |
| 技术方案调研 | 「对比一下 React 和 Vue 的最新版本特性」 | 获取技术文档和社区反馈，辅助决策 |

### 输出示例

搜索完成后，你将收到结构化的搜索结果，包含：

- **详细回答**：针对你问题的完整解答
- **引用来源**：搜索结果中引用的网页链接，便于进一步查阅

---

## 使用场景

| 场景 | 角色 | 示例问法 | 收益 |
|------|------|---------|------|
| 学术资料检索 | 科研人员 / 学生 | 「搜索大语言模型最新论文」 | 快速获取前沿研究，提升科研效率 |
| 热点话题追踪 | 自媒体博主 / 运营 | 「搜一下最近的 AI 热点新闻」 | 紧跟行业动态，产出时效性内容 |
| 技术方案调研 | 软件工程师 | 「对比几种数据库方案的优劣」 | 获取最新技术文档，降低选型风险 |
| 事实核查验证 | 记者 / 内容审核 | 「验证这条新闻的真实性」 | 通过多源信息交叉验证，确保准确 |

---

SKILL.md 4.1 KB

---
name: deepseek-websearch
description: Deepseek 联网搜索工具。一键调用 AI 联网搜索能力，快速获取实时信息。当用户需要使用 Deepseek 搜索、联网搜索、AI 搜索获取实时信息时使用。触发词：Deepseek搜索、deepseek websearch、联网搜索、AI搜索、ds搜索。
---

# Deepseek WebSearch

## 📝 简介

Deepseek WebSearch 是一款 AI 联网搜索助手，帮你突破大模型知识截止日期的限制，随时获取最新、准确的实时信息。

适用于需要联网搜索、AI 辅助信息检索的场景，用自然语言描述需求即可获得结构化的搜索结果。

---

## ✨ 功能特性

| 功能模块 | 能力描述 | 核心价值 |
|---------|---------|---------|
| 一键搜索 | 自然语言描述搜索需求，即可发起查询 | 无需记忆命令，降低使用门槛 |
| 智能等待 | 搜索发起后自动等待结果，实时反馈进度 | 无需手动刷新，省心省力 |
| 结构化输出 | 搜索结果包含详细回答与引用来源 | 信息清晰、便于查阅和引用 |
| 异常容错 | 覆盖多种异常场景，每种情况有明确提示 | 遇到问题有指引，不卡流程 |

---

## 🔑 一键安装

### 前置条件

- 已注册红狐 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 大模型发展趋势
>
> 助手：正在为您搜索，请稍候…

#### 2. 获取结果

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

### 常用说法速查

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

---

## 🎯 使用场景

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

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

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

**使用方式**：
1. 描述研究方向或具体问题
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 | 服务返回 502 错误，可能存在网络不稳定问题，请稍后重试 |
| 搜索请求失败 | 输出错误信息，建议用户重试 |
| 搜索超时 | 提示超时，建议稍后重试 |
| 搜索任务失败 | 输出失败原因详情 |