构建可预订酒店的AI代理
使用Model Context Protocol(MCP)将您的AI代理连接到全球250万家酒店和公寓。搜索免费,无需API key。通过简单的REST调用即可预订。
2.5M+
酒店与公寓
190+
国家
15
API工具
免费
搜索API
工作原理
从搜索到确认预订只需三步。您的AI代理以编程方式处理整个流程。
搜索酒店
使用search_location查找目的地,然后使用hotel_search获取可用房源。无需身份验证。可按价格、星级、设施和餐食类型筛选。获取酒店详情、照片和评价。
身份验证
使用电子邮件地址调用guest_login获取Bearer token。访客账户无需密码。使用该token进行所有预订操作。token是标准JWT,适用于已认证的API调用。
预订和支付
使用guest信息调用prepare_booking,然后通过create_checkout(Revolut)或confirm_booking(B2B信用额度)完成支付。客人将自动收到确认电子邮件。
可用工具
15个工具涵盖完整的酒店预订生命周期。公共工具无需身份验证。已认证工具需要从login或guest_login获取的Bearer token。
公共工具(无需认证)
search_location
按名称搜索城市、地区和酒店。返回用于酒店搜索的位置ID和坐标。
hotel_search
按地区ID或GPS坐标开始酒店可用性搜索。指定日期、房间数、客人国籍和货币。
get_search_results
获取包含价格范围、星级、设施和餐食类型筛选的分页搜索结果。按价格或评分排序。
get_hotel_rooms
获取特定酒店的可用房间套餐。返回价格、餐食计划和预订所需的quote ID。
check_cancellation_policy
在预订前查看房间套餐的取消期限和罚款费用。
get_hotel_details
获取酒店完整信息:描述、设施、评价、照片、坐标和附近景点。
login
使用电子邮件和密码进行身份验证。返回用于已认证工具的Bearer token。
guest_login
仅使用电子邮件地址注册或登录。无需密码。返回预订用的Bearer token。
已认证工具(Bearer Token)
prepare_booking
使用客人详情和联系信息创建预订。返回支付用的预订ID。预订约15分钟后过期。
confirm_booking
使用B2B信用额度确认并支付。即时确认并提供预订参考号。仅限B2B合作伙伴。
create_checkout
生成Revolut支付结账URL。将最终用户重定向至卡片支付页面。通过webhook自动确认预订。
get_payment_url
生成Stripe结账URL用于卡片支付。适用于Stripe优于Revolut的市场。
list_bookings
按状态筛选的预订列表:即将到来、已完成、已取消或待处理。包含酒店和日期信息的分页结果。
get_booking_details
获取包括酒店信息、客人姓名、支付状态和取消政策在内的完整预订详情。
cancel_booking
取消预订。返回退款金额和取消费用。需要明确的确认标志。
集成选项
选择适合您技术栈的协议。所有端点返回相同的数据。MCP客户端可通过发现端点自动检测工具。
REST API
通过HTTP POST直接调用工具。每个工具有自己的URL路径。在请求体中发送JSON输入并接收JSON输出。公共工具无需头信息。已认证工具需要带有Bearer token的Authorization头。
# Search hotels in Paris (no auth)
curl -X POST \
https://locktrip.com/mcp/tools/search_location \
-H "Content-Type: application/json" \
-d '{"query": "Paris"}'
# Book with auth token
curl -X POST \
https://locktrip.com/mcp/tools/prepare_booking \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>" \
-d '{ ... }'MCP协议
使用Model Context Protocol进行原生AI代理集成。工具通过SSE或JSON-RPC自动发现。兼容Claude Desktop、Cursor以及任何MCP兼容客户端。发现端点提供服务器功能和工具元数据。
{
"mcpServers": {
"locktrip": {
"url": "https://locktrip.com/mcp/sse"
}
}
}发现端点
用于自动工具发现的机器可读端点。用于将LockTrip集成到AI代理框架、API网关或LLM工具注册表中。
支付选项
适用于不同用例的多种支付路径。B2C代理为最终用户生成结账链接。B2B合作伙伴通过信用额度即时支付。
Revolut结账
通过create_checkout工具生成托管支付页面。最终用户点击链接并用卡片支付。通过webhook自动确认预订。最适合面向消费者的AI代理。
Stripe结账
通过get_payment_url工具进行替代卡片支付。返回Stripe托管的结账URL。适用于Stripe优于Revolut的市场或货币。
B2B信用额度
适用于拥有预充值信用额度的商业合作伙伴。调用confirm_booking从余额中即时支付。无需重定向。适合构建自动预订管道的旅行社和OTA。
速率限制
匿名和已认证使用均有充裕的限额。已认证用户在所有端点获得更高的配额。
| 等级 | 搜索工具 | 预订工具 |
|---|---|---|
| 匿名 | 30 req/min | N/A(需要认证) |
| 已认证 | 60 req/min | 20 req/min |
准备好开始构建了吗?
无需API key,立即开始搜索酒店。阅读OpenAPI规范或连接MCP客户端以自动发现所有15个工具。 如需B2B合作伙伴关系和信用额度访问, 联系我们的商务团队.