git clone https://github.com/fengyuan19990207-max/deepseek-search.git
cd deepseek-search

# 只需一个 DeepSeek API Key（https://platform.deepseek.com/api_keys）
export DEEPSEEK_API_KEY=sk-xxxxxxxx        # Windows PowerShell: $env:DEEPSEEK_API_KEY='sk-xxxxxxxx'

node bin/dseek.mjs search "DeepSeek 自研搜索引擎" --count 3

npm install -g .
dseek search "site:github.com mcp server" -n 5

# 基本搜索
dseek search "DeepSeek V4 模型 发布" -n 5

# 只要标题和链接（不要分数/日期/摘要）
dseek search "本地部署 大模型" --no-meta

# 带上网页正文（need_content=true，返回更慢）
dseek search "RAG 检索增强 最佳实践" -n 3 --content

# 搜索语法：限定站点、语言、时间
dseek search "mcp server" --site github.com --site huggingface.co --lang en --after 2025

# 排除站点与关键词
dseek search "显卡评测" --exclude-site zhihu.com --exclude 广告

# 原始 JSON（便于 jq 等工具处理）
dseek search "Rust 异步运行时" -n 5 --json

# 抓取网页正文（Markdown）
dseek fetch https://api-docs.deepseek.com/zh-cn/guides/search/ --max-chars 2000

$ dseek search "DeepSeek 自研搜索引擎" --count 3
1. [更新日志 | DeepSeek API Docs](https://api-docs.deepseek.com/zh-cn/updates/)
   score 2.38 ★ · authority 3 ★ · DeepSeek
   Search / Fetch API 已上线，使用自研搜索引擎，支持网页搜索与抓取……

2. [DeepSeek API支持网页搜索与抓取 每千次请求5元](https://app.qudong.com/article/526513.html)
   score 2.37 ★ · authority 3 ★ · 2026-10-17 16:00:00 · 驱动中国
   DeepSeek发布公告，其API现已支持网页搜索与抓取，按请求次数计费……

# 3 条结果 · 349ms

- insert:
    - id: mcp-deepseek-search
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: deepseek
        transport: stdio
        command: '<NODE>/node.exe'
        args:
          - '<REPO>/bin/mcp-server.mjs'
        env:
          DSH_HOME: '<DSH_HOME>'      # 让服务器从 credentials.json 自动取 Key
          # DEEPSEEK_API_KEY: 'sk-...'  # 也可以显式给
        toolCallTimeoutMs: 120000
        failOnStartupError: false

{
  "mcpServers": {
    "deepseek": {
      "command": "node",
      "args": ["/绝对路径/deepseek-search/bin/mcp-server.mjs"],
      "env": { "DEEPSEEK_API_KEY": "sk-..." }
    }
  }
}

{
  "mcpServers": {
    "deepseek": {
      "command": "node",
      "args": ["/绝对路径/deepseek-search/bin/mcp-server.mjs"],
      "env": { "DEEPSEEK_API_KEY": "sk-..." }
    }
  }
}

[mcp_servers.deepseek]
command = "node"
args = ["/绝对路径/deepseek-search/bin/mcp-server.mjs"]

[mcp_servers.deepseek.env]
DEEPSEEK_API_KEY = "sk-..."

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
  | node bin/mcp-server.mjs

import { DeepSeekSearch, formatResultsMarkdown } from 'deepseek-search';

const client = new DeepSeekSearch();               // Key 自动发现

const { results, meta } = await client.search({
  query: 'DeepSeek 自研搜索引擎 lang:zh after:2026',
  count: 5,
  needContent: false,        // true 时才返回网页正文
  oriQuestion: 'DeepSeek 什么时候上线了搜索 API？',
});

console.log(formatResultsMarkdown(results, { summaryChars: 200 }));
console.log(meta);           // { count, elapsedMs, attempts }

const page = await client.fetch({ url: results[0].url });
console.log(page.title, page.content.length);

const client = new DeepSeekSearch({
  apiKey: 'sk-...',
  baseURL: 'https://api.deepseek.com',   // 或自建代理
  timeoutMs: 30_000,
  maxAttempts: 3,        // 408/429/5xx 才重试，指数退避 + 抖动
  retryDelayMs: 500,
  signal: undefined,     // 支持 AbortSignal
});

deepseek-search/
├── bin/
│   ├── dseek.mjs           # CLI
│   └── mcp-server.mjs      # 零依赖 MCP 服务器（stdio）
├── src/
│   ├── client.mjs          # /v1/tools/search、/v1/tools/fetch 客户端
│   ├── format.mjs          # Markdown / 文本 / JSON 渲染
│   └── index.mjs           # 统一出口
├── test/
│   ├── client.test.mjs     # 客户端与格式化单测（本地 Mock API）
│   ├── mcp-server.test.mjs # MCP 端到端（spawn 子进程 + Mock API）
│   ├── cli.test.mjs        # CLI 参数解析、搜索语法拼接、退出码
│   └── helpers.mjs         # Mock DeepSeek API
├── examples/
│   ├── search.mjs
│   └── dsh-cordis.patch.yml
└── .github/workflows/ci.yml

node --test test/client.test.mjs test/mcp-server.test.mjs test/cli.test.mjs   # 29 个用例：客户端、格式化、CLI、MCP 端到端，全部离线
node ./bin/dseek.mjs --version