摘要： DeepSeek 在 2026 年 10 月 17 日把自家的 in-house 搜尋引擎以 API 形式開放，提供 Search（找網頁、回傳結構化結果）與 Fetch（抓單頁轉成 Markdown）兩個 JSON 端點。對開發者來說，這代表 agent 或 RAG 應用不必再串第三方搜尋服務，用同一把 DeepSeek API key 就能取得即時網頁內容。本文整理端點用法、計費與限流的關鍵細節。
兩個端點，同一套驗證
兩個 API 都打向 https://api.deepseek.com，用與 DeepSeek API 相同的 Bearer token 驗證：
- Search：
POST /v1/tools/search，輸入查詢字串，回傳結構化結果陣列。 - Fetch：
POST /v1/tools/fetch，輸入網址，回傳該頁的標題與 Markdown 內容。
根據 DeepSeek 官方 changelog，這個搜尋引擎索引數千億網頁、支援多語言，並標榜過濾 SEO 垃圾與低品質 AIGC 內容。實際表現如何，還是要以你自己的查詢場景驗證。
查詢運算子是實戰重點
Search API 的 query 欄位不是單純的關鍵字，而是保留了完整的搜尋語法，可以在一個字串裡組合多個運算子：
curl https://api.deepseek.com/v1/tools/search \
-H "Authorization: Bearer <DeepSeek API Key>" \
-H "Content-Type: application/json" \
-d '{
"query": "DeepSeek site:github.com OR site:huggingface.co lang:en after:2025",
"count": 10
}'常用的包括 site: 限定網域、lang: 限定語言、after: / before: 限定日期、"..." 精確比對，以及 - 排除詞彙或網站。對 agent 來說，把這些運算子寫進 tool description，模型就能自行收斂搜尋範圍。
回傳欄位是為模型閱讀設計的
每筆結果同時給了兩種摘要：snippet（約 100–200 字，適合 UI 顯示）與 summary（約 600–800 字，適合直接餵給模型）。另有 rerank_score（0 到 3，文件說 1.5 以上算高品質）與 authority（0 到 4 的權威分級，3 以上代表高權威來源）。這兩個分數可以直接作為 agent 決定要不要深入閱讀某筆結果的訊號，不必自己再寫一層過濾邏輯。
若把 need_content 設為 true，回應會附上整頁內容；需要完整原文時，也可以改用 Fetch API 抓單頁。
計費與限流：先算好 agent 的呼叫頻率
幾個會直接影響成本結構的細節：
- Search 與 Fetch 都是按成功請求計費，每 1,000 次成功請求 $0.75，與回傳結果數量無關。空結果、失敗與逾時不計費。
- 透過 DeepSeek Harness、Claude Code 或 Codex 使用 DeepSeek API 時，server-side tool call 已經會打到這兩個 API，目前免費，但 2026 年 11 月 1 日起將開始按次計費——如果你的 agent 流程依賴這些內建搜尋，這個時間點要記在行事曆上。
- 每個帳號的 Search 與 Fetch 各有 5 QPS 上限，且 Fetch 另有對單一網域的 QPS 限制，超過會收到 429。做爬取密集的 workflow 時，這個上限比模型併發限制更容易先撞到。
放在你的 tool stack 裡怎麼看
此前我們在挑選網頁搜尋 API 時討論過，選型的第一步是定義任務：需要日期過濾、語言限定和權威度訊號的知識型 agent，DeepSeek Search 的運算子與回傳欄位就相當對口；而如果你的 agent 主要在 Cloudflare 或 Vercel 生態裡跑，平台原生的方案整合成本可能更低。
實務上的下一步很簡單：拿你現有的幾十條真實查詢，分別打 Search API 與你目前的供應商，比較 rerank_score 分布和結果重疊度，再決定要不要切換。文件與完整的 request/response schema 在官方 Search & Fetch 指南裡。
參考來源
在 X 上查看原貼文