Search1API MCP Server

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 Header	Authorization: Bearer YOUR_SEARCH1API_KEY
URL Query Parameter (legacy)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

优先使用 OAuth 或 Authorization Header。查询参数中的凭据可能会暴露在 URL、日志和 shell 历史记录中。

可选的搜索和新闻界面

远程 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 公开访问，无需身份验证，也不会重定向。服务卡片和注册表清单使用相同的图标。客户端可以自行决定是否显示该图标；它不会替代插件目录中单独存储的图标。

有关参数、限制和回退行为，请参阅渲染约定。从 0.8.0 版开始，npm 包包含此渲染器。更新现有安装并重启 MCP 连接；npx -y search1api-mcp@latest 会启动最新发布的包。

更改 URL 后，请重新连接或刷新连接器的工具定义；客户端可能会缓存这些定义。此 URL 设置仅适用于远程 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 插件（推荐）：此仓库包含用于 OAuth 远程 MCP 的 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"
      }
    }
  }
}

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	否	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

如果搜索引擎提供日期，结果会在 metadata 中包含 published_date；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

trending

获取热门平台上的趋势话题。

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

ask

智能体搜索：用自然语言描述需求，Search1API 会选择最多五个引擎和一个时间范围，剔除无关结果，并按相关性排序，最多返回 10 条可引用结果。结果还包含 intent（使用的关键词、引擎和时间范围）和 errors（其他引擎成功完成时发生故障的引擎）。每个成功完成的请求需花费 5 个积分；如果你已知道要使用哪个引擎，请使用 search。

参数	必填	描述
query	是	用自然语言描述请求，最多 500 个字符

send_feedback

向 Search1API 团队报告错误、空结果或不完整结果、无法解决的错误、与实际行为不符的文档，或缺失的功能。免费；不消耗积分。如果服务端已配置 Search1API 凭据，报告会关联到该账户，方便团队跟进。请勿包含凭据或私人数据。

参数	必填	描述
message	是	出现的问题或缺失的内容，最多 4000 个字符
intent	否	你尝试完成的目标
category	否	bug、feature_request、docs、other
request_id	否	出现问题的调用的请求 ID
model	否	你的模型名称

版本历史

• 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：为 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

UI 和第三方鸣谢

render_results MCP Apps 视图会将现有来源以卡片形式展示，并显示标题和域名。每个客户端也会收到完整文本和结构化结果列表。此组件改编自 Swami Malode 的 Rare UI。其 MIT + Commons Clause + Attribution 条款详见 THIRD_PARTY_NOTICES.md。

UI 设置、沙盒来源和发布检查：MCP Apps UI。