seekfetch

seekfetch

DeepSeek Search & Fetch API を利用した、AI エージェント向けの Web 検索とページの Markdown 化。 1 つのパッケージを 3 通りで利用できます。MCP サーバー、CLI、TypeScript ライブラリです。

非公式のコミュニティプロジェクトです。 seekfetch は DeepSeek と提携、推奨、後援の関係にありません。 DeepSeek の公開 API を利用するクライアントであり、ご自身の API キーが必要です。

特長

• 専用エンドポイントを呼び出します（/v1/tools/search、/v1/tools/fetch）。間にチャットモデルを挟まないため、検索のコストは API リクエスト 1 回分で、モデルのトークンは消費しません。
• 検索、取得、リサーチに対応します。 research は 1 回の検索リクエストで、コンテンツ付きの最適なページを返し、内容が空だったページだけを取得します。
• コンテキストウィンドウ向けに設計されています。 デフォルトで DeepSeek のモデル向け要約を返し、関連性スコアで絞り込み、オフセットを使って長いドキュメントをページ分割します。
• 本番環境向けの動作を備えています。 408／429／5xx をバックオフ付きで再試行し、Retry-After に従います。アカウントの上限である 5 QPS に合わせてリクエストを調整し、不正なリクエストが API 呼び出しのコストにならないよう、入力をローカルで検証します。レスポンスを柔軟に解析するため、新しいフィールドや欠落したフィールドがあっても動作に支障はありません。

クイックスタート

1. platform.deepseek.com で API キーを取得します。
2. seekfetch を MCP クライアントに追加するか（下記参照）、シェルから実行します。

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

Node.js 22.12 以降が必要です。

MCP の設定

サーバーは npx -y seekfetch mcp を使って stdio 経由で動作します。

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 を実行してください。

エージェントスキル

skills/seekfetch/SKILL.md は、シェルを使うエージェント（Claude Code、Codex、および SKILL.md を読み込むその他のエージェント）に、CLI を使うタイミングと方法を教えます。たとえば ~/.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 の制限と料金

2026-10-18 時点で DeepSeek が公開している情報です。最新の利用条件については、検索と取得のガイドをご確認ください。

• クエリはフィルターを含めて128文字までです。count は1～50です。
• 実際の使用で確認された内容：要約は1,000～3,500文字（ドキュメントでは600～800文字と記載）、検索結果のページコンテンツは約20,000文字が上限で、site: は厳密なフィルターではなく、強い優先指定として機能します。
• 検索はアカウントあたり毎秒5クエリ、取得も別途毎秒5クエリです。取得にはドメインごとの制限もあります。
• 料金は成功したリクエストごとに課金され、各APIとも1,000リクエストあたり$0.75と公開されています。結果が空の場合やエラーの場合は課金されません。

開発

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

IssueやPRを歓迎します。

ライセンス

MITです。「DeepSeek」はその所有者の商標であり、ここではこのクライアントが呼び出すAPIを説明する目的でのみ使用しています。