pp-hotelist

Hotelist — Printing Press CLI

前提条件：CLI をインストールする

このスキルは hotelist-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールします。

1. Printing Press インストーラーを使用してインストールします。バイナリの既定のインストール先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

   npx -y @mvanhorn/printing-press-library install hotelist --cli-only
   

2. 確認します：hotelist-pp-cli --version
3. 報告されたインストール先ディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールが失敗する場合（Node がない、オフラインなど）は、Go から直接インストールしてください（Go 1.26.6 以降が必要です）。インストール先は $GOPATH/bin（既定では $HOME/go/bin）なので、代わりにそのディレクトリを $PATH に追加してください。

go install github.com/mvanhorn/printing-press-library/library/travel/hotelist/cmd/hotelist-pp-cli@latest

インストール後に --version が「command not found」と報告する場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認が成功するまで、スキルのコマンドを実行しないでください。

Hotelist.com（@levelsio による）は、AI でホテルを評価します。実際の旅行者のレビューを読み、実際の客室写真を採点し、申告された設備を写真で検証するため、実際にウェイトのあるジムや、本当に設置されているバスタブを条件に絞り込めます。この CLI を使えば、--json／--select 出力、オフラインキャッシュ、さらに単一地図のウェブサイトでは表現できない複数地域にまたがるコマンド（rank-country、chain-compare、corridor、watch／diff による変化追跡）を通じて、そのデータをターミナルとエージェントのコンテキストで利用できます。データは Hotelist からスクレイピングされたものです（コミュニティ／AI による評価であり、公式 API ではありません）。

この CLI を使う場面

エージェントまたはユーザーが、支払いによる優遇のない、AI 評価・写真検証済みのホテル探しを求めている場合、特に複数地域にまたがる質問（国全体で最もお得なホテル、ホテルチェーン同士の比較、複数都市を巡るルート、または場所の経時的な変化の追跡）には、この CLI を使ってください。Hotelist の一都市ずつの地図ではできない、ホテルデータの集計や結合が必要な回答に適しています。

使用しない場面

以下の場合は、この CLI を使わないでください。

• ホテルの予約や、リアルタイムの空室状況の確認には使わないでください。Hotelist はホテルの検索に特化しており、予約機能や日付指定の料金情報はありません。
• 日付指定の1泊料金の見積もりには使わないでください。価格は AI が推定した平均値です。
• Booking.com／Expedia の汎用クライアントとして使わないでください。Hotelist の AI 評価データセットのみを公開しています。

独自の機能

この API を使う他のツールでは、以下の機能を利用できません。

地図の UI では表現できない、複数地域にまたがる価値の比較

• rank-country — Hotelist の評価額あたりの価格に基づいて、国全体の最良のホテルを順位付けします。複合的な設備条件と価格条件で絞り込めます。

  厳しい条件のもと、国全体で最もお得なホテルを1軒探す必要がある場合は、都市ごとに検索を繰り返す代わりにこちらを使ってください。

  hotelist-pp-cli rank-country thailand --min-rating 8 --max-price 150 --amenities pool,coworking --json
  

• chain-compare — 国内のホテルチェーンを、平均評価、価格の中央値、評価額あたりの価格で直接比較します。

  「ここでは実際にどのチェーンがお得か？」という問いに、地図の条件を何度も手動で調整するのではなく、1回の呼び出しで答えられます。

  hotelist-pp-cli chain-compare --chains marriott,hilton,hyatt --country japan --metric best-value --json
  

• corridor — 複数都市を巡るルートの各滞在地で、共通の条件を指定して最良のホテルを一度に見つけます。

  ノマドの年間ルートを1つのコマンドで計画できます。ユーザーが複数の都市を挙げた場合は、都市ごとに別々に検索する代わりにこちらを使ってください。

  hotelist-pp-cli corridor --cities "Chiang Mai,Lisbon,Medellin" --min-rating 7.5 --max-price 120 --amenities coworking --json
  

積み重なるローカル状態

• watch — 保存した場所のスナップショットを時系列で記録し、前回の確認時から改善、悪化、または価格が変わったホテルを比較します。

  「前回より、この都市のホテルは良くなった？それとも高くなった？」に答える唯一の方法です。時間の経過による変化について尋ねるときは、どんな場合でもこれを選んでください。

  hotelist-pp-cli watch diff lisbon --since 2026-01-01 --metric both --json
  

• chain-consistency — 国全体における特定チェーンの評価の平均値、中央値、ばらつきを計算し、そのブランドの品質が安定しているのか、外れ値が多いのかを確認します。

  慣れない地域でロイヤルティブランドを信頼する前に使ってください。単一の掲載情報ではわからない、隠れた外れ値のリスクを明らかにします。

  hotelist-pp-cli chain-consistency --chain marriott --country thailand --json
  

• price-cliff — 都市内で、追加の支出に対する評価の向上が急激に落ち込む価格帯を見つけ、品質をきちんと保てる最安のホテルを特定します。

  「品質を犠牲にせず、できるだけ安く泊まる」を、ひとつの数値と、その価格帯をわずかに下回るホテルで示します。

  hotelist-pp-cli price-cliff bangkok --min-rating 7 --json
  

コマンドリファレンス

