概览
这份数据帮你把一个目的地的酒店供给一次性拉平铺开:同一个入住日期段下,都有哪些酒店在卖、卖多少钱、评分多少、是什么房型和配套。做比价或选品时,可以直接按价格排序看出价位带分布,按评分排序看出高口碑的集中在哪几家。
拿到的是每家酒店的概览记录,不是预订信息:价格是所选日期段的报价(含币种符号),评分同时带出评价条数,房型与设施则以多行文本列出卧室、床位、洗手间数量及空调、厨房、停车等配置。这些信息足以支撑「这家值不值得进一步看」的判断,但下单和实时房态需要另外去 Google 酒店页面确认。
数据说明
每条记录对应一家酒店。价格含币种符号,例如 US$101,部分房源在搜索结果里未展示报价,这一列会是空的。评分格式为「X 星(最高 5 星),根据 N 条评价得出」,星级为一位小数,评价条数越多参考价值越高。房型与设施是多行文本,第一行通常是房型类别(如客舱、公寓、酒店),随后是入住晚数、卧室/床位/洗手间数量、面积,最后是一串配套设施。目的地和日期段相同的重复采集可能得到重叠酒店,可结合详情链接去重。
结果长什么样
| 酒店名称 | 价格 | 评分 | 房型与设施 |
|---|---|---|---|
| Blue Rose Cabins - Lovebirds Cabin | US$182 | 4.1 星(最高 5 星),根据 456 条评价得出 | 客舱 / 入住 2 晚 / 1 间卧室 / 1 个洗手间 / 1 张床 / 空调 / 供暖设施 / 热水浴缸 / 厨房 |
| Secluded 1940s Romantic Tiny House on the River | US$101 | 4.9 星(最高 5 星),根据 182 条评价得出 | 客舱 / 入住 2 晚 / 1 间卧室 / 2 个洗手间 / 1 张床 / 空调 / 供暖设施 / 厨房 / 微波炉 |
应用场景
- 酒店比价:按价格排序,快速看出同一目的地同一日期段的价位带与异常低价。
- 住宿选品与推荐:结合评分和设施筛选,为攻略、榜单或推荐清单挑出候选酒店。
- 旅游市场调研:对比多个目的地的酒店数量、价格中位数与评分分布,判断供给丰俭。
- 差旅预算参考:给某城市某个日期段做住宿成本估算,作为报价或预算依据。
适用边界
面向按目的地 + 入住/退房日期采集 Google 酒店搜索结果的场景;单次请求针对一个目的地,输出酒店的报价与评分概览,不包含房间实拍图片、用户评论文本或预订下单能力。
- 适合用于
- 需要批量了解某目的地的酒店供给与报价区间时
- 做酒店比价或住宿选品的市场调研时
- 为旅游内容、攻略或推荐清单收集酒店素材时
- 不要用于
- 需要酒店的用户评论原文时
- 需要预订、下单或查询实时房态时
- 需要按酒店名称反查、而非按目的地批量拉取时
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1部分数据异步返回,任务状态「运行中」表示仍在采集,并非异常
- 2结果为空时确认目的地关键词可正常搜索,或该目的地该日期段无可售房源
- 3价格列为空属正常,部分房源未展示报价;同一目的地重复执行可能得到重叠酒店,可结合详情链接去重
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 目的地
destinations必填array<string>要采集的目的地或搜索词,可填多个。例如 Barcelona、Tokyo、上海。填得越具体(如 Barcelona Gothic Quarter)结果越精准。示例["Barcelona"] - 开始时间
check_in_date必填string入住日期,格式 YYYY-MM-DD,例如 2026-10-01。默认值2026-10-01示例2026-10-01 - 结束时间
check_out_date必填string退房日期,格式 YYYY-MM-DD,例如 2026-10-02。注意:模板内部按「结束时间前一天」计算实际展示的退房日。默认值2026-10-02示例2026-10-02 - 最多采集条数
max_collected_rows选填integer本次任务最多返回多少条酒店记录,用于控制采集规模与费用。范围1–100000默认值100示例100
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 酒店名称
hotel_namestring酒店或民宿的名称。 - 详情链接
detail_urlstring酒店在 Google 上的详情页链接,可用于去重与进一步查看。 - 价格
pricestring该酒店在所选日期段的报价,含币种符号,例如 US$101。部分房源未展示报价,此时为空。 - 评分
ratingstring酒店评分及评价数量,例如 4.9 星(最高 5 星),根据 182 条评价得出。
调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderNexus/google-hotels-barcelona",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。