概览
这份数据帮你把一个目的地的酒店供给一次性拉平铺开：同一个入住日期段下，都有哪些酒店在卖、卖多少钱、评分多少、是什么房型和配套。做比价或选品时，可以直接按价格排序看出价位带分布，按评分排序看出高口碑的集中在哪几家。
拿到的是每家酒店的概览记录，不是预订信息：价格是所选日期段的报价（含币种符号），评分同时带出评价条数，房型与设施则以多行文本列出卧室、床位、洗手间数量及空调、厨房、停车等配置。这些信息足以支撑「这家值不值得进一步看」的判断，但下单和实时房态需要另外去 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"] | 要采集的目的地或搜索词，可填多个。例如 Barcelona、Tokyo、上海。填得越具体（如 Barcelona Gothic Quarter）结果越精准。 |
| check_in_date | 开始时间 | string | 是 | 2026-10-01 | — | 2026-10-01 | 入住日期，格式 YYYY-MM-DD，例如 2026-10-01。 |
| check_out_date | 结束时间 | string | 是 | 2026-10-02 | — | 2026-10-02 | 退房日期，格式 YYYY-MM-DD，例如 2026-10-02。注意：模板内部按「结束时间前一天」计算实际展示的退房日。 |
| max_collected_rows | 最多采集条数 | integer | 否 | 100 | 1–100000 | 100 | 本次任务最多返回多少条酒店记录，用于控制采集规模与费用。 |
输出数据
单条记录的字段结构，与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| hotel_name | 酒店名称 | string | — | 酒店或民宿的名称。 |
| detail_url | 详情链接 | string | — | 酒店在 Google 上的详情页链接，可用于去重与进一步查看。 |
| price | 价格 | string | — | 该酒店在所选日期段的报价，含币种符号，例如 US$101。部分房源未展示报价，此时为空。 |
| rating | 评分 | string | — | 酒店评分及评价数量，例如 4.9 星（最高 5 星），根据 182 条评价得出。 |
| service | 房型与设施 | string | — | 房型类别、入住晚数、卧室/床位/洗手间数量及配套设施列表，多行文本以换行分隔。 |
记录 Schema
输出按记录逐条返回。记录主键为 detail_url，去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"hotel_name": {
"type": "string",
"title": "酒店名称",
"description": "酒店或民宿的名称。"
},
"detail_url": {
"type": "string",
"title": "详情链接",
"description": "酒店在 Google 上的详情页链接，可用于去重与进一步查看。"
},
"price": {
"type": "string",
"title": "价格",
"description": "该酒店在所选日期段的报价，含币种符号，例如 US$101。部分房源未展示报价，此时为空。"
},
"rating": {
"type": "string",
"title": "评分",
"description": "酒店评分及评价数量，例如 4.9 星（最高 5 星），根据 182 条评价得出。"
},
"service": {
"type": "string",
"title": "房型与设施",
"description": "房型类别、入住晚数、卧室/床位/洗手间数量及配套设施列表，多行文本以换行分隔。"
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入，各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证，凭证为 API Key（长期有效，在开放平台创建）；MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP（Model Context Protocol）协议，可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式，复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可，各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"SpiderNexus__google-hotels-barcelona": {
"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）。
价格
按实际成功返回的数据条数计费，任务失败不计费。
多个计费事件按各自口径独立累计，具体以每一项说明为准；任务失败不计费。
相关 Data Apps
把本 App 与下方推荐能力一键加入集合，生成可直接接入 AI 客户端的 MCP 配置。一键集合这些 App →
立即体验
填写参数直接运行，结果来自真实调用。