Back to Details

pp-hotel-goat

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/travel/hotel-goat/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See AGENTS.md "Generated artifacts: registry.json, cli-skills/". -->
<!-- 生成文件 — 请勿编辑。 此文件是library/travel/hotel-goat/SKILL.md的完全镜像， 由tools/generate-skills/在合并后重新生成。此处的手动编辑会在 下次重新生成时被静默覆盖。请改为编辑library/源文件。 请参阅AGENTS.md中的“生成产物：registry.json, cli-skills/”。 -->

Google Hotels — Printing Press CLI

Google Hotels — Printing Press CLI

Prerequisites: Install the CLI

前提条件：安装CLI

This skill drives the 
hotel-goat-pp-cli
binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
  1. Install via the Printing Press installer:
    bash
    npx -y @mvanhorn/printing-press-library install hotel-goat --cli-only
  2. Verify: 
    hotel-goat-pp-cli --version
  3. Ensure 
    $GOPATH/bin
    (or 
    $HOME/go/bin
    ) is on 
    $PATH
    .
If the 
npx
install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):
bash
go install github.com/mvanhorn/printing-press-library/library/travel/hotel-goat/cmd/hotel-goat-pp-cli@latest
If 
--version
reports "command not found" after install, the install step did not put the binary on 
$PATH
. Do not proceed with skill commands until verification succeeds.
hotel-goat fans out across two cash-price sources by default:
  • Google Hotels — scraped from the server-rendered page
  • Trivago — called via the public Trivago MCP server (no key); aggregates OTA rates from Booking.com, Expedia, Agoda, Hotels.com, Priceline, etc.
Control which sources run with 
--source google|trivago|both
on the 
hotels
command. Default is 
both
. Matched hotels (lat/lng within 250m and name token-overlap ≥ 0.5, with both sides carrying ≥2 informative tokens after stopword stripping) get a unified 
prices[]
array with one entry per source; Trivago-only properties are appended as standalone rows with 
property_token
prefixed 
trivago:
.
Trivago is geolocated server-side and returns EUR regardless of client hints. When the headline currency differs from Trivago's, each Trivago price is converted via the Frankfurter ECB FX endpoint (free, no key, 24h cache) so cross-source comparisons are apples-to-apples. Source label semantics:
  • trivago/<OTA> [EUR 802 -> USD]
    — FX conversion ran. The numeric 
    price
    field is in the target currency; the original EUR amount is in the label.
  • trivago/<OTA> [EUR]
    — FX lookup failed. The numeric 
    price
    is native EUR and the headline 
    price_per_night
    is NOT overridden.
  • trivago/<OTA>
    (no suffix) — currencies already matched.
v1 ships:
  • hotels <loc> <ci> <co>
    — multi-source search with brand / hotel-class / price / rating / amenity / 
    --source
    filters
  • dates <loc> --from --to --nights N
    — sweep a date window for the cheapest pair per stay
  • near "<address>" --radius Nmi
    — geo-radius around any address (auto-geocoded via OSM Nominatim)
  • hotel show/reviews <token>
    — single-property detail + reviews
  • wishlist add/list/remove <token>
    — local SQLite save
Brand-loyalty expansion, full month-window scans, price drift, multi-room family logic, and per-OTA breakdown are deferred to v0.2.
本Skill驱动
hotel-goat-pp-cli
二进制文件。在调用本Skill的任何命令之前，您必须确认CLI已安装。如果未安装，请先执行以下步骤：
  1. 通过Printing Press安装器安装：
    bash
    npx -y @mvanhorn/printing-press-library install hotel-goat --cli-only
  2. 验证安装：
    hotel-goat-pp-cli --version
  3. 确保
    $GOPATH/bin
    （或
    $HOME/go/bin
    ）已添加到
    $PATH
    环境变量中。
