Google hotels compare

Skill stayingapi/google-hotels-skills/skills/google-hotels-compare

Compare one hotel across booking platforms via the Google Hotels backbone — every OTA rate plus a computed min and median. Use for "cheapest way to book this hotel". Powered by StayingAPI.From its SKILL.md

Install

npx -y skills add stayingapi/google-hotels-skills --skill google-hotels-compare

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT-0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.8 KB, 687 tokens by cl100k_base, as published. Nobody here has run it

Google Hotels cross-OTA comparison

The flagship Google Hotels use case: a normalized cross-OTA price comparison — every OTA rate for one property, plus a computed lowest and median.

Setup

If $STAYINGAPI_KEY is not set, read references/auth-setup.md and follow it to get and store the key. A stay_test_ sandbox key works for evaluation at zero cost.

When to use this skill

DO use when the user asks:

"What is the cheapest site to book this hotel?"
"Compare OTA rates for this property"

Do NOT use when:

You want a list of hotels — use google-hotels-search

Required headers

Every request needs:

Authorization: Bearer $STAYINGAPI_KEY
User-Agent: your agent's name (e.g. ClaudeCode/1.0).

Base URL: https://api.stayingapi.com/v1.

Tools

`GET /v1/price-compare`

Compare the price of one property across booking platforms in a single call, resolved through the Google Hotels backbone. The response carries the offers plus StayingAPI-computed min and median as first-class fields, so you can read the cheapest and typical cross-OTA price without re-deriving them. No cross-platform short-term-rental price-comparison API exists elsewhere — this is the wedge.

Key parameters:

name — Property name to resolve.
googleHotelId — Precise Google Hotels id.
location — Disambiguating place / "lat,lng".
checkIn — YYYY-MM-DD; not in the past.
checkOut — Must be after checkIn.
adults — ≥ 1.

MCP (no key pasted into the agent)

On an MCP-capable runtime, connect https://mcp.stayingapi.com/mcp (OAuth 2.1 + PKCE) and use: compare_prices.

The cross-OTA advantage

StayingAPI is cross-platform: Google Hotels data comes back in the same unified schema as Airbnb, Booking.com, Vrbo and Google Hotels, and the price-compare tool returns a computed min and median across every OTA — something a single-platform wrapper can't do.

Async & partial failures

A live call that has to scrape returns 202 + a jobId; poll GET /v1/jobs/{jobId} (free) until data.status is completed, then read data.result. On a fan-out, check meta.partial and meta.platformResults[].

Credits

Number-free by design — failed, empty and blocked calls are never billed, and stay_test_ sandbox calls are always free. Current costs: https://stayingapi.com/pricing · full contract: https://api.stayingapi.com/openapi.json.

Trademark

StayingAPI is an independent service and is not affiliated with, endorsed by, or sponsored by Google Hotels. Google Hotels is a trademark of its respective owner.

Get your free key → https://stayingapi.com/signup · Docs: https://stayingapi.com/docs

What ships with it: 1 file

1.9 KB alongside SKILL.md

references/

auth-setup.md1.9 KB