Search1API

官方

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

GitHub
174

你可以用 Search1API MCP 做什麼？

  • 帶來源篩選的網路搜尋 — 透過 search 要求網路搜尋，按網站、時間範圍或服務（如 Google、Reddit 或 arXiv）縮小結果範圍。
  • 新聞文章查詢 — 使用 news 在 Google、Bing、Hacker News 或 Yahoo 中尋找近期文章，可選擇排除特定網站。
  • 全頁內容提取 — 當搜尋摘要不足時，將任何 URL 傳遞給 crawl 以提取完整文字。
  • Sitemap 發現 — 在網域上呼叫 sitemap 以檢索所有相關連結，用於網站地圖或內容稽核。
  • 熱門話題 — 要求 trending 顯示來自 GitHub 或 Hacker News 的當前熱門項目。

文件

Search1API MCP Server

smithery badge Glama

中文文档

Search1API 的官方 MCP 伺服器 — 將網頁搜尋、新聞、頁面擷取、Sitemap 探索與熱門話題整合於單一 API。

驗證

  • 支援 OAuth 的用戶端可直接連線至 Remote MCP URL，然後在瀏覽器中登入並核准存取。
  • 既有整合可繼續使用 Search1API 儀表板 中的 API 金鑰。

快速開始（Remote MCP）

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

驗證

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

方法格式
OAuth 2.1無需金鑰即可連線至 https://mcp.search1api.com/mcp，並依照用戶端登入流程操作
Authorization 標頭Authorization: Bearer YOUR_SEARCH1API_KEY
URL 查詢參數（舊版）https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

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

Claude Desktop

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

Claude.ai（Web）

設定 > Connectors > 新增自訂連接器：

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 標頭的瀏覽器型用戶端，也必須將其信任的來源主機名稱加入以逗號分隔的 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.5.3：OAuth 資源與工具中繼資料不再需要 OIDC 工作階段範圍；新增 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；每工作階段 API 金鑰驗證
  • v0.2.0：為 LibreChat 整合提供 .env 後備支援
  • 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