# searchapi-mcp

Model Context Protocol (MCP) server for searchapi.io API

## 简介

`searchapi-mcp` 是一个 Model Context Protocol (MCP) 服务器，它为 Claude 等 AI 助手提供了访问 searchapi.io API 的能力。通过这个工具，AI 助手可以搜索 Google 地图、航班、酒店等信息。

## 功能

- 搜索 Google 地图上的地点或服务
- 搜索 Google 航班信息
- 搜索 Google 酒店信息
- 搜索 Google 地图评论
- 查询 Google 酒店详细信息
- 查询 Google 航班日历价格
- 获取当前系统时间和旅行日期建议
- 搜索 Google 搜索结果
- 搜索 Google 视频结果

## 安装

```bash
npm install -g searchapi-mcp
```

## 使用

### 环境变量

在使用之前，你需要设置 `SEARCHAPI_API_KEY` 环境变量：

```bash
export SEARCHAPI_API_KEY="your_api_key"
```

### 命令行使用

```bash
# 使用 stdio 传输启动服务器
searchapi-mcp

# 显示帮助信息
searchapi-mcp --help

# 显示版本信息
searchapi-mcp --version

# 指定传输类型
searchapi-mcp --transport stdio
```

### 在 Claude Desktop 中使用

在 `claude_desktop_config.json` 中添加以下配置：

```json
{
  "mcpServers": {
    "searchapi": {
      "command": "npx",
      "args": [
        "-y",
        "searchapi-mcp"
      ],
      "env": {
        "SEARCHAPI_API_KEY": "your_api_key",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}
```

## 工具函数

### search_google_maps

搜索 Google 地图上的地点或服务。

参数：
- `query`：搜索查询
- `location_ll`（可选）：位置坐标，格式为"纬度,经度"

### search_google_flights

搜索 Google 航班信息。

必填参数：
- `departure_id`：出发地 ID
- `arrival_id`：目的地 ID
- `outbound_date`：出发日期
- `flight_type`：航班类型（默认：round_trip）

对于往返航班（round_trip），还需要：
- `return_date`：返程日期

### search_google_hotels

搜索 Google 酒店信息。

必填参数：
- `q`：搜索查询
- `check_in_date`：入住日期
- `check_out_date`：退房日期

### search_google_maps_reviews

搜索 Google 地图上的评论数据。

必填参数（二选一）：
- `place_id`：地点 ID
- `data_id`：数据 ID

### search_google_hotels_property

查询 Google 酒店详细信息。

必填参数：
- `property_token`：物业令牌
- `check_in_date`：入住日期
- `check_out_date`：退房日期

### search_google_flights_calendar

查询 Google 航班日历价格。

必填参数：
- `flight_type`：航班类型
- `departure_id`：出发地 ID
- `arrival_id`：目的地 ID
- `outbound_date`：出发日期

对于往返航班（round_trip），还需要：
- `return_date`：返程日期

### get_current_time

获取当前系统时间和旅行日期建议。

参数：
- `format`（可选）：日期格式（默认：iso）
- `days_offset`（可选）：日期偏移量（默认：0）
- `return_future_dates`（可选）：是否返回未来日期（默认：false）
- `future_days`（可选）：未来天数（默认：7）

### search_google

搜索 Google 搜索结果。

必填参数：
- `q`：搜索查询

### search_google_videos

搜索 Google 视频结果。

必填参数：
- `q`：搜索查询

## 致谢

本项目是基于 [RmMargt/searchAPI-mcp](https://github.com/RmMargt/searchAPI-mcp) Python 版本改编的 Node.js 实现。特别感谢 RmMargt 提供的原始 Python 实现和设计思路。

同时感谢：
- Model Context Protocol - 提供协议规范
- searchapi.io - 提供搜索服务 API

## 许可证

MIT