# DeepSeek Web Search

> DeepSeek Web Search is an open-source MCP server for web search and scraping. Scored web search, page-to-Markdown fetch, OCR, speech-to-text and TTS on DeepSeek APIs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/matthewyin/deepseek-mcp
- **MCP Registry name:** io.github.Matthewyin/deepseek-mcp
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

This community wrapper (the README says it is unofficial) runs on your machine over stdio and calls DeepSeek's web tools with your own API key. Results come back as ordinary tool output, so any model in the client can use them, not just DeepSeek's.

The search tool, deepseek_search, attaches two quality signals to each result: a relevance score from 0 to 3 and an authority rating from 0 to 4, with thresholds of 1.5 and 3 treated as strong. Queries accept operators such as site:, -site:, exact phrases, lang: and date filters, and up to 50 results are returned. deepseek_fetch turns one page into Markdown, truncated at 30,000 characters.

Three more tools handle files: deepseek_ocr reads PDF, Word, PowerPoint and image pages, deepseek_asr transcribes WAV or Ogg Opus audio, and deepseek_tts writes speech to a local file in a female or male voice. The README quotes ¥5 per 1,000 successful web calls, billed by DeepSeek, with a 5 queries-per-second account limit handled by built-in throttling and retries.

## Features

- **Scored search:** Each result carries a relevance score and an authority rating.
- **Search operators:** Supports site, exclusion, exact-phrase, language and date filters.
- **Page to Markdown:** Fetches a single URL and returns its main content as Markdown.
- **OCR:** Extracts per-page text from PDFs, Office files and images.
- **Speech-to-text:** Transcribes 16-bit PCM WAV or Ogg Opus audio.
- **Text-to-speech:** Writes a female or male voice to a local wav or pcm file.
- **Throttling and retry:** Stays under the 5 QPS limit and retries on 408, 429 and 5xx.

## Good for

- Search for recent news and keep only authoritative sources
- Read a long article as Markdown and summarise it
- Extract text from a scanned PDF
- Transcribe an audio recording
- Generate a spoken version of a short text

## Install

### Claude Code (Terminal)

```sh
claude mcp add deepseek-mcp --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' -- npx -y mcp-deepseek-search
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "deepseek-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-deepseek-search"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "deepseek-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-deepseek-search"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "deepseek-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-deepseek-search"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "deepseek-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-deepseek-search"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "deepseek-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-deepseek-search"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
      }
    }
  }
}
```

## Tools

- `deepseek_search`: Web search with relevance and authority scores.
- `deepseek_fetch`: Fetches a page as Markdown.
- `deepseek_ocr`: Extracts text from PDF, Word, PowerPoint and images.
- `deepseek_asr`: Transcribes WAV or Ogg Opus audio.
- `deepseek_tts`: Synthesizes speech to a local file.

## FAQ

### What do I need?

A DeepSeek API key from platform.deepseek.com, set as DEEPSEEK_API_KEY.

### How much does it cost?

The README quotes ¥5 per 1,000 successful web calls; failed calls and empty results are not billed.

### Is it official?

No. The README calls it an unofficial community wrapper.

### Does it only work with DeepSeek models?

No. Results are returned as normal tool output to whichever model the client uses.

### Is DeepSeek Web Search free?

Yes. DeepSeek Web Search is open source, so you can use and self-host it for free.

### How do I add DeepSeek Web Search to Claude Code?

Run this command in your terminal: claude mcp add deepseek-mcp --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' -- npx -y mcp-deepseek-search

### What are the best alternatives to DeepSeek Web Search?

The closest alternatives to DeepSeek Web Search are Scrapling MCP Server, Firecrawl MCP Server, Douyin_TikTok_Download_API, SearXNG Search and machine_internet.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Douyin_TikTok_Download_API](https://ai-powered.com/mcp/douyin-tiktok-download-api): Douyin_TikTok_Download_API is an open-source MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [machine_internet](https://ai-powered.com/mcp/machine-internet): machine_internet is an open-source MCP server for web search and scraping.
- [acrawl](https://ai-powered.com/mcp/acrawl): acrawl is an open-source MCP server for browser automation.
- [Countries](https://ai-powered.com/mcp/countries): Countries is a freemium MCP server for web search and scraping.
- [Listen Notes](https://ai-powered.com/mcp/listen-notes): Listen Notes is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/deepseek-web-search