如果
npx
安装失败（无Node环境、离线等），可回退到直接通过Go安装（要求Go 1.26.3或更高版本）：
bash
go install github.com/mvanhorn/printing-press-library/library/travel/hotel-goat/cmd/hotel-goat-pp-cli@latest
如果安装后执行
--version
提示“command not found”，说明安装步骤未将二进制文件添加到
$PATH
中。请在验证成功前不要执行Skill命令。
hotel-goat默认从两个现金价格数据源获取信息：
  • Google Hotels — 从服务器渲染页面抓取数据
  • Trivago — 通过公开的Trivago MCP服务器调用（无需密钥）；聚合来自Booking.com、Expedia、Agoda、Hotels.com、Priceline等OTA的价格
可在
hotels
命令中使用
--source google|trivago|both
参数控制使用哪些数据源。默认值为
both
。匹配的酒店（经纬度在250米范围内，名称词元重叠度≥0.5，且去除停用词后双方均包含≥2个有效词元）会生成统一的
prices[]
数组，每个数据源对应一个条目；仅Trivago有的酒店会作为独立行追加，其
property_token
前缀为
trivago:
。
Trivago基于服务器端地理位置返回欧元价格，不受客户端提示影响。当目标货币与Trivago的货币不同时，每个Trivago价格会通过Frankfurter ECB外汇端点（免费、无需密钥、缓存24小时）进行转换，确保跨数据源对比的一致性。来源标签语义说明：
  • trivago/<OTA> [EUR 802 -> USD]
    — 已执行外汇转换。数字
    price
    字段为目标货币；标签中显示原始欧元金额。
  • trivago/<OTA> [EUR]
    — 外汇查询失败。数字
    price
    为原生欧元金额，且标题
    price_per_night
    未被覆盖。
  • trivago/<OTA>
    （无后缀） — 货币已匹配。
v1版本包含以下功能：
  • hotels <loc> <ci> <co>
    — 多源搜索，支持品牌/酒店等级/价格/评分/设施/
    --source
    过滤
  • dates <loc> --from --to --nights N
    — 在日期窗口内查找每段住宿的最便宜日期组合
  • near "<address>" --radius Nmi
    — 围绕任意地址的地理半径搜索（通过OSM Nominatim自动地理编码）
  • hotel show/reviews <token>
    — 单酒店详情+评论
  • wishlist add/list/remove <token>
    — 本地SQLite存储心愿单
品牌忠诚度扩展、整月窗口扫描、价格波动、多房间家庭逻辑以及按OTA细分等功能将推迟到v0.2版本实现。

When to Use This CLI

何时使用此CLI

Reach for hotel-goat whenever a user needs to search hotels by location and date range, find the cheapest dates in a window, find hotels near a specific address, or save properties to a local wishlist. Pair it with flight-goat when composing an itinerary; both share the same flag and envelope shape so a future travel-pp-cli orchestrator is a thin merge layer. Skip it when the user wants to actually book (Google Hotels is metasearch — hotel-goat surfaces the OTA deep-link, then the user books on the OTA).
当用户需要按地点和日期范围搜索酒店、查找窗口内的最便宜日期、查找特定地址附近的酒店，或保存酒店到本地心愿单时，可使用hotel-goat。搭配flight-goat使用可组合行程；两者共享相同的标志和信封格式，未来的travel-pp-cli编排器只需简单合并即可。当用户需要实际预订时请跳过此工具（Google Hotels是元搜索引擎 — hotel-goat提供OTA深度链接，用户需在OTA平台完成预订）。

When Not to Use This CLI

何时不使用此CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.
请勿针对需要创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订、购买或更改远程状态的请求激活此CLI。本CLI仅提供用于查看、导出、同步和分析的只读命令。

Unique Capabilities

独特功能

These capabilities aren't available in any other tool for this API.
这些功能是其他同类API工具所不具备的。

Agent-native plumbing

Agent原生管道机制

  • hotels
     — Dotted-path selection through nested results.prices[], results.booking_urls, results.images[]. Returns only the fields the agent needs.
    Use when you need only a couple of fields per hotel rather than the full nested response.
    bash
    hotel-goat-pp-cli hotels "San Francisco" 2026-08-15 2026-08-17 --agent --select results.name,results.rating,results.price_per_night,results.booking_urls.primary
  • hotels
     — 通过嵌套路径选择results.prices[]、results.booking_urls、results.images[]中的数据。仅返回Agent所需的字段。
    当您只需要每个酒店的几个字段而非完整嵌套响应时使用此功能。
    bash
    hotel-goat-pp-cli hotels "San Francisco" 2026-08-15 2026-08-17 --agent --select results.name,results.rating,results.price_per_night,results.booking_urls.primary

