HasData Google Hotels

Google Hotels MCP 服务

一个托管的模型上下文协议（MCP）服务，为 Claude、Cursor、Windsurf 及其他 MCP 客户端提供一个 Google Hotels 工具。按目的地和一组日期搜索酒店和度假租赁房源，然后查看任意房源的完整信息，包括所有预订网站的报价、评分、按主题划分的评论明细、设施、照片和坐标，全部以结构化 JSON 格式呈现，无需 Google 账号，也不受 Places API 配额限制。

每月 1,000 个免费额度，无需绑定银行卡，约可搜索 100 次酒店。

https://mcp.hasdata.com/mcp?apis=google_travel_hotels

• 提示词和资源

目录

• 所需条件
• 快速开始
• 示例提示词
• 工具
• 错误和失败路径
• 定价、免费套餐和限制
• 工具选择
• 对比
• 常见问题
• HasData 链接
• 开发
• 贡献
• 许可证

所需条件

一个 MCP 客户端，以及一个从控制面板获取的 HasData API 密钥；注册免费，无需绑定银行卡，免费套餐按每次调用 10 个额度计算，每月约可调用 100 次。这是一个远程服务，因此最简单的接入方式是使用 URL 和 x-api-key 请求头，无需运行容器，整个流程也不需要 Google Cloud 项目。仅支持 stdio 的客户端可通过一个轻量启动器连接该服务；启动器已发布到 npm，包名为 @hasdata/google-hotels-mcp，也发布到 PyPI，包名为 hasdata-google-hotels-mcp，如下所示。

快速开始

所有客户端使用相同的服务 URL。我们已在 Claude Code 和 Claude Desktop 中实际运行验证。其他配置块遵循各客户端为远程服务记录的格式。

支持 OAuth 的客户端可以将同一 URL 添加为连接器，然后登录，无需在配置文件中填写密钥。

