Search1API

Search1API MCP 服务器

中文文档

Search1API 的官方 MCP 服务器——集网页搜索、新闻、页面抓取、站点地图发现和热门话题于一个 API。

身份验证

• 支持 OAuth 的客户端可以直接连接远程 MCP URL，然后在浏览器中登录并批准访问。
• 现有集成可以继续使用 Search1API 控制台 中的 API 密钥。

快速开始（远程 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（网页版）

设置 > 连接器 > 添加自定义连接器：

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

Cursor

作为 Cursor 插件安装（推荐）：此仓库包含 Agent 插件 plugin.json + mcp.json（便携版）和 .cursor-plugin/plugin.json（Cursor Marketplace 元数据/徽标），用于支持 OAuth 的远程 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 技能

Agent 技能已移至 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	否	google	google、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	否	bing	google、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	是	要获取站点地图的 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 清单和 MCP 注册表元数据已同步；robots.txt 在传输主机上提供
• v0.5.0：支持 MCP 2026-07-28，具有自动协议协商功能；为 2025 时代的 HTTP 客户端提供无状态兼容性；请求级身份验证
• v0.4.0：结构化输出模式、OAuth 安全方案、安全注释和官方 MCP 注册表元数据
• v0.3.1：远程 MCP 支持 OAuth 2.1；移除了已停用的推理工具
• v0.3.0：通过 Streamable HTTP 支持远程 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：站点地图
• v0.1.1：网页抓取
• v0.1.0：初始版本

许可证

MIT