google-hotels-bladebro
Search Google Hotels for live hotel prices, ratings, availability, amenities and provider options using Bladebro. Use for hotel searches, accommodation comparisons, neighborhood comparisons, hotel pri
SKILL.mdagents/defs/skills/google-hotels/SKILL.md
GitHubGoogle Hotels Search with Bladebro
Use Google Hotels through Bladebro. Prefer deterministic URL construction and Bladebro structured extraction over manually driving every widget.
Boundaries
- Research and compare only. Do not complete a booking or payment.
- During primary search, stay on Google Hotels.
- After results are presented, you may inspect a hotel's own website or a provider page when the user asks for a direct-price/provider comparison.
- Treat prices and availability as live, time-sensitive observations.
Session
Use a dedicated session/profile context. Bladebro daemon mode is preferred when available because Chrome state persists across commands.
Before first use in a workflow:
bladebro daemon >/dev/null 2>&1 || true
Fast path: location + dates
Google Hotels supports a compact URL with a protobuf/base64 ts date parameter. Generate it rather than clicking the date picker.
hotel_ts() {
local ci_y=$1 ci_m=$2 ci_d=$3 co_y=$4 co_m=$5 co_d=$6 nights=$7
local cyl=$(printf '%02x' $(( ($ci_y & 0x7f) | 0x80 )))
local cyh=$(printf '%02x' $(($ci_y >> 7)))
local col=$(printf '%02x' $(( ($co_y & 0x7f) | 0x80 )))
local coh=$(printf '%02x' $(($co_y >> 7)))
echo -n "08011a200a021a00121a12140a0708${cyl}${cyh}10$(printf '%02x' $ci_m)18$(printf '%02x' $ci_d)120708${col}${coh}10$(printf '%02x' $co_m)18$(printf '%02x' $co_d)18$(printf '%02x' $nights)32020801" \
| xxd -r -p | base64 | tr -d '\n='
}
Constraints: use this helper for years 2025–2030 and stays of 1–127 nights. If outside that range or if Google changes behavior, use the interactive fallback.
Build:
https://www.google.com/travel/search?q={URL_ENCODED_QUERY}&qs=CAE4AA&ts={TS_PARAM}&ap=MAE
Examples of query intent:
Hotels in Hell's Kitchen New YorkHotels near Eiffel Tower ParisHotel Hendricks New York
Navigate and inspect:
bladebro nav "$URL"
bladebro see extract auto --json
If extraction is incomplete:
bladebro see content --json
bladebro see model --json
Use bladebro act collect max=40 timeout=30 --json when the result list uses incremental/infinite loading.
Filters
When the user specifies stars, price, amenities, free cancellation, guest/room counts, or another filter that is not encoded in the URL:
bladebro see model --json- Identify controls by accessible label/text, not brittle CSS selectors.
- Use
bladebro act click text="...",bladebro act fill ..., or one batched call. - Prefer
bladebro act batch/bladebro runfor multi-step filters. - Read the returned delta; do not reflexively request a full page snapshot after every action.
Bladebro refs are designed to survive many re-renders; if a ref heals automatically, continue normally.
Result extraction
For each useful hotel capture when available:
- Hotel name
- star class
- guest rating + review count
- price/night
- total stay price
- currency
- provider/source
- neighborhood/location cue
- key amenities
- cancellation/breakfast notes when visible
Do not infer missing fields.
Specific-hotel drill-down
When the user wants one hotel:
- Search exact hotel name + city + dates.
- Open its result/detail panel.
- Extract available room/provider prices.
- Distinguish taxes/fees included vs excluded when Google shows that distinction.
- If asked, compare with the hotel's direct website in a separate tab.
Output
Default to 5–8 high-signal options, sorted according to the user's stated priorities. Use a compact table:
| Hotel | Rating | Price/night | Total | Why it fits |
|---|
Then give one recommendation and the main tradeoff.
Recovery
- Consent: follow the configured Bladebro consent policy; otherwise dismiss the banner.
- CAPTCHA/bot challenge: do not solve or bypass. Report the block.
View prices: dates likely failed; verify the URL/date state.- Wrong currency: note the displayed currency; do not silently convert unless requested.
- Map instead of list: switch to list view by visible text.
- Empty extraction: use
see content, thensee model, then interact explicitly.