Agent skill

Google Hotels Search

by taracodlabs in taracodlabs/aiden

Searches Google Hotels through the agent-browser tool for prices, ratings, amenities and availability, building a search URL from the location and dates and reporting a results table.

AGPL-3.0Auto-check passedProductivity & Automation

Install Google Hotels Search

skills CLI
$ npx skills add taracodlabs/aiden --skill google-hotels -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install taracodlabs/aiden google-hotels --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/installed/google-hotels .claude/skills/google-hotels && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
google-hotels
GitHub stars
851
Token cost
~1.5k tokens
SKILL.md length
442 words
Files
1
Skills in repo
63
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Searches Google Hotels through the agent-browser tool for prices, ratings, amenities and availability, building a search URL from the location and dates and reporting a results table.

  • Comparing hotel prices and ratings in a city
  • SKILL.md covers When to Use, When NOT to Use, Session Convention and URL Fast Path (Preferred), plus 4 more sections
  • Reaches google.com and example-hotel.com
  • Finding the cheapest or best-rated hotel near a landmark

What it does

The skill drives a browser session named `hotels` with `agent-browser`. A fast path builds a Google Travel search URL with the location and, when dates are given, a protobuf-encoded `ts` parameter produced by a bash helper, then opens it, waits for the page to settle and reads a snapshot, in about three commands. Without dates the page shows starting-from prices. Locations can be a city, a neighborhood, a landmark or a specific hotel.

Results are presented as a table with hotel, stars, rating, price per night, total, the booking source and key amenities. The skill only searches: it never completes a purchase, does not cover vacation rentals, flights or historical prices, and must not leave Google Hotels for sites such as Booking.com or Expedia during a search. The date helper handles years 2025 to 2030. The skill is published under AGPL-3.0, and the excerpt is truncated.

When your agent uses it

  • Comparing hotel prices and ratings in a city
  • Finding the cheapest or best-rated hotel near a landmark
  • Checking hotel availability for specific dates

Example prompts

  • “Find hotels in Bangkok for March 15 to 20 and compare prices and ratings.”
  • “What are the best-rated hotels near the Eiffel Tower?”
  • “Show me the cheapest hotel in Shibuya, Tokyo.”

Requirements

  • The `agent-browser` CLI for browser automation
  • A bash shell to run the date-encoding helper
  • Pre-approved tools (allowed-tools): Bash(agent-browser:*), Bash(echo*), Bash(printf*)

What it can do on your machine

