Search1API

官方

一個用於搜尋、爬取和網站地圖的API

GitHub

175

你可以用 Search1API MCP 做什麼？

網頁搜尋 — 請助理使用 search 在 Google、Bing、GitHub、arXiv 或 Reddit 等搜尋引擎中搜尋，並設定網站篩選條件和時間範圍。
新聞查詢 — 使用 news 尋找 Google、Bing、DuckDuckGo、Yahoo 或 Hacker News 的近期文章，也可選擇爬取熱門搜尋結果。
網頁與網站地圖擷取 — 擷取 URL 的完整內容，或列出網站上的所有相關連結。
熱門趨勢 — 擷取 GitHub 或 Hacker News 的熱門項目。
代理式搜尋 — 以自然語言描述需求，讓 ask 選擇搜尋引擎並回傳依排名排列、可引用的結果。
本地地點搜尋 — 在 Google 地圖上尋找商家和地點，並取得地址、評分、營業時間和聯絡資訊。

文件

Search1API MCP Server

中文文档 | Deutsch

Search1API 的官方 MCP 伺服器 — 透過單一 API 提供網頁搜尋、新聞、頁面擷取、網站地圖探索和熱門話題。

驗證

支援 OAuth 的用戶端可直接連線至 Remote MCP URL，然後在瀏覽器中登入並核准存取權限。
現有整合可繼續使用 Search1API 控制面板中的 API 金鑰。
每個 MCP 請求 — 包括工具探索 (initialize, tools/list) — 都需要憑證。未經驗證的請求會收到 OAuth 挑戰，用戶端可藉此觸發登入；連線前的檢視則由靜態的伺服器卡片提供。

快速入門（Remote MCP）

無需安裝。使用遠端 URL 設定 MCP 用戶端。用戶端支援 OAuth 時請使用 OAuth，或提供 API 金鑰。

驗證

支援三種方式 — 請使用用戶端支援的方式：

方式	格式
OAuth 2.1	不使用金鑰連線至 `https://mcp.search1api.com/mcp`，並依照用戶端的登入流程操作
Authorization Header	`Authorization: Bearer YOUR_SEARCH1API_KEY`
URL Query Parameter (legacy)	`https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY`

建議使用 OAuth 或 Authorization header。查詢參數中的憑證可能會暴露在 URL、記錄和 shell 歷史記錄中。

選用的搜尋與新聞 UI

Remote MCP 會在上述標準端點提供 render_results。像是 search、news 和 ask 這類資料工具會傳回結果，但不會自動顯示卡片。需要來源清單時，模型可以選取或組合現有結果，再傳給 render_results。它會在 MCP Apps 用戶端中傳回來源卡片，在其他地方則傳回完整且易讀的文字清單。呈現結果不會重複搜尋，也不會消耗搜尋點數；不需要 UI URL 參數。

HTTP 和 stdio 都會透過標準的 serverInfo.icons 中繼資料提供 Search1API 的方形標誌。512×512 PNG 公開提供於 https://mcp.search1api.com/assets/icon-square.png，無需驗證，也不會重新導向。伺服器卡片和登錄檔資訊清單使用相同圖示。用戶端可自行決定是否顯示；這不會取代外掛目錄中另行儲存的圖示。

參閱呈現規範，了解引數、限制和備援行為。npm 套件從 0.8.0 版起包含此呈現器。更新現有安裝並重新啟動 MCP 連線；npx -y search1api-mcp@latest 會啟動最新發布的套件。

變更 URL 後，請重新連線或重新整理連接器的工具定義；用戶端可能會快取這些定義。此 URL 設定僅適用於 Remote MCP；本機 stdio 行為不變。詳情和發布狀態請參閱 MCP Apps UI。

Claude Desktop

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude.ai (Web)

從 Claude 目錄安裝 Search1API，按一下 Connect，並使用 Search1API 帳戶登入。

請避免透過 Add custom connector 新增 https://mcp.search1api.com/mcp：這會建立獨立的自訂連接器，Claude 會以 URL 的主機名稱 (mcp.search1api.com) 為其命名，除非你自行輸入名稱。

Cursor

