English Français العربية

DeepSeek Web Search

Official registry Search and web

MCP server for DeepSeek web Search & Fetch: scored web search + page-to-Markdown fetch

Source code Documentation

What can you do with DeepSeek Web Search?

  • deepseek_search — web search backed by DeepSeek's search engine, with two quality signals per result:
  • deepseek_fetch — fetch a single page and get its main content as Markdown
  • Powerful query syntax: site:, -site:, -term, "exact phrase", -"phrase", lang:zh,en, after:YYYY-MM-DD, before:YYYY-MM-DD
  • Built-in throttling (stays under the 5 QPS account limit) and automatic retry on 408/429/5xx
  • Response-size friendly: summaries by default, full page text only on request

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package mcp-deepseek-search
Claude Code 
claude mcp add deepseek-web-search -e 'DEEPSEEK_API_KEY=<your deepseek_api_key>' -- npx -y mcp-deepseek-search@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "deepseek-web-search": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-deepseek-search@1.0.1"
            ],
            "env": {
                "DEEPSEEK_API_KEY": "<your deepseek_api_key>"
            }
        }
    }
}

Environment variables

  • DEEPSEEK_API_KEY required secret DeepSeek API key from https://platform.deepseek.com

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-deepseek-search
  2. Features
  3. Setup
  4. Tools
  5. Example
  6. Notes & limits
  7. Development
  8. License

An Model Context Protocol server that exposes DeepSeek's web **Search** and **Fetch** tools to any MCP client — Claude Desktop, Claude Code, Cursor, Cline, ZCode, and more.

Works with any LLM: the search runs on DeepSeek's own search engine, but the results are returned to your existing model as ordinary tool output.

Features

  • deepseek_search — web search backed by DeepSeek's search engine, with two quality signals per result:
    • rerank_score (0–3): relevance; ≥ 1.5 = highly relevant
    • authority (0–4, -1 unknown): source authority; ≥ 3 = highly authoritative
  • deepseek_fetch — fetch a single page and get its main content as Markdown
  • Powerful query syntax: site:, -site:, -term, "exact phrase", -"phrase", lang:zh,en, after:YYYY-MM-DD, before:YYYY-MM-DD
  • Built-in throttling (stays under the 5 QPS account limit) and automatic retry on 408/429/5xx
  • Response-size friendly: summaries by default, full page text only on request

Setup

  1. Get an API key at platform.deepseek.com (web tools are billed at ¥5 per 1,000 successful calls, charged to your DeepSeek account — failed calls and empty results are not billed).
  2. Add the server to your MCP client config:
Claude Desktop / Cursor / Cline / most clients
{
  "mcpServers": {
    "deepseek-web": {
      "command": "npx",
      "args": ["-y", "mcp-deepseek-search"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-your-key-here"
      }
    }
  }
}
ZCode

Add the same mcpServers block to your ZCode MCP settings (Settings → MCP → Add server).

From source
git clone https://github.com/Matthewyin/deepseek-mcp
cd deepseek-mcp && npm install && npm run build
node dist/index.js   # stdio MCP server

Tools

ParameterTypeRequiredDescription
querystringyes1–128 chars; supports the search syntax above
countintegerno1–50 results, default 10 (does not affect billing)
ori_questionstringnoThe user's original question — improves intent matching when the query was rewritten
localizationstringnoUser IP to localize results (pass only with consent)
need_contentbooleannoInclude full page text per result (each truncated at 8,000 chars). Default false

Each result includes title, url, snippet (short, for display), summary (long, for feeding to a model), rerank_score, authority, site_name, date, and optionally content.

deepseek_fetch
ParameterTypeRequiredDescription
urlstringyesPlain http(s) URL, max 8,192 chars, no embedded credentials

Returns title + Markdown content (truncated at 30,000 chars).

Example

Ask your agent: "用 deepseek_search 搜一下最近一周关于 MCP 的大新闻，挑权威来源，再用 deepseek_fetch 读全文总结" — or in English: "Search for recent DeepSeek news, keep only results with authority ≥ 3, fetch the top one and summarize."

Notes & limits

  • Rate limit is 5 QPS per DeepSeek account (shared across all your API keys); the server throttles automatically.
  • HTTP 402 means your DeepSeek balance ran out; 401 means the key is invalid.
  • Page content depends on the target site's availability and access policy.
  • This is an unofficial community wrapper; not affiliated with DeepSeek.

Development

npm install
npm run build
DEEPSEEK_API_KEY=sk-... npm test   # end-to-end test against the real API

Releases are automated via GitHub Actions: pushing a v* tag publishes to npm and the official MCP Registry.

License

MIT

Frequently asked questions

What is DeepSeek Web Search?

MCP server for DeepSeek web Search & Fetch: scored web search + page-to-Markdown fetch

How do I install DeepSeek Web Search?

It runs on your machine. In Claude Code: claude mcp add deepseek-web-search -e 'DEEPSEEK_API_KEY=<your deepseek_api_key>' -- npx -y mcp-deepseek-search@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does DeepSeek Web Search need an API key?

Yes. It expects DEEPSEEK_API_KEY, which you set in its configuration.

Is DeepSeek Web Search open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains DeepSeek Web Search?

It is published by Matthewyin. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.