概览
输入谷歌酒店搜索页链接,采集搜索结果中的酒店列表(名称、价格、评分、标签、优惠、服务设施、图片等)。
输入参数
| 参数 | 必填 | 说明 | 默认 |
|---|---|---|---|
| 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=目的地,含目的地/日期等参数的完整链接。一次任务填写一个搜索页链接示例https://www.google.com/travel/search?q=florida&ved=0CAAQ5JsGahgKEwiY1YXw8cGRAxUAAAAAHQAAAAAQsQU&ts=CAI&qs=CAE&ictx=3&ap=MAA - 采集条数上限
max_collected_rows选填integer本次任务采集的记录条数上限,默认 3 条。数值越大耗时和费用越高范围1–20000默认值3
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 搜索页链接
page_urlstring本次采集的谷歌酒店搜索页链接 - 筛选标签
tabstring搜索结果所属的筛选标签页(如酒店星级分类标签) - 结果总数
total_resultstring该搜索条件下的酒店结果总数 - 入住日期
date_fromstring搜索条件中的入住日期
调用方式
本 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=SpiderByte/google-hotel-search",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。