Search1API

官方

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

GitHub
175
試用此 MCP贊助

你可以用 Search1API MCP 做什麼？

  • 具來源篩選的網路搜尋 — 透過 search 取得網路結果，可依網站縮小範圍、排除網域，或限制在過去一天／月／年內。
  • 新聞探索與全文檢索 — 使用 news 尋找近期文章，並可選擇爬取熱門結果以取得完整內容，而不僅是標題。
  • 頁面內容擷取 — 當搜尋摘要不足時，將任何 URL 傳給 crawl 以取得完整的可讀文字。
  • 網站結構探索 — 對某個網域呼叫 sitemap，以列舉所有相關連結並探索其頁面。
  • 熱門話題監控 — 查詢 trending 以取得 GitHub 或 Hacker News 上目前熱門的項目。

文件

Search1API MCP Server

smithery badge Glama

中文文档

Search1API 的官方 MCP 伺服器 — 在單一 API 中提供網頁搜尋、新聞、頁面擷取、Sitemap 探索與熱門話題。

驗證

  • 支援 OAuth 的用戶端可直接連線至 Remote MCP URL，然後在瀏覽器中登入並核准存取。
  • 現有整合可繼續使用 Search1API dashboard 中的 API 金鑰。
  • 每個 MCP 請求 — 包括工具探索（initialize、tools/list）— 都需要憑證。未驗證的請求會觸發 OAuth 挑戰，這是用戶端觸發登入的方式；連線前的檢查則由靜態的 server card 提供。

快速開始（Remote MCP）

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

驗證

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

方法格式
OAuth 2.1連線至 https://mcp.search1api.com/mcp 且不帶金鑰，並遵循用戶端登入流程
Authorization HeaderAuthorization: Bearer YOUR_SEARCH1API_KEY
URL Query Parameter（舊版）https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

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

Claude Desktop

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

Claude.ai（網頁版）

Settings > Connectors > Add custom connector：

https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Cursor

安裝為 Cursor 外掛（建議）：此儲存庫包含 Agent Plugins plugin.json + mcp.json（可攜式）和 .cursor-plugin/plugin.json（Cursor Marketplace 元資料 / 標誌），用於支援 OAuth 的 Remote MCP。從 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"
      }
    }
  }
}

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"
      }
    }
  }
}

對於在代理後方的自架 HTTP 部署，請將可達 Node.js 程序的所有內部主機名稱加入以逗號分隔的 MCP_ALLOWED_HOSTS 環境變數。mcp.search1api.com 和 localhost 位址預設允許。傳送 Origin header 的瀏覽器型用戶端，也必須將其信任的來源主機名稱加入以逗號分隔的 MCP_ALLOWED_ORIGINS 變數。來自伺服器端 MCP 用戶端的請求通常會省略 Origin，因此不需要加入項目。

工具

search

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

參數必填預設值說明
query是-搜尋查詢
max_results否10結果數量
search_service否googlegoogle、bing、duckduckgo、yahoo、x、reddit、github、youtube、arxiv、wechat、bilibili、imdb、wikipedia
crawl_results否0要爬取完整內容的頂部結果數量；每次成功爬取會在基礎 1 點搜尋請求上增加 1 點
include_sites否[]要包含的網站
exclude_sites否[]要排除的網站
time_range否-day、month、year

news

搜尋新聞文章。

參數必填預設值說明
query是-搜尋查詢
max_results否10結果數量
search_service否binggoogle、bing、duckduckgo、yahoo、hackernews
crawl_results否0要爬取完整內容的頂部結果數量；每次成功爬取會在基礎 1 點新聞請求上增加 1 點
include_sites否[]要包含的網站
exclude_sites否[]要排除的網站
time_range否-day、month、year

crawl

從 URL 擷取內容。

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

sitemap

從 URL 取得所有相關連結。

參數必填說明
url是要取得 sitemap 的 URL

trending

從熱門平台取得熱門話題。

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

版本歷史

  • v0.6.1：錯誤修正 — MCP 探索（initialize、tools/list、resources/*、prompts/list、server/discover）再次需要憑證。匿名提供此服務會讓將「工具已列出」等同於「已登入」的用戶端顯示已連線狀態，卻無法觸發 OAuth 流程；401 挑戰現在會回應每個未驗證的請求，在連線時恢復 OAuth 登入。目錄可見性透過靜態 server card 和註冊表元資料保持不變
  • v0.6.0：MCP 探索（initialize、tools/list、resources/*、prompts/list、server/discover）在無需憑證的情況下提供，以便用戶端和目錄可以在登入前列舉工具；工具呼叫仍需要 OAuth 或 API 金鑰。Stdio 模式在沒有 SEARCH1API_KEY 的情況下啟動並提供工具元資料，僅在呼叫時拒絕。格式錯誤的請求以 JSON-RPC 回應，而非 HTML 錯誤頁面
  • v0.5.4：OAuth issuer 移至 clerk.s1.dev，並可使用 OAUTH_AUTHORIZATION_SERVER 設定；MCP server card 發布於 /.well-known/mcp/server-card.json；OAuth 探索文件現在傳送 cache headers
  • v0.5.3：OAuth 資源和工具元資料不再需要 OIDC session scopes；新增 Smithery 和 Glama 註冊表徽章
  • v0.5.2：MCP Origin 驗證現在在請求解析和驗證之前執行；自架 HTTP 部署可使用 MCP_ALLOWED_ORIGINS 設定受信任的瀏覽器來源
  • v0.5.1：文件、LobeHub manifest 和 MCP Registry 元資料已同步；robots.txt 在傳輸主機上提供
  • v0.5.0：支援 MCP 2026-07-28 並自動協商協定；為 2025 時代的 HTTP 用戶端提供無狀態相容性；請求層級驗證
  • v0.4.0：結構化輸出 schema、OAuth 安全方案、安全註解和 Official MCP Registry 元資料
  • v0.3.1：支援 Remote MCP 的 OAuth 2.1；移除已淘汰的 reasoning 工具
  • v0.3.0：透過 Streamable HTTP 支援 Remote MCP；每 session API 金鑰驗證
  • v0.2.0：為 LibreChat 整合提供 fallback .env 支援
  • v0.1.8：X（Twitter）和 Reddit 搜尋服務
  • v0.1.7：GitHub 和 Hacker News 的 Trending 工具
  • 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