Command Reference

命令参考

hotels — Hotel search results from Google Hotels for a location + date range
  • hotel-goat-pp-cli hotels
    — Search hotels by location and date range.
hotel — Single-property commands
  • hotel-goat-pp-cli hotel show <property-token>
    — Full property detail by Google's property_token
  • hotel-goat-pp-cli hotel reviews <property-token>
    — Review breakdown for one property
hotels — 根据地点+日期范围从Google Hotels获取酒店搜索结果
  • hotel-goat-pp-cli hotels
    — 按地点和日期范围搜索酒店。
hotel — 单酒店相关命令
  • hotel-goat-pp-cli hotel show <property-token>
    — 通过Google的property_token获取完整酒店详情
  • hotel-goat-pp-cli hotel reviews <property-token>
    — 获取单个酒店的评论细分

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
hotel-goat-pp-cli which "<capability in your own words>"
which
resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 
0
means at least one match; exit code 
2
means no confident match — fall back to 
--help
or use a narrower query.
当您知道要做什么但不知道对应命令时，可直接询问CLI：
bash
hotel-goat-pp-cli which "<用您自己的语言描述功能>"
which
命令会将自然语言功能查询解析为与此CLI精选功能索引匹配度最高的命令。退出码
0
表示至少有一个匹配项；退出码
2
表示无匹配项 — 请回退到
--help
或使用更精确的查询。

Recipes

使用示例

Filtered search with European currency

欧洲货币的过滤搜索

bash
hotel-goat-pp-cli hotels "Paris" 2026-07-20 2026-07-23 --currency EUR --hotel-class 4,5 --max-price 300 --sort cheapest
Premium 4-5 star hotels in Paris under €300/night, sorted cheapest.
bash
hotel-goat-pp-cli hotels "Paris" 2026-07-20 2026-07-23 --currency EUR --hotel-class 4,5 --max-price 300 --sort cheapest
巴黎地区每晚价格低于300欧元的4-5星级高端酒店，按价格从低到高排序。

Agent-friendly nested-field selection

Agent友好的嵌套字段选择

bash
hotel-goat-pp-cli hotels "San Francisco" 2026-08-15 2026-08-17 --agent --select results.name,results.rating,results.price_per_night,results.booking_urls.primary
Returns only the four fields the agent needs, not the full per-result payload.
bash
hotel-goat-pp-cli hotels "San Francisco" 2026-08-15 2026-08-17 --agent --select results.name,results.rating,results.price_per_night,results.booking_urls.primary
仅返回Agent所需的四个字段，而非完整的结果负载。

Property detail by token

通过token获取酒店详情

bash
hotel-goat-pp-cli hotel show <property-token>
Full property details (amenities, nearby places, full image gallery) from a property_token returned by the search.
bash
hotel-goat-pp-cli hotel show <property-token>
通过搜索返回的property_token获取完整酒店详情（设施、周边场所、完整图片库）。

Save and recall properties

保存和查看酒店

bash
hotel-goat-pp-cli wishlist add <property-token> && hotel-goat-pp-cli wishlist list
Local-SQLite wishlist: save properties from searches, list them later.
bash
hotel-goat-pp-cli wishlist add <property-token> && hotel-goat-pp-cli wishlist list
本地SQLite心愿单：保存搜索到的酒店，稍后查看。

Health check

健康检查

bash
hotel-goat-pp-cli doctor
Confirms network reachability to Google Hotels and that the parser still finds AF_initDataCallback blobs.
bash
hotel-goat-pp-cli doctor
确认可连接到Google Hotels，且解析器仍能找到AF_initDataCallback数据块。

Auth Setup

认证设置

