travel-hotel-research

旅行与酒店调研

通过 Crawlora API，以标准化 JSON 格式搜索并比较七个旅行平台上的酒店、航班、景点、短租房源和现场活动——无需抓取 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 的 Stays 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 密钥不会出现在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的 Booking、 Expedia、Agoda、TripAdvisor、Trip.com、Airbnb 和 Ticketmaster 的所有端点。

示例

• 跨 OTA 比价： 在 /booking/search、/agoda/hotels/search 和 POST /expedia/properties/search 上搜索相同的目的地和日期， 然后比较条件相近酒店的每晚价格。
• 住宿对比酒店： 对同一城市使用 /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 因平台而异——请务必先使用相应平台自己的自动补全／地点搜索端点进行查询。