建議以 Cursor 外掛方式安裝：此儲存庫包含適用於 Remote MCP 與 OAuth 的 Agent Plugins plugin.json + mcp.json（可攜式），以及 .cursor-plugin/plugin.json（Cursor Marketplace 中繼資料／標誌）。請從 cursor.directory／Cursor Marketplace 提交或安裝，並在系統提示時登入。

若要進行本機測試，請將外掛檔案複製到 ~/.cursor/plugins/local/search1api (plugin.json、.cursor-plugin/、mcp.json、assets/)。請勿從該目錄外建立符號連結 — Cursor 會拒絕外部符號連結目標。

或手動設定：

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Antigravity

以 Antigravity 外掛方式安裝：antigravity-plugin/ 包含資訊清單、mcp_config.json（支援 OAuth 的 Remote MCP）、Search1API 技能和 Marketplace README。直接從 GitHub 安裝，然後在瀏覽器開啟時登入：

agy plugin install https://github.com/superagents-lab/search1api-mcp/tree/main/antigravity-plugin

若要進行本機測試，請從檢出目錄執行 agy plugin validate --strict ./antigravity-plugin 和 agy plugin install ./antigravity-plugin。

VS Code

{
  "servers": {
    "search1api": {
      "type": "http",
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http search1api https://mcp.search1api.com/mcp \
  --header "Authorization: Bearer YOUR_SEARCH1API_KEY"

Windsurf

{
  "mcpServers": {
    "search1api": {
      "serverUrl": "https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY"
    }
  }
}

Agent Skill

Agent Skill 已移至 search1api-cli。請使用以下指令安裝：

npm install -g search1api-cli
npx skills add superagents-lab/search1api-cli

本機模式（stdio）

若要在本機執行伺服器，請使用 Node.js 20 或更新版本搭配 npx — 無需複製儲存庫：

{
  "mcpServers": {
    "search1api": {
      "command": "npx",
      "args": ["-y", "search1api-mcp"],
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY"
      }
    }
  }
}

若要在 Proxy 後方部署自架 HTTP 服務，請將所有可連線至 Node.js 程序的內部主機名稱加入以逗號分隔的 MCP_ALLOWED_HOSTS 環境變數。預設允許 mcp.search1api.com 和 localhost 位址。使用瀏覽器的用戶端若會傳送 Origin 標頭，也必須將其信任的來源主機名稱加入以逗號分隔的 MCP_ALLOWED_ORIGINS 變數。伺服器端 MCP 用戶端通常不會傳送 Origin，因此不需要新增項目。

工具

search

使用 Search1API 搜尋網頁。結果包含可引用的 id/title/url 結構。需要完整頁面時，請將結果 URL 傳給 crawl。

參數	必填	預設值	說明
`query`	是	-	搜尋查詢
`max_results`	否	10	結果數量
`search_service`	否	google	google、bing、bingcn、duckduckgo、yahoo、yandex、x、reddit、github、youtube、arxiv、wechat、bilibili、imdb、wikipedia、grokipedia
`page`	否	1	結果頁面（1-100）；只有 bing、bingcn、baidu 和 grokipedia 支援分頁
`crawl_results`	否	0	擷取完整內容的前幾筆結果數量；每次成功擷取會在基本的 1 點搜尋請求上額外增加 1 點
`include_sites`	否	[]	要納入的網站
`exclude_sites`	否	[]	要排除的網站
`time_range`	否	-	day、week、month、year

當搜尋引擎提供 published_date 時，結果會將其放在 metadata 中；github 結果則會額外包含 kind、stars、language 和 num_comments。

news

搜尋新聞文章。hackernews 結果會連結至討論串，並在 metadata 中加入 story_url、points 和 num_comments。

參數	必填	預設值	說明
`query`	是	-	搜尋查詢
`max_results`	否	10	結果數量
`search_service`	否	bing	google、bing、duckduckgo、yahoo、hackernews
`crawl_results`	否	0	擷取完整內容的前幾筆結果數量；每次成功擷取會在基本的 1 點新聞請求上額外增加 1 點
`include_sites`	否	[]	要納入的網站
`exclude_sites`	否	[]	要排除的網站
`time_range`	否	-	day、week、month、year

crawl

從 URL 擷取內容。

參數	必填	說明
`url`	是	要擷取的 URL

sitemap

取得 URL 中所有相關連結。

參數	必填	說明
`url`	是	要取得網站地圖的 URL

參數	必填	預設值	說明
`search_service`	是	-	github、hackernews
`max_results`	否	10	項目數量

ask

代理式搜尋：以自然語言描述需求，Search1API 會選取最多五個搜尋引擎和一個時間範圍，排除不相關結果，並傳回最多 10 筆依相關性排序且可引用的結果。結果也會包含 intent（使用的關鍵字、搜尋引擎和時間範圍）以及 errors（其他搜尋引擎完成時發生故障的搜尋引擎）。每次完成的請求需 5 點；若已知道要使用的搜尋引擎，請改用 search。

參數	必填	說明
`query`	是	以自然語言提出的請求，最多 500 個字元

maps

在 Google Maps 上尋找當地商家和地點。每頁最多傳回 20 個地點，並以可引用的結果呈現：title 是地點名稱，url 是其 Google Maps 連結，而 metadata 則會在可用時包含地址、電話、網站、類別、評分、評論數、座標、營業時間、營業狀態和價格範圍。每頁需 3 點，不論頁面包含多少地點。

參數	必填	預設值	說明
`query`	是	-	要尋找的項目，例如「咖啡店」或「奧斯汀的牙醫」
`country`	否	us	兩字母國家代碼
`language`	否	en	結果語言，例如 en、de 或 zh-CN
`location`	否	-	`{ latitude, longitude, zoom? }`，用於搜尋某個點周圍的地點；第 2 頁及之後的頁面必填
`page`	否	1	Google Maps 頁面，1-6；每頁都是獨立呼叫
`max_results`	否	20	要從該頁傳回的地點數量（1-20）；減少地點數量不會降低價格

deepcrawl

在單一工作中讀取同一網站的多個頁面，例如文件區段。透過網站地圖找出網站 URL，保留符合路徑規則的 URL，並以可引用的結果傳回最多 max_pages 個頁面：title、url，以及位於 text 的頁面 Markdown。結果也會包含 stats（已探索、符合、略過、已擷取、失敗）、failed（無法讀取的 URL 及原因）、API message，以及 result_url，這是一個包含所有頁面完整內容的 JSON 檔案。每個已啟動的工作需 20 點，不論讀取多少頁面。

此工具最多等待約 45 秒。如果擷取仍在執行，工具會傳回 status: "running" 和 task_id；請再次使用該 task_id 呼叫 deepcrawl 以取得頁面，這不收費，也不會啟動新的擷取工作。每頁文字上限為 8,000 個字元，總計上限為 80,000 個字元；遭截短的頁面會包含 metadata.truncated: true，而 result_url 則包含完整文字。

參數	必填	預設值	說明
`url`	是，除非提供 `task_id`	-	要擷取的網站或區段，例如 `https://example.com/docs/`
`max_pages`	否	10	要讀取的頁面數上限（1-50），依套用路徑規則後的探索順序排列；頁數不影響價格
`include_paths`	否	-	最多 20 條要保留的 URL 路徑規則。若未提供 ``，規則會在路徑區段邊界上比對路徑前綴（`/docs` 符合 `/docs/api`，但不符合 `/docsearch`）；若提供 ``，則必須符合完整路徑，而 `*` 也會符合 `/`
`exclude_paths`	否	-	最多 20 條要略過的路徑規則，語法相同；排除規則優先
`type`	否	sitemap	`sitemap` 使用網站的網站地圖；若沒有網站地圖，則使用起始頁面的連結；`all` 使用從起始 URL 探索到的所有連結
`task_id`	否	-	仍在執行中的擷取工作之 `task_id`；僅檢查其狀態，其他參數會被忽略

send_feedback

向 Search1API 團隊回報錯誤、空白或不完整的結果、無法解決的錯誤、與實際行為不符的文件，或缺少的功能。免費，不會消耗點數。伺服器具有 Search1API 憑證時，回報會連結至該帳戶，方便團隊後續聯絡。請勿包含憑證或私人資料。

參數	必填	說明
`message`	是	發生的問題或缺少的內容，最多 4000 個字元
`intent`	否	您嘗試完成的目標
`category`	否	bug、feature_request、docs、other
`request_id`	否	發生問題的呼叫請求 ID
`model`	否	您的模型名稱

版本歷史

v0.11.0：新增 deepcrawl 工具，可在單一任務中讀取同一網站最多 50 個頁面（每項任務 20 點；檢查執行中的任務免費）
v0.10.0：新增 maps 工具，用於 Google Maps 地點搜尋（每頁最多 20 個地點，每頁 3 點）
v0.7.0：新增 ask 工具，用於代理式搜尋。search 新增 bingcn、yandex 和 grokipedia 引擎，以及 page 參數；search 和 news 接受 time_range: "week"，並在結果 metadata 中傳遞 published_date、GitHub 和 Hacker News 欄位
v0.6.1：錯誤修正 — MCP 探索（initialize、tools/list、resources/*、prompts/list、server/discover）再次需要憑證。匿名提供此功能，會讓將「已列出工具」視為「已登入」的用戶端顯示已連線狀態，卻無法觸發 OAuth 流程；現在 401 挑戰會回應每個未經驗證的請求，讓 OAuth 登入在連線時恢復正常。透過靜態伺服器卡片和登錄中繼資料維持目錄可見性
v0.6.0：MCP 探索（initialize、tools/list、resources/*、prompts/list、server/discover）無需憑證即可使用，讓用戶端和目錄能在登入前列舉工具；工具呼叫仍需要 OAuth 或 API 金鑰。Stdio 模式在沒有 SEARCH1API_KEY 的情況下啟動並提供工具中繼資料，僅在呼叫時拒絕請求。格式錯誤的請求會以 JSON-RPC 回應，而非 HTML 錯誤頁面
v0.5.4：OAuth 簽發者移至 clerk.s1.dev，並可透過 OAUTH_AUTHORIZATION_SERVER 設定；MCP 伺服器卡片發布於 /.well-known/mcp/server-card.json；OAuth 探索文件現在會傳送快取標頭
v0.5.3：OAuth 資源和工具中繼資料不再需要 OIDC 工作階段範圍；新增 Smithery 和 Glama 登錄徽章
v0.5.2：MCP Origin 驗證現在會在請求解析和驗證之前執行；自架 HTTP 部署可透過 MCP_ALLOWED_ORIGINS 設定受信任的瀏覽器來源
v0.5.1：文件、LobeHub 資訊清單和 MCP Registry 中繼資料已同步；robots.txt 由傳輸主機提供
v0.5.0：支援 MCP 2026-07-28，並自動協商通訊協定；相容 2025 年 HTTP 用戶端的無狀態模式；請求層級驗證
v0.4.0：結構化輸出結構描述、OAuth 安全性方案、安全性註解，以及 Official MCP Registry 中繼資料
v0.3.1：支援 Remote MCP 的 OAuth 2.1；已移除退役的推理工具
v0.3.0：透過 Streamable HTTP 支援 Remote MCP；每個工作階段使用 API 金鑰驗證
v0.2.0：新增備援 .env 支援，以整合 LibreChat
v0.1.8：X (Twitter) 和 Reddit 搜尋服務
v0.1.7：GitHub 和 Hacker News 趨勢工具
v0.1.6：Wikipedia 搜尋服務
v0.1.5：新增搜尋參數和服務（arxiv、wechat、bilibili、imdb）
v0.1.3：新聞搜尋
v0.1.2：Sitemap
v0.1.1：網頁爬取
v0.1.0：初始版本

授權條款

MIT

UI 與第三方致謝

render_results MCP Apps 檢視畫面會以卡片顯示現有來源及其標題和網域。每個用戶端也會收到完整文字和結構化結果清單。此元件改編自 Swami Malode 的 Rare UI。其 MIT + Commons Clause + Attribution 條款重現於 THIRD_PARTY_NOTICES.md。

UI 設定、沙箱來源和發布檢查：MCP Apps UI。