Searchapi MCP Nodejs

🚀 searchapi-mcp

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

npm install -g searchapi-mcp

💻 使用示例

基础用法

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

export SEARCHAPI_API_KEY="your_api_key"

高级用法

命令行使用

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

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

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

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

在 Claude Desktop 中使用

在 claude_desktop_config.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 Python 版本改编的 Node.js 实现。特别感谢 RmMargt 提供的原始 Python 实现和设计思路。

同时感谢：

• Model Context Protocol - 提供协议规范
• searchapi.io - 提供搜索服务 API

📄 许可证

MIT