Read from SKILL.md and the folder at commit 3704204. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(agent-browser:*)
    • Bash(echo*)
    • Bash(printf*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • google.com
    • example-hotel.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Hotels Search loads about 1.5k tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 442 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~110
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from taracodlabs/aiden at commit 3704204, republished under its AGPL-3.0 licence (© taracodlabs). 442 words, ~1,484 tokens.

Download SKILL.mdSave it as .claude/skills/google-hotels/SKILL.md (or your agent's skills folder).
name
google-hotels
description
Search Google Hotels for hotel prices, ratings, and availability using browser automation. Use when user asks to search hotels, find accommodation, compare hotel prices, check availability, or look up places to stay. Triggers include "search hotels", "find hotels", "hotels in", "where to stay", "accommodation", "hotel prices", "cheapest hotel", "best hotel", "places to stay", "hotel near", "book a hotel", "hotel ratings".
allowed-tools
Bash(agent-browser:*), Bash(echo*), Bash(printf*)
category
travel
tags
hotels, booking, travel, accommodation, google-hotels, hotel-search, places-to-stay
enabled
true
source
github:skillhub/hotel-search
imported-from
github:skillhub/hotel-search

Search Google Hotels via agent-browser to find hotel prices, ratings, amenities, and availability.

When to Use

  • User asks to search, find, or compare hotels or accommodation
  • User wants hotel prices in a city, neighborhood, or near a landmark
  • User asks about hotel availability for specific dates
  • User wants the best-rated or cheapest hotel in an area

When NOT to Use

  • Booking: This skill searches only — never complete a purchase
  • Vacation rentals / Airbnb: Google Hotels shows hotels, not rentals
  • Flights: Use the google-flights skill
  • Historical prices: Google Hotels shows current prices only
  • NEVER leave Google Hotels during search — do not navigate to Booking.com, Expedia, Hotels.com, or any OTA as a search workaround. Exception: after results, you MAY visit a hotel's own website for direct booking/promo checks.

Session Convention

Always use --session hotels for isolation.

URL Fast Path (Preferred)

Build a URL with location and dates encoded. Loads results in 3 commands.

Encoding Dates in the URL

Google Hotels uses a protobuf-encoded ts parameter. Use this bash function to generate it:

bash
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='
}
# hotel_ts CHECKIN_YEAR MONTH DAY CHECKOUT_YEAR MONTH DAY NIGHTS
# hotel_ts 2026 3 15 2026 3 20 5  → CAEaIAoCGgASGhIUCgcI6g8QAxgPEgcI6g8QAxgUGAUyAggB

Years 2025-2030, months 1-12, days 1-31, nights 1-127.

Example: Hotels in Bangkok, March 15-20
bash
ts=$(hotel_ts 2026 3 15 2026 3 20 5)
agent-browser --session hotels open "https://www.google.com/travel/search?q=Hotels+in+Bangkok&qs=CAE4AA&ts=${ts}&ap=MAE"
agent-browser --session hotels wait --load networkidle
agent-browser --session hotels snapshot -i
agent-browser --session hotels close
Location Formats

City: Hotels+in+Bangkok | Neighborhood: Hotels+in+Shibuya+Tokyo | Near landmark: Hotels+near+Eiffel+Tower | Specific hotel: Haus+im+Tal+Munich

Without Dates

Omit ts, qs, ap parameters — shows "starting from" prices:

bash
agent-browser --session hotels open "https://www.google.com/travel/search?q=Hotels+in+Bangkok"
agent-browser --session hotels wait --load networkidle
agent-browser --session hotels snapshot -i

Result Format

| # | Hotel | Stars | Rating | Price/Night | Total | Via | Key Amenities |
|---|-------|-------|--------|-------------|-------|-----|---------------|
| 1 | Sukhothai Bangkok | ★★★★★ | 9.2 | $185 | $925 | Hotels.com | Pool, Spa, WiFi |
| 2 | Centara Grand | ★★★★★ | 8.8 | $165 | $825 | Booking.com | Pool, Gym, WiFi |
| 3 | Ibis Sukhumvit | ★★★ | 7.4 | $45 | $225 | Agoda | WiFi, Restaurant |

Key Rules

RuleWhy
Prefer URL fast path with ts=3 commands with dates vs 10+ interactive
wait --load networkidleSmarter than fixed wait 5000
Use fill not type for text inputsClears existing text first
Wait 2s after typing locationAutocomplete needs API roundtrip
Click suggestions, never EnterEnter is unreliable for autocomplete
Re-snapshot after every interactionDOM changes invalidate refs
Check for "View prices"Means dates aren't set yet
Never leave Google Hotels during searchOTA navigation during search breaks flow
Calendar navigation with "<" / ">"May open on wrong month — navigate and re-snapshot
Show full SKILL.md (137 more words)Show less

Troubleshooting

ProblemSolution
Consent popupClick "Accept all" or "Reject all"
URL fast path failsFall back to google.com/travel/hotels interactive flow
No results / "View prices"Set check-in and check-out dates interactively
Calendar on wrong monthUse "<" / ">" arrows; re-snapshot after navigating
Calendar overlay blocking snapshotPress Escape, re-snapshot, re-open date picker
CAPTCHAInform user. Do NOT solve. Retry after a short wait.
Map view instead of listClick "List" or "View list" toggle

Post-Search: Direct Booking Check

After presenting results, offer: "Want me to check [hotel]'s direct website for promo codes or member rates? Direct booking is often cheaper."

bash
agent-browser --session direct open "https://www.example-hotel.com"
agent-browser --session direct wait --load networkidle
agent-browser --session direct snapshot -i
agent-browser --session direct close

Look for: direct booking price (often 5-15% cheaper), promo banners, "Book Direct" incentives, loyalty member rates. For chain hotels (IHG, Marriott, Hilton, Accor, Hyatt), mention their loyalty programs.

For full interactive workflow (calendar navigation, guest/room selector, filters), see references/interaction-patterns.md.

© taracodlabs, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/installed/google-hotels of taracodlabs/aiden.

Open the folder on GitHubat commit 3704204

Compare with similar skills

Google Hotels Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Hotels Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Hotels Search this skilltaracodlabs/aiden851—~1.5kAutomated safety check: PassAGPL-3.0
Web Access via Browser CDPeze-is/web-access9.1k4 repos~2.2kAutomated safety check: PassMIT
Reddit JSON Fetcherykdojo/claude-code-tips10k—~1.4kAutomated safety check: PassCustom licence
Web Searchfreestylefly/wesight9441 repos~4kAutomated safety check: NotesMIT
Ego Browser Searchtaxueseek/argo186—~2.1kAutomated safety check: PassMIT
Browser Actitwanger/toBeBetterJavaer18k2 repos~932Automated safety check: PassNone

Similar skills

  • Routes every web task, from searching to logged-in browsing, through a tiered choice of search, fetch, curl or a real Chrome or Edge session driven over CDP.

    9.1k GitHub starsUsed in 4 repos~2.2k tokens
    Productivity & AutomationAuto-check passed
  • Reddit JSON Fetcher

    ykdojo/claude-code-tips

    Fetches Reddit posts, threads and search results as JSON through a browser session, using a DuckDuckGo redirect to get past Reddit's automated-access block.

    10k GitHub stars~1.4k tokensUpdated 14 days ago
    Productivity & AutomationAuto-check passed
  • Web Search

    freestylefly/wesight

    Real-time web search using Playwright-controlled browser. An agent skill from freestylefly/wesight.

    944 GitHub starsUsed in 1 repo~4k tokens
    Productivity & AutomationAuto-check: notes
  • Ego Browser Search

    taxueseek/argo

    Searches and fetches pages through a real logged-in Chromium session when ordinary API or HTML retrieval cannot get past login walls, scripts or anti-bot checks.

    186 GitHub stars~2.1k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Browser Act

    itwanger/toBeBetterJavaer

    Browser automation CLI for AI agents. An agent skill from itwanger/toBeBetterJavaer.

    18k GitHub starsUsed in 2 repos~932 tokens
    Productivity & AutomationAuto-check passed
  • Web Research With curl

    laude-institute/headlong

    Looks things up online from the shell with curl: fetching pages, searching DuckDuckGo's HTML endpoint, stripping tags for readable text and pulling JSON APIs.

    1.2k GitHub stars~362 tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed

More from taracodlabs/aiden

All 63 skills in this repo
  • Google Flights Search

    taracodlabs/aiden

    Searches Google Flights for prices, schedules and availability through browser automation with URL-based queries, and stops short of booking.

    851 GitHub stars~1.5k tokensUpdated 26 days ago
    Auto-check passed
  • OpenAI Codex CLI Bridge

    taracodlabs/aiden

    Delegates code generation, editing and explanation tasks to the OpenAI Codex CLI, with commands for interactive, auto-edit, question-only and model-specific runs.

    851 GitHub starsUsed in 1 repo~826 tokens
    Auto-check passed
  • Generates dark-themed architecture, component, data-flow and network diagrams as self-contained HTML and SVG files that open in any browser.

    851 GitHub stars~1.3k tokensUpdated 26 days ago
    Auto-check passed
  • Aggregates holdings across Zerodha, Upstox and Angel One and normalizes order parameters into one format, with confirmation required before any routing.

    851 GitHub stars~1.1k tokensUpdated 26 days ago
    Auto-check passed
  • arXiv Paper Search

    taracodlabs/aiden

    Searches arXiv by keyword, category, author or paper ID through its public API and downloads PDFs, with no API key needed.

    851 GitHub stars~1k tokensUpdated 26 days ago
    Auto-check passed
  • ASCII Art Banners

    taracodlabs/aiden

    Produces ASCII text banners, cowsay-style speech bubbles and bordered boxes for terminal scripts, READMEs and CLI splash screens with pyfiglet, cowsay and boxes.

    851 GitHub stars~985 tokensUpdated 26 days ago
    Auto-check passed

Works with

Questions about Google Hotels Search

What does Google Hotels Search do?

Searches Google Hotels through the agent-browser tool for prices, ratings, amenities and availability, building a search URL from the location and dates and reporting a results table. The skill drives a browser session named `hotels` with `agent-browser`. A fast path builds a Google Travel search URL with the location and, when dates are given, a protobuf-encoded `ts` parameter produced by a bash helper, then opens it, waits for the page to settle and reads a snapshot, in about three commands.

When should I use Google Hotels Search?

Google Hotels Search fits situations like: comparing hotel prices and ratings in a city; finding the cheapest or best-rated hotel near a landmark; checking hotel availability for specific dates.

How do I install Google Hotels Search in Claude Code?

Run `npx skills add taracodlabs/aiden --skill google-hotels -a claude-code`. Or copy the skill folder (skills/installed/google-hotels in taracodlabs/aiden) into .claude/skills/google-hotels in your project. Claude Code loads it when a task matches its description.

How do I install Google Hotels Search in Codex?

Run `npx skills add taracodlabs/aiden --skill google-hotels -a codex`. Or copy the skill folder (skills/installed/google-hotels in taracodlabs/aiden) into .agents/skills/google-hotels in your project. Codex loads it when a task matches its description.

Can I use Google Hotels Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add taracodlabs/aiden --skill google-hotels -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-hotels, .gemini/skills/google-hotels, .github/skills/google-hotels and .opencode/skills/google-hotels in your project.

What does Google Hotels Search need to run?

SKILL.md names no scripts, command-line tools or credentials: Google Hotels Search is instructions for the agent only. Our summary lists: The `agent-browser` CLI for browser automation; A bash shell to run the date-encoding helper. Its frontmatter pre-approves these tools: Bash(agent-browser:*), Bash(echo*), Bash(printf*).

Does Google Hotels Search access the network?

SKILL.md names 2 domains. In commands or code: google.com and example-hotel.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Google Hotels Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Google Hotels Search use?

Google Hotels Search is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Hotels Search use?

About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Google Hotels Search?

Skills that share tags, products or a category with Google Hotels Search: Web Access via Browser CDP (eze-is/web-access, 9.1k stars), Reddit JSON Fetcher (ykdojo/claude-code-tips, 10k stars), Web Search (freestylefly/wesight, 944 stars) and Ego Browser Search (taxueseek/argo, 186 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Hotels Search?

taracodlabs (a GitHub organization) maintains it in taracodlabs/aiden, which has 851 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on September 13, 2026.

Source: taracodlabs/aiden on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.