claude mcp add --transport http google-hotels "https://mcp.hasdata.com/mcp?apis=google_travel_hotels" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "google-hotels": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-hotels-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-hotels": {
      "command": "uvx",
      "args": ["hasdata-google-hotels-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-hotels": {
      "url": "https://mcp.hasdata.com/mcp?apis=google_travel_hotels",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-hotels": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=google_travel_hotels",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "google-hotels": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=google_travel_hotels",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

提示词示例

使用提示词，而不是代码。粘贴一条提示词，Agent 就会自行选择工具。每条提示词都标注了所需调用次数，因为每次成功调用需消耗 10 个积分。

查找 11 月 12 日至 15 日在巴塞罗那入住的酒店，入住 2 位成人，并列出价格最低的 5 家，包含每晚价格、评分和等级。

一次调用，10 个积分。价格、评分和设施信息会一并返回。

同一行程，筛选四星及以上酒店，仅限免费取消，并按评分排序。

一次调用，10 个积分。等级、取消政策和排序方式都是同一请求中的筛选条件。

查看排名第一的结果，列出各预订网站对此酒店的报价，并判断价格是否划算。

两次调用，20 个积分。搜索结果会为每家酒店返回一个 propertyToken，传入该令牌即可打开对应酒店，查看 Google 对比的所有来源、典型价格范围以及 Google 对这笔交易的评价。

查找那一周在里斯本的度假租赁房源，至少有 2 间卧室和一个泳池。

一次调用，10 个积分，启用 vacationRentals，将 bedrooms 设为 2，并在 amenity__ 中设置泳池。

按你平时说话的方式写出目的地名称。单独的 Barcelona 会被理解为相对于 Google 认为搜索发起地的位置，因此位于加利福尼亚州的服务会返回加利福尼亚州的酒店。写成 hotels in Barcelona，或将 gl 设为 es，即可锁定这座城市。

工具

此工具为只读工具，涵盖网站的两个部分。不提供 propertyToken 时，它会执行搜索；提供时，它会打开单个酒店。

以下示例摘自真实调用，并经过精简。酒店价格每天都会变动，请将示例视为数据结构参考。

示例展示的是有效载荷，而非完整响应。tools/call 结果包含一个文本块，该文本本身是一个 JSON 对象，含有 url、status、text 和 json，抓取的数据位于 json 下。从原始 JSON-RPC 响应中获取数据时，路径为 result.content[0].text，解析后再访问 .json。聊天客户端会为你拆解这些内容，而直接与端点交互的代码不会。

搜索酒店和度假租赁

hasdata_google_travel_hotels_getGoogleHotels

查询目的地和住宿日期对应的房源，包括价格、评分、设施和图片。

结果位于 properties 下，每页大约 20 条。每个房源包含 name、type、description、link、gpsCoordinates、ratePerNight 和 totalRate（每项均包含原始字符串和 extracted* 数值）、hotelClass 及 extractedHotelClass、overallRating、reviews、locationRating、ratings 评分分布、reviewsBreakdown（按主题统计的正面和负面提及）、amenities、images，以及包含步行和公共交通时间的 nearbyPlaces。searchInformation.totalResults 表示 Google 找到的结果数量，pagination 包含 nextPageToken，而 brands 会列出品牌树及 brands 筛选器所需的 ID。

价格有两种报价方式。lowest 包含税费，beforeTaxesFees 不含税费，房源可能只提供其中一种。比较和排序前，请确保比较的是同类价格。

{
  "name": "Casa Gràcia",
  "propertyToken": "ChcI0r6-2uyF7rIuGgsvZy8xdmo2bnNxZhAB",
  "type": "hotel",
  "description": "Cozy quarters in a hip lodging with dining & a lively bar, plus a kitchen, a library & free Wi-Fi.",
  "link": "https://room00hostel.com/barcelona/casa-gracia-hostel/",
  "gpsCoordinates": { "latitude": 41.3974523, "longitude": 2.1593339 },
  "ratePerNight": { "beforeTaxesFees": "US$61", "extractedBeforeTaxesFees": 61 },
  "totalRate": { "beforeTaxesFees": "US$182", "extractedBeforeTaxesFees": 182 },
  "hotelClass": "4-star hotel",
  "extractedHotelClass": 4,
  "overallRating": 3.9,
  "reviews": 3811,
  "locationRating": "4.6",
  "amenities": ["Breakfast", "Air conditioning", "Airport shuttle", "Kid-friendly"],
  "nearbyPlaces": [
    { "name": "La Pedrera - Casa Milà", "transportations": [{ "type": "Walking", "duration": "5 min" }] }
  ]
}

单个房源的完整信息

将任意搜索结果中的 propertyToken 传回同一工具，并保留日期，返回的就是该房源的独立信息。在搜索字段的基础上，还会添加 prices（Google 比较的所有来源的价格）、featuredPrices（赞助商价格）、住宿期间的 typicalPriceRange，以及 Google 将价格标记为优惠时提供的 deal 和 dealDescription；此外还包括 address、phone、directions、按类别分组的 amenitiesDetailed、excludedAmenities，以及来自 Tripadvisor 等平台的 otherReviews。

{
  "prices": [
    {
      "source": "Booking.com",
      "numGuests": 2,
      "ratePerNight": { "lowest": "$61", "beforeTaxesFees": "$39", "extractedLowest": 61 }
    }
  ],
  "typicalPriceRange": { "lowest": "$51", "highest": "$68", "extractedLowest": 51, "extractedHighest": 68 },
  "deal": "34% less than usual",
  "dealDescription": "Great Deal",
  "address": "Pg. de Gràcia, 116Bis, Gràcia, 08008 Barcelona, Spain",
  "phone": "+34 931 74 05 28"
}

提示词和资源

服务提供 7 个资源，每个资源对应一个可接受值为固定列表的参数。读取资源比从失败的调用中学习相关词汇更省时，而且不消耗额度。每个 URI 的格式为 hasdata://google_travel/<parameter>。

无需 API 密钥即可获取此列表，因此客户端可以在用户注册前读取。

错误和失败路径

客户端几乎不会在工具调用中收到 HTTP 错误代码。MCP 层会返回 200，并将失败信息放入结果中，同时将 isError 设为 true，并以文本形式说明原因。Agent 读到的是一条消息，而不是你可能预期的状态行。

密钥错误会显示为工具输出，而不是连接失败。 tools/list 接受任意非空密钥并返回工具，因此客户端会完成握手并显示绿色状态。随后，首次工具调用会返回 isError: true，文本为 HasData API error: 401 Unauthorized。请留意这段字符串，因为流程中此前不会报告此问题。

缺少密钥是唯一真正的 HTTP 错误。 授权会在调用任何工具前执行，连接本身会以 401 失败。响应中包含 CORS 标头，因此浏览器客户端读取到的是状态码，而不是不透明的网络错误。

缺少日期会在请求成为搜索前被拒绝。 删除 checkOutDate 后，调用会因验证失败而返回 422，并指出该字段。

最危险的失败悄无声息，而且会把你带到错误的地理位置。 Google 无法定位的目的地，以及从错误国家／地区读取的城市名称，都会返回 200 和一整页位于其他地方的房源。我们搜索了 Qwertyville，结果却得到数据中心附近 18 家真实酒店，而请求正是从该数据中心发出的。请检查首条结果中的 gpsCoordinates，或传入 gl，再相信结果列表。

不合理的日期会被悄悄修正，而不是拒绝。 退房日期早于入住日期，或入住日期在 2020 年，仍会返回 200 和房源，因为 Google 会规范化日期范围，而不是报错。如果日期来自模型，请在你自己的端进行验证。

包含数据的结果也会附带一个 requestMetadata.id，可在联系支持时引用。

定价、免费额度和限制

每次成功调用 Google Hotels 均需 10 个积分。响应大小不会改变价格，打开一家酒店的费用与搜索相同。

免费额度为每月 1,000 个积分，无需绑定银行卡，约可进行 100 次搜索。额度会随计费周期续期，因此低用量的 Agent 可以无限期使用免费额度。

付费套餐起价为每月 $59，包含 200,000 个积分，即 20,000 次搜索，或每 1,000 次搜索 $2.95。用量越大，单价越低，最大套餐低至每 1,000 次 $0.83；按年付费时，支付十个月的月费即可使用十二个月。最新价格请查看定价页面。

套餐还决定并发数：免费套餐同时可处理 1 个请求，Startup 为 5 个，Basic 为 15 个，Growth 各套餐为 50 到 500 个。对于任何无人值守的应用，都应妥善处理超出并发限制的情况。

返回非 200 状态码的请求不会计费。搜索后打开酒店详情属于第二次调用，请预留相应额度。

工具选择

apis 查询参数决定 Agent 能看到哪些工具。工具越少，用于工具定义的上下文就越少，模型选错工具的机会也越少。

?apis=google_travel_hotels           the one tool in this repo
?apis=google_travel                  add Google Flights
?apis=google_travel_hotels,airbnb    hotels plus Airbnb stays
?apis=google_travel_hotels,booking   hotels plus Booking.com

该参数接受 google_travel 这样的提供方名称，也接受 google_travel_hotels 这样的单个 API 名称。拼错的名称会被忽略。如果所有名称都无效，请求会失败并返回 400，响应正文会列出无法识别的名称和所有有效值。省略该参数后，同一端点会公开所有 HasData 工具。

对比

Google 从未开放过公开的 Hotels API。Hotel Center 面向发布房价的酒店经营者，而 Places API 返回包含照片和评论的商家记录，但不提供日期范围内的房价。其他替代方案是各家预订网站提供的联盟 API，每种 API 只涵盖自身的库存，且都需要经过审批才能使用。

本服务不提供的功能。 不支持预订和付款。它会读取房价、所选日期的空房情况，以及 Google 自己指向的链接，然后将预订步骤交还给你。

常见问题

有官方的 Google Hotels API 吗？

没有。Google 为发布自有房价的酒店经营者提供 Hotel Center，并为商家记录提供 Places API，但两者都不会返回入住期间的费用。本服务会读取公开结果，并将其作为结构化 JSON 返回。

什么是 Google Hotels MCP 服务？

它是一项将 Google Hotels 作为工具公开、供 AI 客户端调用的服务。客户端通过 Model Context Protocol 发送工具调用，服务获取酒店信息并返回结构化 JSON，模型再根据结果开展工作。此服务仅公开一个工具，并以远程方式运行。

为什么搜索结果中会出现其他国家的酒店？

因为如果只输入地点名称，Google 会根据其对搜索发起地的判断来解析地点，而搜索发起地就是请求离开的数据中心。输入 hotels in Barcelona，而不是 Barcelona，或者将 gl 设为国家代码，即可固定目的地。

如何查看每家预订网站的收费？

先执行搜索，然后使用你关注酒店的 propertyToken 再次调用该工具。结果会包含 prices，其中每个来源各有一项；还会提供此次入住的 typicalPriceRange，以及房价异常低时 Google 给出的 deal 判定。

我可以搜索度假租赁房源吗？

可以。启用 vacationRentals 后，同一工具就会搜索租赁房源，此时 bedrooms 和 bathrooms 可用作筛选条件。

我可以将其与其他 HasData API 搭配使用吗？

可以。apis 参数接受一个列表，使用 ?apis=google_travel 可在酒店之外添加 Google Flights。省略该参数，即可获取所有内容。

合规与个人数据

HasData 仅访问公开可用的数据。平台条款可能会限制自动访问，您有责任确保自己的操作符合相关规定。

HasData 链接

开发

此仓库包含远程服务的配置和文档。无需构建，也无需容器化。

test/ 中的测试用于验证工具契约，也就是可能在未提交此仓库更改的情况下发生变化的部分。测试会检查 ?apis=google_travel_hotels 是否恰好返回一个工具、该工具是否仍声明了必需参数、名称是否未发生变化，以及实际使用的密钥是否确实有效。最后一项会实际调用工具，耗费 10 个积分；这是一次可能因正确原因而失败的金丝雀测试。

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

同一套测试会在每次推送时于 CI 中运行，并按计划每周运行一次，因为上游工具列表可能在无人改动此仓库的情况下发生变化。测试失败意味着工具列表发生了变化、密钥停止工作，或端点无法访问；断言消息会指出具体原因。

贡献

修正参数表和响应示例是最有价值的贡献，因为这些内容最容易过时。请附上您发出的调用和收到的响应。来自 Fork 的拉取请求会在不使用密钥的情况下运行测试套件；实时检查会跳过，而不会导致测试变红。

许可证

MIT。请参阅 LICENSE。