概览
输入谷歌酒店搜索页链接,采集搜索结果中的酒店列表(名称、价格、评分、标签、优惠、服务设施、图片等)。
输入参数
| 参数 | 必填 | 说明 | 默认 |
|---|---|---|---|
| search_url | 是 | 谷歌酒店搜索结果页链接,含目的地/日期等参数的完整链接 | - |
| max_collected_rows | 否 | 采集条数上限 | 3 |
输出字段
| 字段 | 说明 |
|---|---|
| page_url | 搜索页链接 |
| tab | 筛选标签 |
| total_result | 结果总数 |
| date_from / date_to | 入住日期 / 退房日期 |
| hotel_name | 酒店名称 |
| hotel_details_url | 酒店详情链接(唯一标识) |
| price | 价格 |
| rating | 评分 |
| label_1 / label_2 | 标签信息 |
| offer | 优惠信息 |
| services | 服务设施 |
| image1 / image2 | 酒店图片链接 |
使用示例
采集佛罗里达目的地的谷歌酒店搜索结果,最多返回 3 条:
{
"search_url": "https://www.google.com/travel/search?q=florida&ved=0CAAQ5JsGahgKEwiY1YXw8cGRAxUAAAAAHQAAAAAQsQU&ts=CAI&qs=CAE&ictx=3&ap=MAA",
"max_collected_rows": 3
}
示例输出:
| 酒店名称 | 价格 | 评分 | 服务设施 |
|---|---|---|---|
| The Florida Hotel & Conference Center | $120 | 4.2 | Free Wi-Fi, Pool, Parking |
| Hilton Orlando | $185 | 4.5 | Free Wi-Fi, Gym, Pool, Restaurant |
定价
按返回记录条数计费:0.0001 元/条(上游 ¥0.1/1,000 条)。
失败处理
- 任务数据为异步获取:参数较大或数据量较大时,获取会耗时较长、结果无法及时返回,请耐心等待抓取完成。
- 任务状态显示「运行中」表示仍在抓取数据,并不是异常,请不要重复提交相同任务。
- 任务失败属可重试错误,可原样重新提交。
适用边界
单次任务对一个谷歌酒店搜索结果页采集酒店列表,条数上限默认 3 条、可上调(越大耗时与费用越高);数据为页面展示的搜索结果酒店信息。
- 适合用于
- 需要按目的地/日期查询谷歌酒店搜索结果,获取酒店价格与评分做比价时
- 做出行规划或差旅安排,需要酒店名称、价格、评分、服务设施清单时
- 做海外酒店行情调研,需要批量收集某地区的酒店列表与标签信息时
- 不要用于
- 需要酒店房型的实时可订库存与下单时——本 App 只覆盖搜索结果列表数据
- 需要中文ota平台(如携程、美团)的酒店价格时——本 App 只覆盖 Google 酒店搜索数据源
- 需要酒店详细政策(取消政策、入住须知等)时——本 App 只返回搜索页展示字段
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务数据为异步获取:参数较大或数据量较大时,获取会耗时较长、结果无法及时返回,请耐心等待抓取完成
- 2任务状态显示「运行中」表示仍在抓取数据,并不是异常,请不要重复提交相同任务
- 3任务失败属可重试错误,可原样重新提交
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| search_url | 谷歌酒店搜索页链接 | string | 是 | — | — | https://www.google.com/travel/search?q=florida&ved=0CAAQ5JsGahgKEwiY1YXw8cGRAxUAAAAAHQAAAAAQsQU&ts=CAI&qs=CAE&ictx=3&ap=MAA | 要采集的谷歌酒店搜索结果页链接,形如 https://www.google.com/travel/search?q=目的地,含目的地/日期等参数的完整链接。一次任务填写一个搜索页链接 |
| max_collected_rows | 采集条数上限 | integer | 否 | 3 | 1–20000 | — | 本次任务采集的记录条数上限,默认 3 条。数值越大耗时和费用越高 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| page_url | 搜索页链接 | string | — | 本次采集的谷歌酒店搜索页链接 |
| tab | 筛选标签 | string | — | 搜索结果所属的筛选标签页(如酒店星级分类标签) |
| total_result | 结果总数 | string | — | 该搜索条件下的酒店结果总数 |
| date_from | 入住日期 | string | — | 搜索条件中的入住日期 |
| date_to | 退房日期 | string | — | 搜索条件中的退房日期 |
| hotel_name | 酒店名称 | string | — | 酒店名称 |
| hotel_details_url | 酒店详情链接 | string | — | 酒店详情页链接,作为记录唯一标识 |
| price | 价格 | string | — | 酒店在搜索条件下的展示价格 |
| rating | 评分 | string | — | 酒店用户评分 |
| label_1 | 标签1 | string | — | 酒店标签信息一(如星级/类型标签) |
| label_2 | 标签2 | string | — | 酒店标签信息二(如优惠/推荐标签) |
| offer | 优惠信息 | string | — | 酒店当前展示的优惠信息 |
| services | 服务设施 | string | — | 酒店提供的服务设施列表 |
| image1 | 图片1 | string | — | 酒店图片链接一 |
| image2 | 图片2 | string | — | 酒店图片链接二 |
记录 Schema
输出按记录逐条返回。记录主键为 hotel_details_url,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"page_url": {
"type": "string",
"title": "搜索页链接",
"description": "本次采集的谷歌酒店搜索页链接"
},
"tab": {
"type": "string",
"title": "筛选标签",
"description": "搜索结果所属的筛选标签页(如酒店星级分类标签)"
},
"total_result": {
"type": "string",
"title": "结果总数",
"description": "该搜索条件下的酒店结果总数"
},
"date_from": {
"type": "string",
"title": "入住日期",
"description": "搜索条件中的入住日期"
},
"date_to": {
"type": "string",
"title": "退房日期",
"description": "搜索条件中的退房日期"
},
"hotel_name": {
"type": "string",
"title": "酒店名称",
"description": "酒店名称"
},
"hotel_details_url": {
"type": "string",
"title": "酒店详情链接",
"description": "酒店详情页链接,作为记录唯一标识"
},
"price": {
"type": "string",
"title": "价格",
"description": "酒店在搜索条件下的展示价格"
},
"rating": {
"type": "string",
"title": "评分",
"description": "酒店用户评分"
},
"label_1": {
"type": "string",
"title": "标签1",
"description": "酒店标签信息一(如星级/类型标签)"
},
"label_2": {
"type": "string",
"title": "标签2",
"description": "酒店标签信息二(如优惠/推荐标签)"
},
"offer": {
"type": "string",
"title": "优惠信息",
"description": "酒店当前展示的优惠信息"
},
"services": {
"type": "string",
"title": "服务设施",
"description": "酒店提供的服务设施列表"
},
"image1": {
"type": "string",
"title": "图片1",
"description": "酒店图片链接一"
},
"image2": {
"type": "string",
"title": "图片2",
"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": {
"SpiderByte__google-hotel-search": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderByte/google-hotel-search",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。