Rate Ranger

AI エージェント向け Rate Ranger

Rate Ranger は、ユーザーがホテルを予約した後の料金を確認し、再予約する価値があるほど料金が下がった場合にメールで知らせます。無料で、アカウントもアプリも不要です。

このリポジトリは、これをプログラムから実行するための公開仕様です。OpenAPI 仕様、MCP コネクターマニフェスト、実用例が含まれています。

• MCP コネクター： https://www.rateranger.io/api/mcp
• HTTP API： https://www.rateranger.io/api/agent/bookings
• ガイド： https://www.rateranger.io/for-agents/
• OpenAPI 3.1： openapi.json

ウェブフォームを操作しないでください

rateranger.io のフォームは CAPTCHA で保護されており、自動ブラウザーにはトークンが発行されません。アシスタントがすべての項目を正しく入力しても、最後の手順でクリックするものがなく、失敗します。代わりにコネクターまたは API を使用してください。

オプション 1：MCP コネクター

カスタムコネクターとして https://www.rateranger.io/api/mcp を追加してください。キーもアカウントも不要で、URL 以外の設定は必要ありません。

次の 2 つのツールを提供します。

ツール	機能
submit_hotel_booking	1 人の旅行者について、1～10 件の予約を登録します
check_hotel_booking	予約内容を取得します。確認済みかどうかも含まれます

ChatGPT（Developer Mode）、Claude Code、Cursor で動作します。OAuth が必要な claude.ai のカスタムコネクターとしては動作しません。サーバーを認証なしとして宣言する方法がないためです。

サーバーはプロトコルリビジョン 2026-07-28、2025-11-25、2025-06-18、2025-03-26 に対応しているため、現在のリクエストごとのメタデータ形式と、以前の initialize ハンドシェイクの両方を使用できます。

オプション 2：HTTP API

curl -X POST https://www.rateranger.io/api/agent/bookings \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "[email protected]",
    "agent": "my-assistant/1.0",
    "bookings": [{
      "hotel_name": "Novotel Bali Ubud Resort",
      "city": "Ubud",
      "country": "ID",
      "check_in_date": "2027-07-14",
      "check_out_date": "2027-07-17",
      "total_price": 742.50,
      "currency": "USD"
    }]
  }'

予約ごとの read_token を含む 202 Accepted を返します。

旅行者による確認が必要です。そのことを伝えてください。

送信に成功しても、監視は開始されません。 Rate Ranger は旅行者にリンクを 1 つメールで送信します。旅行者がリンクをクリックするまでは、料金の確認もアラートの送信も行われません。クリックされなかった場合、すべて 7 日後に削除されます。

そのため、予約が追跡されているとはユーザーに伝えないでください。受信トレイを確認するよう伝え、そのうえで、より確かなことを伝える前に check_hotel_booking または GET /api/agent/bookings/{token} で確認してください。旅行者が操作するまでは false である booking.confirmed を確認してください。

キーが不要なのはこのためです。このエンドポイントは呼び出し元からメールアドレスを受け取るため、送信だけでサービスが開始する仕組みであれば、誰でも、メールを希望していないアドレスを登録できてしまいます。確認手順があることで、オープン API を安全に公開できます。

country は必須で、重要です

ISO 3166-1 alpha-2 のコードを指定してください。例：JP や ID。ホテルを検索できる料金ソースは、この値によって決まります。値がない予約は適切に監視できないため、ウェブフォームでは任意項目として扱われていますが、ここでは必須です。

制限

	1 日あたり
匿名の呼び出し元（IP 単位）	50 件の予約
キーを使用する場合	100 件の予約
1 つのメールアドレス、1 人の呼び出し元から	3 件の予約
1 つのメールアドレス、すべての呼び出し元から	10 件の予約

さらに必要な場合は、キーについて [email protected] にお問い合わせください。

料金には小数点以下を含められます。整数に制限されるのはウェブフォームのみです。

エラー

すべてのエラーには、分岐処理に使える安定した code と、ログを読む人向けの message が含まれます。code を使って分岐してください。メッセージの文言は変更される場合があります。

コード	意味
invalid_email	有効なアドレスではありません
disposable_email	アラートを受信できない使い捨てメールプロバイダーです
invalid_token	署名の検証失敗、トークンの種類の誤り、または有効期限切れです
not_found	トークンは検証されましたが、一致する予約がありません
rate_limited	1 日あたりの上限に達しました

リクエストとレスポンスの形式の詳細は、openapi.json を参照してください。

サポート

[email protected]