内容
# 搜索1API MCP 服务器
[中文文档](./README_zh.md)
Search1API 的官方 MCP 服务器 - 一个 API 提供网页搜索、新闻、爬虫等功能。
## 获取您的 API 密钥
1. 在 [Search1API](https://www.search1api.com/?utm_source=mcp) 注册
2. 从仪表盘获取您的 API 密钥
## 快速开始（远程 MCP）
无需安装。只需使用远程 URL 和您的 API 密钥配置您的 MCP 客户端。
### 身份验证
支持两种方法 - 使用您的客户端支持的方法：
| 方法 | 格式 |
|--------|--------|
| 授权头 | `Authorization: Bearer 您的_SEARCH1API_KEY` |
| URL 查询参数 | `https://mcp.search1api.com/mcp?apiKey=您的_SEARCH1API_KEY` |
### Claude Desktop
```json
{
"mcpServers": {
"search1api": {
"url": "https://mcp.search1api.com/mcp",
"headers": {
"Authorization": "Bearer 您的_SEARCH1API_KEY"
}
}
}
}
```
### Claude.ai（网页）
设置 > 连接器 > 添加自定义连接器：
```
https://mcp.search1api.com/mcp?apiKey=您的_SEARCH1API_KEY
```
### Cursor
```json
{
"mcpServers": {
"search1api": {
"url": "https://mcp.search1api.com/mcp",
"headers": {
"Authorization": "Bearer 您的_SEARCH1API_KEY"
}
}
}
}
```
### VS Code
```json
{
"servers": {
"search1api": {
"type": "http",
"url": "https://mcp.search1api.com/mcp",
"headers": {
"Authorization": "Bearer 您的_SEARCH1API_KEY"
}
}
}
}
```
### Claude 代码
```bash
claude mcp add --transport http search1api https://mcp.search1api.com/mcp \
--header "Authorization: Bearer 您的_SEARCH1API_KEY"
```
### Windsurf
```json
{
"mcpServers": {
"search1api": {
"serverUrl": "https://mcp.search1api.com/mcp?apiKey=您的_SEARCH1API_KEY"
}
}
}
```
## 代理技能
代理技能已迁移到 [search1api-cli](https://github.com/fatwang2/search1api-cli)。使用以下命令安装：
```bash
npm install -g search1api-cli
npx skills add fatwang2/search1api-cli
```
## 本地模式（stdio）
如果您更喜欢在本地运行服务器，请使用 npx - 无需克隆：
```json
{
"mcpServers": {
"search1api": {
"command": "npx",
"args": ["-y", "search1api-mcp"],
"env": {
"SEARCH1API_KEY": "您的_SEARCH1API_KEY"
}
}
}
}
```
## 工具
### 搜索
使用 Search1API 搜索网页。
| 参数 | 是否必填 | 默认值 | 描述 |
|-----------|----------|---------|-------------|
| `query` | 是 | - | 搜索查询 |
| `max_results` | 否 | 10 | 结果数量 |
| `search_service` | 否 | google | google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia |
| `crawl_results` | 否 | 0 | 爬取结果数量 |
| `include_sites` | 否 | [] | 包含站点 |
| `exclude_sites` | 否 | [] | 排除站点 |
| `time_range` | 否 | - | day, month, year |
### 新闻
搜索新闻文章。
| 参数 | 是否必填 | 默认值 | 描述 |
|-----------|----------|---------|-------------|
| `query` | 是 | - | 搜索查询 |
| `max_results` | 否 | 10 | 结果数量 |
| `search_service` | 否 | bing | google, bing, duckduckgo, yahoo, hackernews |
| `crawl_results` | 否 | 0 | 爬取结果数量 |
| `include_sites` | 否 | [] | 包含站点 |
| `exclude_sites` | 否 | [] | 排除站点 |
| `time_range` | 否 | - | day, month, year |
### 爬取
从 URL 中提取内容。
| 参数 | 是否必填 | 描述 |
|-----------|----------|-------------|
| `url` | 是 | 要爬取的 URL |
### 站点地图
从 URL 获取所有相关链接。
| 参数 | 是否必填 | 描述 |
|-----------|----------|-------------|
| `url` | 是 | 获取站点地图的 URL |
### 推理
使用 DeepSeek R1 进行深度思考和复杂问题解决。
| 参数 | 是否必填 | 描述 |
|-----------|----------|-------------|
| `content` | 是 | 问题或题目 |
### 热门话题
获取热门平台的热门话题。
| 参数 | 是否必填 | 默认值 | 描述 |
|-----------|----------|---------|-------------|
| `search_service` | 是 | - | github, hackernews |
| `max_results` | 否 | 10 | 项目数量 |
## 版本历史
- 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.4: 使用 DeepSeek R1 的推理工具
- v0.1.3: 新闻搜索
- v0.1.2: 站点地图
- v0.1.1: 网页爬取
- v0.1.0: 初始发布
## 许可证
MIT