No authentication required. Google Hotels SSR is publicly accessible. Set 
Accept-Language
via the system locale; pass 
--currency EUR
to get pricing in another currency.
Run 
hotel-goat-pp-cli doctor
to verify setup.
无需认证。Google Hotels SSR可公开访问。通过系统区域设置设置
Accept-Language
；使用
--currency EUR
参数获取其他货币的定价。
执行
hotel-goat-pp-cli doctor
验证设置。

Agent Mode

Agent模式

Add 
--agent
to any command. Expands to: 
--json --compact --no-input --no-color --yes
.
  • Pipeable — JSON on stdout, errors on stderr
  • Filterable — 
    --select
    keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
    bash
    hotel-goat-pp-cli hotels "San Francisco" 2026-08-15 2026-08-17 --agent --select results.name,results.price_per_night,results.booking_urls.primary
  • Previewable — 
    --dry-run
    shows the request without sending
  • Offline-friendly — sync/search commands can use the local SQLite store when available
  • Non-interactive — never prompts, every input is a flag
  • Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests
在任何命令后添加
--agent
参数。等效于：
--json --compact --no-input --no-color --yes
。
  • 可管道化 — 标准输出为JSON，错误信息输出到标准错误
  • 可过滤 — 
    --select
    参数保留字段子集。点路径可深入嵌套结构；数组会遍历每个元素。对于冗长的API，这是保持上下文简洁的关键：
    bash
    hotel-goat-pp-cli hotels "San Francisco" 2026-08-15 2026-08-17 --agent --select results.name,results.price_per_night,results.booking_urls.primary
  • 可预览 — 
    --dry-run
    参数显示请求但不发送
  • 离线友好 — 同步/搜索命令可在本地SQLite存储可用时使用该存储
  • 非交互式 — 从不提示，所有输入均为标志参数
  • 只读 — 请勿使用此CLI执行创建、更新、删除、发布、评论、点赞、邀请、下单、发送或其他变更状态的请求

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
Parse 
.results
for data and 
.meta.source
to know whether it's live or local. A human-readable 
N results (live)
summary is printed to stderr only when stdout is a terminal AND no machine-format flag (
--json
, 
--csv
, 
--compact
, 
--quiet
, 
--plain
, 
--select
) is set — piped/agent consumers and explicit-format runs get pure JSON on stdout.
从本地存储或API读取数据的命令会将输出包装在来源信封中：
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
解析
.results
获取数据，
.meta.source
可判断数据是实时还是本地的。仅当标准输出为终端且未设置机器格式标志（
--json
、
--csv
、
--compact
、
--quiet
、
--plain
、
--select
）时，才会将人类可读的
N results (live)
摘要输出到标准错误；管道/Agent消费者和显式格式运行时，标准输出仅为纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:
hotel-goat-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
hotel-goat-pp-cli feedback --stdin < notes.txt
hotel-goat-pp-cli feedback list --json --limit 10
Entries are stored locally at 
~/.hotel-goat-pp-cli/feedback.jsonl
. They are never POSTed unless 
HOTEL_GOAT_FEEDBACK_ENDPOINT
is set AND either 
--send
is passed or 
HOTEL_GOAT_FEEDBACK_AUTO_SEND=true
. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当您（或Agent）发现此CLI存在问题时，可记录反馈：
hotel-goat-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
hotel-goat-pp-cli feedback --stdin < notes.txt
hotel-goat-pp-cli feedback list --json --limit 10
反馈条目存储在本地
~/.hotel-goat-pp-cli/feedback.jsonl
文件中。除非设置了
HOTEL_GOAT_FEEDBACK_ENDPOINT
且传递了
--send
参数或设置
HOTEL_GOAT_FEEDBACK_AUTO_SEND=true
，否则反馈不会被POST发送。默认行为仅存储在本地。
请写下让您感到意外的内容，而非正式的错误报告。简短、具体、单行描述：这样的反馈更有价值。

Output Delivery

输出交付