hotel — Hotelist の AI 評価付きホテルを1件表示します。

• hotelist-pp-cli hotel <hotel_id> — 1件のホテルについて、生の詳細モーダル HTML を取得します（Hotelist スコア、検証済みのアメニティ、AI 評価の内訳）。

適切なコマンドを見つける

何をしたいかはわかっていても、どのコマンドを使えばよいかわからない場合は、CLI に直接尋ねてください。

hotelist-pp-cli which "<capability in your own words>"

which は、自然言語で記述された機能のクエリを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は少なくとも1件の一致があることを示し、終了コード 2 は確信を持てる一致がないことを示します。その場合は --help を使うか、より範囲を絞ったクエリを試してください。

レシピ

都市で本格的なジムを備えた、最もお得なホテルを探す

hotelist-pp-cli filter lisbon --gym-weights --json --select hotels.name,hotels.hotellist_rating,hotels.price

写真でウエイトトレーニング用ジムを確認し、名前、評価、価格だけに絞り込むことで、エージェントが全ペイロードを解析せずに済みます。

全国のお得度ランキング

hotelist-pp-cli rank-country thailand --min-rating 8 --max-price 150 --top 10 --json

1回の呼び出しで、国全体から価格あたりの評価が高いホテル上位10件を取得します。

予約を決める前にロイヤルティチェーンを比較する

hotelist-pp-cli chain-compare --chains marriott,hyatt --country japan --metric best-value --json

チェーンごとの平均評価、価格の中央値、お得度を直接比較します。

ノマドのルートを計画する

hotelist-pp-cli corridor --cities "Chiang Mai,Lisbon,Tbilisi" --min-rating 7.5 --max-price 120 --json

すべての条件を満たす、各立ち寄り先で最適なホテルを一度に探します。

1軒のホテルの AI 評価を詳しく調べる

hotelist-pp-cli show KYLCGAVE --json

Hotelist スコア、AI による写真とレビューの評価、総合評価、検証済みのアメニティ、長所と短所をすべて確認できます。

認証の設定

認証は不要です。

hotelist-pp-cli doctor を実行して、設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — JSON は標準出力、エラーは標準エラー出力に出力されます

• フィルタ可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列では各要素をたどります。情報量の多い API でコンテキストを小さく保つうえで重要です。

  hotelist-pp-cli hotel mock-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run で、送信せずにリクエストを表示します

• オフライン対応 — 同期／検索コマンドは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力をフラグで指定します

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票、招待、注文、送信、その他の変更を伴うリクエストには、この CLI を使用しないでください

レスポンスのエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を出所情報のエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データの取得には .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人が読める形式の N results (live) という概要が標準エラー出力に表示されるのは、標準出力が端末であり、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合のみです。パイプやエージェントで利用する場合、および形式を明示して実行した場合は、標準出力に JSON のみが出力されます。

エージェントからのフィードバック

あなた（またはエージェント）がこの CLI の気になる点に気付いたら、記録してください。

hotelist-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
hotelist-pp-cli feedback --stdin < notes.txt
hotelist-pp-cli feedback list --json --limit 10

記録はローカルの ~/.local/share/hotelist-pp-cli/feedback.jsonl に保存されます。HOTELIST_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されるか、HOTELIST_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトの動作はローカル保存のみです。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1行で。それが積み重なる情報です。

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は標準出力への出力に加えて（または標準出力への出力の代わりに）、指定した出力先に送られるため、エージェントはコマンド結果を手作業でパイプに渡さずに振り分けられます。サポートされている出力先は次の3つです。

出力先	動作
stdout	デフォルト。標準出力にのみ書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイルへの書き込み後にリネーム）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、サポート対象を示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードが返され、URL と HTTP ステータスが標準エラーに記録されます。

名前付きプロファイル

プロファイルは、コマンドの実行間で再利用されるフラグ値の保存セットです。スケジュールされたエージェントが毎回、同じ設定で同じコマンドを呼び出す場合に使用します。これは HeyGen の「Beacon」パターンです。

hotelist-pp-cli profile save briefing --json
hotelist-pp-cli --profile briefing hotel mock-value
hotelist-pp-cli profile list --json
hotelist-pp-cli profile show briefing
hotelist-pp-cli profile delete briefing --yes

明示的なフラグは常にプロファイル値より優先され、プロファイル値はデフォルト値より優先されます。agent-context は、実行時に情報を調べるエージェントがプロファイルを検出できるように、available_profiles の下に利用可能なすべてのプロファイルを一覧表示します。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が正しくありません）
3	リソースが見つかりません
5	API エラー（上流の問題）
7	レート制限中（待機して再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → hotelist-pp-cli --help の出力を表示します
2. install で始まる場合 → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の「前提条件」を参照してください
3. その他すべて → 直接使用（--agent を指定して CLI コマンドとして実行）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/travel/hotelist/cmd/hotelist-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add hotelist-pp-mcp -- hotelist-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストール済みか確認します：which hotelist-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある「前提条件」を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
3. --agent フラグを指定して実行します。

   hotelist-pp-cli <command> [subcommand] [args] --agent
   

4. あいまいな場合は、サブコマンドのヘルプを確認します：hotelist-pp-cli <command> --help。