seekfetch

seekfetch

由 DeepSeek Search & Fetch API 驱动，为 AI Agent 提供网页搜索和网页转 Markdown 功能。 一个软件包，三种使用方式：MCP 服务、CLI 和 TypeScript 库。

非官方社区项目。 seekfetch 与 DeepSeek 无关联，也未获其认可或赞助。 它是 DeepSeek 公共 API 的客户端，需要你提供自己的 API 密钥。

为什么选择它

• 调用专用端点（/v1/tools/search、/v1/tools/fetch）。中间没有聊天模型，因此一次搜索只需一次 API 请求，不消耗模型 Token。
• 搜索、抓取和研究。 research 只需一次搜索请求，就能返回最相关的网页及其内容；仅在返回的网页内容为空时才会抓取网页。
• 专为上下文窗口打造。 默认返回 DeepSeek 为模型准备的摘要，按相关性评分筛选，并通过偏移量分页读取长文档。
• 适用于生产环境。 对 408/429/5xx 错误进行退避重试，并遵循 Retry-After。请求速率控制在账户每秒 5 次的限制内，并在本地验证输入，避免无效请求产生费用。响应解析具有容错性，因此新增或缺失字段不会导致程序出错。

快速开始

1. 在 platform.deepseek.com 获取 API 密钥。
2. 将 seekfetch 添加到你的 MCP 客户端（见下文），或在 shell 中运行：

export DEEPSEEK_API_KEY=sk-...
npx -y seekfetch search "model context protocol registry"

需要 Node.js 22.12 或更高版本。

MCP 设置

该服务通过 stdio 运行，命令为 npx -y seekfetch mcp。

claude mcp add seekfetch -e DEEPSEEK_API_KEY=sk-... -- npx -y seekfetch mcp

{
  "mcpServers": {
    "seekfetch": {
      "command": "npx",
      "args": ["-y", "seekfetch", "mcp"],
      "env": { "DEEPSEEK_API_KEY": "sk-..." }
    }
  }
}

{
  "mcpServers": {
    "seekfetch": {
      "command": "npx",
      "args": ["-y", "seekfetch", "mcp"],
      "env": { "DEEPSEEK_API_KEY": "sk-..." }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "deepseek-key", "description": "DeepSeek API key", "password": true }
  ],
  "servers": {
    "seekfetch": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "seekfetch", "mcp"],
      "env": { "DEEPSEEK_API_KEY": "${input:deepseek-key}" }
    }
  }
}

[mcp_servers.seekfetch]
command = "npx"
args = ["-y", "seekfetch", "mcp"]
env = { DEEPSEEK_API_KEY = "sk-..." }

在 Windows 上，如果客户端找不到 npx，请使用 "command": "cmd"，并将 "args": ["/c", "npx", "-y", "seekfetch", "mcp"] 作为参数。

工具

所有工具均为只读。

CLI

npm i -g seekfetch          # or prefix each command with npx -y

seekfetch search "rust async runtimes" -n 5 --min-score 1.5
seekfetch search "mcp server" --site github.com --lang en --after 2026-01-01
seekfetch research "how is the DeepSeek search API priced?" -o notes.md
seekfetch fetch https://example.com --max-chars 20000
seekfetch search "query" --json | jq '.results[].url'

运行 seekfetch <command> --help 查看所有选项。

Agent 技能

skills/seekfetch/SKILL.md 会指导可使用 shell 的 Agent（Claude Code、Codex 和其他能读取 SKILL.md 的 Agent）了解何时以及如何使用 CLI。将该文件夹复制到 Agent 的技能目录，例如 ~/.claude/skills/seekfetch/。

库

import { DeepSeekWebClient, buildQuery, research } from "seekfetch";

const client = new DeepSeekWebClient({ apiKey: process.env.DEEPSEEK_API_KEY! });

const { results } = await client.search({
  query: buildQuery("vector databases", { sites: ["github.com"], after: "2026" }),
  count: 10,
});

const page = await client.fetch("https://example.com"); // { title, content (Markdown) }
const report = await research(client, { question: "What changed in MCP this year?", maxPages: 3 });

配置

API 限制与定价

根据 DeepSeek 于 2026-10-18 发布的文档；如需了解当前条款，请查看 Search & Fetch 指南。

• 查询长度上限为 128 个字符，包含筛选条件。count 的取值范围为 1–50。
• 实际观察到：摘要长度为 1,000–3,500 个字符（文档称为 600–800 个字符），搜索返回的页面内容上限约为 20,000 个字符；site: 是优先条件，而非严格筛选条件。
• 搜索的速率限制为每个账户 5 QPS，抓取也单独限制为每个账户 5 QPS。抓取还有每个域名的速率限制。
• 按成功请求计费，公布价格为每个 API 每 1,000 次 $0.75。空结果和错误不收费。

开发

npm install
npm test          # unit + MCP tests against a fake API
npm run build

欢迎提交问题和 PR。

许可证

MIT。“DeepSeek”是其所有者的商标，此处仅用于描述此客户端所调用的 API。