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