Searchapi MCP Nodejs

🚀 searchapi-mcp

searchapi.io API 用の Model Context Protocol (MCP) サーバーです。

searchapi-mcp は、Claude などの AI アシスタントが searchapi.io API にアクセスできるようにする Model Context Protocol (MCP) サーバーです。このツールを使用することで、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 マップ上のレビューデータを検索します。

# 必須パラメータ (どちらか1つ):
# - `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