Search1API

官方

一个用于搜索、抓取和站点地图的API

GitHub

175

试用此 MCP赞助

你可以用 Search1API MCP 做什么？

带来源过滤的网页搜索 — 通过 search 获取网页结果，可按站点筛选、排除域名，或将时间限制在过去一天/月/年。
新闻发现与全文检索 — 使用 news 查找近期文章，可选抓取热门结果以获取完整内容，而不仅仅是标题。
页面内容提取 — 当搜索摘要不够用时，将任意 URL 传给 crawl 以提取完整的可读文本。
站点结构探索 — 对某个域名调用 sitemap，枚举所有相关链接并发现其页面。
热门话题监控 — 查询 trending 获取 GitHub 或 Hacker News 上的当前热门内容。

文档

Search1API MCP 服务器

中文文档

Search1API 的官方 MCP 服务器——在一个 API 中提供网络搜索、新闻、网页抓取、站点地图发现和热门话题功能。

身份验证

支持 OAuth 的客户端可以直接连接远程 MCP URL，然后在浏览器中登录并批准访问。
现有集成可以继续使用 Search1API 控制台中的 API 密钥。
每个 MCP 请求——包括工具发现（initialize、tools/list）——都需要凭据。未认证的请求会触发 OAuth 挑战，客户端借此发起登录；连接前的检查由静态服务器卡片提供。

快速开始（远程 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

参数	必填	默认值	描述
`search_service`	是	-	github、hackernews
`max_results`	否	10	项目数量

版本历史

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 注册表元数据已同步；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

Search1API

你可以用 Search1API MCP 做什么？

文档

Search1API MCP 服务器

身份验证

快速开始（远程 MCP）

身份验证

Claude Desktop

Claude.ai（网页版）

Cursor

VS Code

Claude Code

Windsurf

Agent 技能

本地模式（stdio）

工具

search

news

crawl

sitemap

trending

版本历史

许可证