travel-hotel-research

旅行・ホテルのリサーチ

Crawlora API から正規化された JSON 形式で、7 つの旅行プラットフォームを横断してホテル、フライト、観光スポット、短期レンタル、ライブイベントを検索・比較できます。OTA の検索結果ページをスクレイピングする必要はありません。

このスキルを使う場面

• 「でに泊まれるホテルを探して」／OTA 間で料金を比較する。
• 「このホテル／観光スポットのレビューはどんな感じ？」
• 「からへのフライトを検索して。」
• 「にはどんな見どころがある？」（観光スポット／ツアー、またはコンサート／イベント）。
• 「このAirbnbのホスト／リスティングを調べて」（レビュー、カレンダー、その他のリスティング）。
• 「のでのチケット／イベントを探して」（Ticketmaster）。

セットアップ（一度だけ）

• https://crawlora.net で無料の Crawlora API キーを取得します（月 2,000 クレジット、カード不要）。
• ヘルパーを実行する前に、環境に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境から CRAWLORA_API_KEY を読み取り、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

仕組み

1. ホテル — /booking/search（パラメーター query、checkin、checkout）、/agoda/hotels/search、/tripcom/hotels/search（GET、都市名で検索）、または POST /expedia/properties/search（Expedia の宿泊施設 API は POST のみです。正確なリクエストボディのフィールド名は公開されていません。下記を参照）。詳細は /booking/hotel-detail、/agoda/hotels/{property_id}、POST /expedia/properties/detail で取得し、レビューは /booking/reviews、POST /expedia/properties/reviews で取得します。
2. フライト — /agoda/flights/search（GET）および POST /expedia/flights/search ／ /booking-flights/search。都市／空港コードを特定するため、先に各プラットフォームの .../autocomplete または .../search-locations エンドポイントを使います。
3. 観光スポット・アクティビティ — /booking-attractions/search、POST /expedia/activities/search、/agoda/activities/search、/tripadvisor/search（ホテル、レストラン、観光スポットをまとめて検索）。
4. TripAdvisor — /tripadvisor/autocomplete で場所を特定してから、プロフィールには /tripadvisor/place、旅行者のレビューには /tripadvisor/reviews を使います（ホテル、レストラン、観光スポットに対応）。
5. Airbnb — 宿泊先の検索には /airbnb/search、リスティングには /airbnb/room/{id}（さらに /calendar、/reviews）、ホストのプロフィールには /airbnb/host/{id}（さらに /listings、/reviews）を使います。
6. Ticketmaster — イベント検索には /ticketmaster/search-events（q）または /ticketmaster/discover-city-events（city）を使います。詳細は /ticketmaster/event、会場情報は /ticketmaster/venue（さらに /venue-events）、出演者／チームの全スケジュールは /ticketmaster/attraction（さらに /attraction-events）で取得します。

すべてのエンドポイント、メソッド、パラメーターの一覧は reference/endpoints.md を参照してください。

API の呼び出し

# Hotel search (GET):
scripts/crawlora.sh /booking/search query="Lisbon" checkin=2026-09-10 checkout=2026-09-14 | jq '.'
scripts/crawlora.sh /agoda/hotels/search city="Lisbon" | jq '.'

# Expedia (POST — exact body field names are unconfirmed, see Notes below):
scripts/crawlora.sh -X POST /expedia/properties/search '{"destination":"Lisbon","checkIn":"2026-09-10","checkOut":"2026-09-14"}' | jq '.'

# Airbnb:
scripts/crawlora.sh /airbnb/search location="Lisbon" | jq '.'
scripts/crawlora.sh /airbnb/room/12345678 | jq '.'

# Ticketmaster:
scripts/crawlora.sh /ticketmaster/search-events q="Coldplay" | jq '.'

すべてのリクエストには scripts/crawlora.sh を使います。これにより、コマンドライン引数に API キーを含めずに済みます。

エンドポイントリファレンス

このスキルで使う Booking、Expedia、Agoda、TripAdvisor、Trip.com、Airbnb、Ticketmaster の全エンドポイントについては、reference/endpoints.md を参照してください。

例

• OTA 間の料金比較： 同じ目的地と日程で /booking/search、/agoda/hotels/search、POST /expedia/properties/search を検索し、条件の近いホテルの1泊あたりの料金を比較します。
• 宿泊施設とホテルの比較： 同じ都市で /airbnb/search と /booking/search を使い、短期レンタルとホテルの料金を比較します。
• 旅行の計画： 都市の観光スポットを /tripadvisor/search で検索し、上位のいくつかについて /tripadvisor/reviews で最近の訪問者の評価を確認します。
• ホストの事前調査： 予約前に /airbnb/host/{id} と /airbnb/host/{id}/reviews を確認するか、/airbnb/host/{id}/listings でホストの全リスティングを確認します。

注意事項と制限

• クレジット／成功時課金： 2xx の場合にのみ課金されます。無料枠は月あたり2,000クレジットです。 キーは https://crawlora.net で取得してください。
• 公開データのみ — 公開されている検索／掲載／レビューのページが対象です。予約や支払いの操作は実行されません。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコード、クエリパラメーターへの記載、コミットは絶対に行わないでください。
• Expedia と一部の Agoda エンドポイントは JSON ボディを使う POST です — scripts/crawlora.sh を呼び出すときは -X POST を忘れないでください。Booking／Agoda／Trip.com／Airbnb／TripAdvisor のエンドポイントの大半は、クエリパラメーターを使う通常の GET です。
• Expedia の正確なリクエストボディのフィールド名は未確認です — ツールのスキーマで公開されているのは不透明な option オブジェクトのみです（目的地、日付、宿泊人数、フィルターを内部に指定する想定です）。また、実機テストでは {"option": {...}} でラップする形式と、いくつかの妥当と思われるフラットなフィールド名の候補（checkInDate／checkOutDate、checkIn／checkOut）はいずれも使えないことが確認されています。Expedia のエンドポイントを利用する前に、crawlora.net/docs またはプレイグラウンドで現在の形式を確認してください。このスキル内の他のエンドポイントはすべて実機で検証済みですが、Expedia の POST ボディ形式だけは例外です。
• ロケーション ID／都市 ID はプラットフォームごとに異なります。必ず、まず各プラットフォーム独自のオートコンプリート／ロケーション検索エンドポイントで解決してください。