logo

谷歌酒店搜索采集

输入谷歌酒店搜索页链接,采集搜索结果中的酒店列表(名称、价格、评分、标签、优惠、服务设施、图片等)

概览

输入谷歌酒店搜索页链接,采集搜索结果中的酒店列表(名称、价格、评分、标签、优惠、服务设施、图片等)。

输入参数

参数必填说明默认
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$1204.2Free Wi-Fi, Pool, Parking
Hilton Orlando$1854.5Free Wi-Fi, Gym, Pool, Restaurant

定价

按返回记录条数计费:0.0001 元/条(上游 ¥0.1/1,000 条)。

失败处理

  • 任务数据为异步获取:参数较大或数据量较大时,获取会耗时较长、结果无法及时返回,请耐心等待抓取完成。
  • 任务状态显示「运行中」表示仍在抓取数据,并不是异常,请不要重复提交相同任务。
  • 任务失败属可重试错误,可原样重新提交。

适用边界

单次任务对一个谷歌酒店搜索结果页采集酒店列表,条数上限默认 3 条、可上调(越大耗时与费用越高);数据为页面展示的搜索结果酒店信息。

  • 适合用于
  • 需要按目的地/日期查询谷歌酒店搜索结果,获取酒店价格与评分做比价时
  • 做出行规划或差旅安排,需要酒店名称、价格、评分、服务设施清单时
  • 做海外酒店行情调研,需要批量收集某地区的酒店列表与标签信息时
  • 不要用于
  • 需要酒店房型的实时可订库存与下单时——本 App 只覆盖搜索结果列表数据
  • 需要中文ota平台(如携程、美团)的酒店价格时——本 App 只覆盖 Google 酒店搜索数据源
  • 需要酒店详细政策(取消政策、入住须知等)时——本 App 只返回搜索页展示字段

失败处理

开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1任务数据为异步获取:参数较大或数据量较大时,获取会耗时较长、结果无法及时返回,请耐心等待抓取完成
  2. 2任务状态显示「运行中」表示仍在抓取数据,并不是异常,请不要重复提交相同任务
  3. 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否31–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标签1string—酒店标签信息一(如星级/类型标签)
label_2标签2string—酒店标签信息二(如优惠/推荐标签)
offer优惠信息string—酒店当前展示的优惠信息
services服务设施string—酒店提供的服务设施列表
image1图片1string—酒店图片链接一
image2图片2string—酒店图片链接二

记录 Schema

输出按记录逐条返回。记录主键为 hotel_details_url,去重、增量、关联以它为准。

output.schema
{
  "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 配置
{
  "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)。

价格

返回一条酒店搜索结果记录

按实际成功返回的数据条数计费,任务失败不计费。

¥0.0002/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
请先填写必填参数
¥0.0002 / 条