Every command accepts 
--deliver <sink>
. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
SinkEffect
stdout
Default; write to stdout only
file:<path>
Atomically write output to 
<path>
(tmp + rename)
webhook:<url>
POST the output body to the URL (
application/json
or 
application/x-ndjson
when 
--compact
)
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
每个命令都支持
--deliver <sink>
参数。输出会除了标准输出外（或替代标准输出）发送到指定的sink，以便Agent无需手动管道即可路由命令结果。支持三种sink：
Sink效果
stdout
默认值；仅输出到标准输出
file:<path>
原子性地将输出写入
<path>
（先写入临时文件再重命名）
webhook:<url>
将输出体POST到指定URL（当使用
--compact
时为
application/json
或
application/x-ndjson
格式）
未知的协议会被拒绝，并返回结构化错误说明支持的协议集。Webhook失败时返回非零退出码，并将URL和HTTP状态记录到标准错误。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
hotel-goat-pp-cli profile save briefing --json
hotel-goat-pp-cli --profile briefing hotels "San Francisco" 2026-08-15 2026-08-17
hotel-goat-pp-cli profile list --json
hotel-goat-pp-cli profile show briefing
hotel-goat-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults. 
agent-context
lists all available profiles under 
available_profiles
so introspecting agents discover them at runtime.
配置文件是一组保存的标志值，可在多次调用中复用。当定时Agent每次运行都使用相同配置调用同一命令时，可使用此功能 — 即HeyGen的“Beacon”模式。
hotel-goat-pp-cli profile save briefing --json
hotel-goat-pp-cli --profile briefing hotels "San Francisco" 2026-08-15 2026-08-17
hotel-goat-pp-cli profile list --json
hotel-goat-pp-cli profile show briefing
hotel-goat-pp-cli profile delete briefing --yes
显式标志始终优先于配置文件值；配置文件值优先于默认值。
agent-context
会在
available_profiles
下列出所有可用配置文件，以便Agent在运行时发现它们。

Exit Codes

退出码

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error
代码含义
0成功
2使用错误（参数错误）
3资源未找到
5API错误（上游问题）
7速率限制（请等待后重试）
10配置错误

Argument Parsing

参数解析

Parse 
$ARGUMENTS
:
  1. Empty, 
    help
    , or 
    --help
     → show 
    hotel-goat-pp-cli --help
    output
  2. Starts with 
    install
     → ends with 
    mcp
    → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with 
    --agent
    )
解析
$ARGUMENTS
的规则：
  1. 为空、
    help
    或
    --help
     → 显示
    hotel-goat-pp-cli --help
    输出
  2. 以
    install
    开头     → 若以
    mcp
    结尾 → MCP安装；否则 → 参见上方前提条件部分
  3. 其他情况 → 直接使用（添加
    --agent
    参数执行CLI命令）

MCP Server Installation

MCP服务器安装

  1. Install the MCP server:
    bash
    go install github.com/mvanhorn/printing-press-library/library/travel/hotel-goat/cmd/hotel-goat-pp-mcp@latest
  2. Register with Claude Code:
    bash
    claude mcp add hotel-goat-pp-mcp -- hotel-goat-pp-mcp
  3. Verify: 
    claude mcp list
  1. 安装MCP服务器：
    bash
    go install github.com/mvanhorn/printing-press-library/library/travel/hotel-goat/cmd/hotel-goat-pp-mcp@latest
  2. 注册到Claude Code：
    bash
    claude mcp add hotel-goat-pp-mcp -- hotel-goat-pp-mcp
  3. 验证：
    claude mcp list

Direct Use

直接使用

  1. Check if installed: 
    which hotel-goat-pp-cli
    If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the 
    --agent
    flag:
    bash
    hotel-goat-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help: 
    hotel-goat-pp-cli <command> --help
    .
  1. 检查是否已安装：
    which hotel-goat-pp-cli
    若未找到，提供安装选项（参见顶部前提条件部分）。
  2. 将用户查询与上方独特功能和命令参考中的最佳命令匹配。
  3. 添加
    --agent
    参数执行：
    bash
    hotel-goat-pp-cli <command> [subcommand] [args] --agent
  4. 若存在歧义，查看子命令帮助：
    hotel-goat-pp-cli <command> --help
    。