serpapi-hotels

SerpAPI ホテル MCP サーバー

SerpAPI API を通じて Google Hotels を検索する MCP サーバーです。日付範囲を指定してあらゆるエリアのホテルを検索し、価格、評価、レビュー、予約情報を取得できます。

ツール

ツール	説明
search_hotels	価格、評価、星のランク、設備などのフィルターを指定してホテルを検索します
get_hotel_details	特定のホテルについて、レビューの内訳や複数の予約サイトの価格など、詳細情報を取得します
get_hotel_reviews	個々の宿泊客のレビューを、全文、評価、サブ評価、ホテル運営者の返信とともに取得します

クイックスタート

Claude Desktop

以下を Claude Desktop の設定ファイルに追加します。

{
  "mcpServers": {
    "serpapi-hotels": {
      "command": "npx",
      "args": ["-y", "serpapi-hotels-mcp-server"],
      "env": {
        "SERPAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}

手動セットアップ

# Clone and install
cd experimental/serpapi-hotels
npm run install-all

# Set your API key
export SERPAPI_API_KEY=your_api_key_here

# Build and run
npm run build
cd local && npm start

設定

変数	必須	説明
SERPAPI_API_KEY	はい	SerpAPI API キー（こちらで取得）

使用例

ホテルを検索する

Search for hotels in New York for March 1-5, 2026, sorted by lowest price

search_hotels ツールは、次の値で呼び出されます。

• query：「Hotels in New York」
• check_in_date：「2026-03-01」
• check_out_date：「2026-03-05」
• sort_by：3

ホテルの詳細を取得する

ホテルを見つけたら、その property_token を使って get_hotel_details を呼び出すと、次の情報を取得できます。

• 複数の予約サイト（Booking.com、Hotels.com、Expedia など）の価格
• カテゴリー別のレビューの内訳（清潔さ、立地、サービス）
• 設備の全リスト
• チェックイン／チェックアウト時刻
• 所要時間付きの近隣スポット

ホテルのレビューを読む

ホテルを見つけたら、その property_token を使って get_hotel_reviews を呼び出すと、次の情報を取得できます。

• Google やサードパーティーのサイト（TripAdvisor など）のレビュー全文
• サブ評価（客室、サービス、立地）付きのレビュアー評価
• ホテル運営者の返信
• 参考になった順、新しい順、評価の高い順／低い順での並べ替え
• カテゴリーでの絞り込み（get_hotel_details のレビュー内訳を使用）

利用可能なフィルター

フィルター	値
sort_by	3 = 最安値、8 = 評価が最も高い、13 = レビュー数が最も多い
rating	7 = 3.5 以上、8 = 4.0 以上、9 = 4.5 以上
hotel_class	"2"、"3"、"4"、"5"（星の評価、カンマ区切り）
min_price / max_price	1 泊あたりの価格範囲
free_cancellation	true/false
special_offers	true/false
eco_certified	true/false
vacation_rentals	true = バケーションレンタルを検索

開発

npm run install-all    # Install all dependencies
npm run build          # Build the project
npm run dev            # Development mode
npm test               # Run functional tests
npm run test:integration  # Run integration tests
npm run test:manual    # Run manual tests (requires API key)

プロジェクト構成

serpapi-hotels/
├── local/              # Stdio transport entry point
│   └── src/
│       ├── index.ts                      # Main entry point
│       └── index.integration-with-mock.ts # Mock entry for integration tests
├── shared/             # Core business logic
│   └── src/
│       ├── server.ts         # MCP server factory
│       ├── tools.ts          # Tool registration
│       ├── resources.ts      # Resource handlers
│       ├── types.ts          # TypeScript types
│       ├── logging.ts        # Logging utilities
│       ├── tools/            # Individual tool implementations
│       │   ├── search-hotels.ts
│       │   ├── get-hotel-details.ts
│       │   └── get-hotel-reviews.ts
│       └── serpapi-client/   # SerpAPI client
│           ├── serpapi-client.integration-mock.ts
│           └── lib/
│               ├── parse-property.ts
│               ├── search-hotels.ts
│               ├── get-hotel-details.ts
│               └── get-hotel-reviews.ts
└── tests/
    ├── functional/       # Unit tests with mocks
    ├── integration/      # Full MCP protocol tests
    ├── manual/           # Real API tests
    └── mocks/            # Mock implementations