道旅酒店MCP
全球酒店推荐预订MCP,200万+酒店API直连,全球第三大酒旅B2B公司官方数据源,实时库存价确,免费无调用上限。可按地点、日期、星级、人数、标签等条件搜索酒店列表,返回候选酒店及展示价。可查询指定酒店的实时房型列表、价格计划和取消政策。
Documentación
道旅酒店MCP | Búsqueda y Reserva de Hoteles MCP
🏠 Sitio oficial🚀 Inicio rápido📚 Ejemplos de uso💬 Soporte técnico📚 Video de integración (sin conocimientos previos, sin código, práctico) 📚 Documentación de integración · 💰 Monetización para desarrolladores
Introducción del proyecto
道旅酒店MCP proporciona capacidades de reserva de hoteles para agentes de IA y clientes MCP. Es adecuado para desarrolladores, constructores de agentes, equipos de productos turísticos y escenarios de viajes corporativos que deseen integrar capacidades de transacción hotelera en productos de IA. Tanto empresas como individuos pueden conectarse de forma totalmente gratuita y sin límites de llamadas.
🔍 Filtrado inteligente y comparación de precios según tus necesidades, para elegir hotel sin complicaciones
📋 Consulta en tiempo real tipos de habitación, precios y políticas de cancelación, con total transparencia y sin sorpresas
🛏️ Bloquea tu tipo de habitación favorita con antelación, sin preocuparte por quedarte sin disponibilidad
💳 Di "hacer pedido" y confirma en tiempo real el inventario y el precio para pagar directamente
📑 Consulta el estado del pedido en cualquier momento, con total tranquilidad durante todo el proceso
💴 También puedes configurar un monitoreo automático de precios 24 horas, con aviso inmediato cuando bajen
| Servicio | Endpoint | Herramientas disponibles | Autenticación |
|---|---|---|---|
| Hotel MCP | https://mcp.rollinggo.cn/mcp | searchHotels, getHotelDetail, getHotelSearchTags | Authorization: Bearer <YOUR_API_KEY> |
- Protocolo de transporte:
streamable-http - Precio: totalmente gratuito, sin límites de llamadas
- Método de integración: puedes completarlo de forma autónoma siguiendo este documento, ideal para prototipos rápidos y desarrollo de herramientas en poco tiempo
道旅MCP también ofrece el modo de código de autorización OAuth 2.0, con 7 herramientas, incluyendo: getHotelSearchTags, searchHotels, getHotelDetail, hotelPriceConfirm, searchHotelOrders, entre otras. Este modo es adecuado para la integración profunda en aplicaciones empresariales de producción y requiere contacto comercial en contact@rollinggo.ai.
Si eres un usuario internacional, o tu público objetivo son países internacionales fuera de China, consulta Dida-Hotel-MCP-Global. Esta versión admite pagos con tarjeta de crédito y es adecuada para escenarios comerciales fuera de la China continental.
Destacados de MCP
- ✅ Confirmación de precio e inventario en tiempo real - Conexión directa de inventario + confirmación de precios en tiempo real, información sin demoras, los resultados de búsqueda se pueden reservar directamente
- ✅ Cadena de suministro madura garantizada - Fuente de datos oficial B2B de viajes y hotelería número 3 del mundo, 14 años de experiencia en cadena de suministro de productos turísticos, conexión API directa en toda la cadena
- ✅ Cobertura masiva de hoteles - Más de 2 millones de recursos hoteleros, cubriendo los principales destinos del mundo
- ✅ Recursos hoteleros de contrato directo - Más de 110,000 hoteles de contrato directo conectados, precios e inventario con respuesta en tiempo real, garantizando resultados precisos y reservables
- ✅ Sistema de suministro diversificado - Integra más de 500 proveedores globales, cubriendo diversas marcas hoteleras para satisfacer las necesidades de reserva de diferentes usuarios
- ✅ Ventaja de precios diferenciada - Anclado al suministro upstream de OTA, con ventajas de precio significativas en hoteles internacionales y destinos populares como Shanghái, Hong Kong, Japón y Corea
- ✅ Compatibilidad - Compatible con más de 40 agentes de modelos principales como Cursor, Claude Code, Codex, Windsurf, Copilot, y para plataformas de agentes como ClawHub/扣子/Qclaw, también ofrece Skill de reserva de hoteles todo en uno
- ✅ Comisión para desarrolladores - Al conectarte, puedes configurar el margen de aumento por país; cuando los usuarios completen reservas a través de tu herramienta, el monto correspondiente se otorgará como comisión. El estado de pedidos, ingresos y retiros se puede consultar en tiempo real, con retiros flexibles
Usuarios adecuados
- Equipos o desarrolladores individuales que desarrollan agentes de IA
- Desarrolladores que desean integrar capacidades de reserva hotelera en clientes MCP
- Desarrolladores que construyen agentes inteligentes de planificación de viajes, gestión de viajes corporativos, OTA y servicios de vida
- Equipos de producto que desean validar el ciclo comercial cerrado de agentes de IA
- Usuarios con necesidades de consulta de hoteles, comparación de precios y avisos de monitoreo de precios
Escenarios de aplicación
- Agente general: permite que el agente tenga capacidades nativas de reserva hotelera; los usuarios pueden completar todo el proceso, desde la comparación de precios y el filtrado hasta la creación del pedido, en conversación natural
- Asistente de viajes con IA: recomienda hoteles con precisión según el destino, las fechas, el presupuesto y las preferencias personalizadas del usuario, con coincidencia de necesidades multidimensionales
- Demo de MCP / Agente: valida rápidamente la capacidad del producto de "agente de IA que completa transacciones hoteleras directamente", creando un ciclo cerrado completo y demostrable
Funciones principales
- Búsqueda precisa en 6 tipos de ubicaciones objetivo, incluyendo nombre de ciudad, atracciones populares, centros de transporte, nombre de hotel, dirección específica, etc.
- Filtros profesionales flexibles como filtro por estrellas, configuración de fecha de entrada, configuración de noches de estancia, filtro por rango de precios
- Recomendaciones personalizadas basadas en las preferencias individuales del usuario, generando listas profesionales multidimensionales como alta relación calidad-precio, bien valoradas, populares, etc.
- Interacción completa en lenguaje natural, completando inteligentemente el ciclo cerrado desde análisis de ubicación, filtrado y comparación de precios, recomendación personalizada hasta generación de pedidos
Inicio rápido
💡 En resumen, solo necesitas hacer dos cosas: solicitar una clave API + configurarla con un solo clic en el asistente de IA. Sin necesidad de escribir código, cualquier asistente de IA compatible con MCP tendrá capacidades de búsqueda de hoteles. Completa tu primera llamada a una herramienta MCP en 5 minutos.
Paso 1: Obtener la clave API
- Haz clic para solicitar
- Completa la información básica, sin esperas, la obtienes al instante.
- ¿Por qué es necesario completar información para solicitar la clave? Los precios de hoteles, el inventario y las capacidades de pedido involucran transacciones reales, por lo que necesitamos habilitar una clave independiente exclusiva para cada desarrollador. Solo se requiere completar información mínima al solicitar la clave, principalmente para reducir costos de configuración ineficaces, proteger la estabilidad de la interfaz, evitar llamadas maliciosas o tráfico anómalo, y poder contactarte a tiempo en problemas de pedidos de prueba, consultas de precios, verificación de inventario, etc.
Paso 2: Integrar la herramienta del agente
Se recomiendan los clientes Claude CLI, Codex y Cursor. Otros clientes compatibles con MCP (como Kiro, Doubao, etc.) tienen un método de configuración similar.
Claude CLI
Crea .mcp.json en el directorio raíz del proyecto:
{
"mcpServers": {
"DIDA-Hotel": {
"url": "https://mcp.rollinggo.cn/mcp",
"type": "http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
También puedes agregarlo directamente desde la línea de comandos:
claude mcp add \
--transport http \
--header "Authorization: Bearer YOUR_API_KEY" \
DIDA-Hotel \
https://mcp.rollinggo.cn/mcp
Codex
Ubicación del archivo de configuración: .codex/config.json en el directorio raíz del proyecto o ~/.codex/config.json global
{
"mcpServers": {
"DIDA-Hotel": {
"url": "https://mcp.rollinggo.cn/mcp",
"type": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Cursor
Ubicación del archivo de configuración: .cursor/mcp.json en el directorio raíz del proyecto o ~/.cursor/mcp.json global
{
"mcpServers": {
"DIDA-Hotel": {
"url": "https://mcp.rollinggo.cn/mcp",
"type": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Reemplaza
YOUR_API_KEYcon la clave API real que recibiste. Los hoteles y los vuelos utilizan el mismo método de autenticación; la única diferencia es la URL (/mcpvs/mcp/flight).
Prueba directa con cURL
Nota: cURL debe incluir el encabezado
-H "Accept: application/json, text/event-stream", de lo contrario el servidor devuelve 400.
curl -X POST https://mcp.rollinggo.cn/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "searchHotels",
"arguments": {
"originQuery": "上海外滩五星酒店",
"place": "上海外滩",
"placeType": "景点",
"checkInParam": {
"checkInDate": "2026-06-01",
"stayNights": 2
},
"filterOptions": {
"starRatings": [5.0]
},
"size": 3
}
},
"id": 1
}'
Paso 3: Primera llamada a MCP
Una vez configurado, dile a tu asistente de IA:
"Ayúdame a buscar hoteles de 5 estrellas cerca del Bund en Shanghái para pasado mañana"
La IA llamará automáticamente a la herramienta searchHotels y devolverá la lista de hoteles.
Ejemplo de búsqueda de hoteles
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "searchHotels",
"arguments": {
"originQuery": "上海外滩五星酒店",
"place": "上海外滩",
"placeType": "景点",
"checkInParam": {
"checkInDate": "2026-06-01",
"stayNights": 2
},
"filterOptions": {
"starRatings": [5.0]
},
"size": 3
}
},
"id": 1
}
Ejemplos de uso
Ejemplo 1: Aviso de monitoreo de precios de hotel
"Ayúdame a monitorear este hotel cerca del humedal Xixi en Hangzhou"
Ejemplo 2: Búsqueda de hoteles por ciudad
"Ayúdame a ver qué hoteles de 4 estrellas o más hay recomendados en Hangzhou en los próximos tres días"

Ejemplo 2: Búsqueda cerca de atracciones
"Para el Día de San Valentín chino de 2026, quiero encontrar un hotel con buena relación calidad-precio cerca de Disneyland Hong Kong"
✨ Características
| Función | Descripción |
|---|---|
| 🏙️ Búsqueda por múltiples ubicaciones | Admite ciudades, atracciones, aeropuertos, estaciones de tren, estaciones de metro, etc. |
| 📅 Filtro por fechas | Especifica fecha de entrada y noches de estancia |
| ⭐ Filtro por estrellas | Admite filtro de 0 a 5 estrellas, con precisión de 0.5 estrellas |
| 📍 Búsqueda por distancia | Centrada en la atracción, con radio limitado (metros) |
| 🛏️ Detalles de instalaciones | Opcional: devuelve información de instalaciones del hotel y de la habitación |
| 🌐 Multilingüe | Admite entornos en chino, inglés, etc. |
Descripción de parámetros de configuración
Parámetros principales comunes
| Parámetro | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|
| place | ✅ | Lugar de búsqueda | Hangzhou, Disney |
| placeType | ✅ | Tipo de lugar | Ciudad, atracción, aeropuerto, estación de metro, distrito/condado... |
| originQuery | ✅ | Tu descripción original de la necesidad | Ayúdame a encontrar un hotel |
| checkIn | ❌ | Fecha de entrada (yyyy-MM-dd) | 2026-05-01 |
| stayNights | ❌ | Noches de estancia | 2 |
| starRatings | ❌ | Rango de estrellas | [4, 5] indica 4-5 estrellas |
| size | ❌ | Cantidad de resultados (por defecto 10), máximo 20 | 5 |
Nota:
- Los campos reales dependen de los datos devueltos por la interfaz; los ejemplos anteriores solo muestran algunos campos.
- A medida que evolucionen las capacidades del backend, los campos pueden agregarse o ajustarse. Se recomienda que el cliente MCP sea compatible con el enfoque de "usar si existe, ignorar si no".
❓ Preguntas frecuentes
P: ¿Qué asistentes de IA / IDE son compatibles?
R: Actualmente se admiten las siguientes plataformas:
- Cursor
- Windsurf
- Antigravity
- Claude Desktop
- Cherry studio y otros clientes compatibles con el protocolo MCP
P: ¿Qué información incluyen los resultados de búsqueda?
R: Por defecto se devuelven nombre del hotel, estrellas, precio, dirección, enlace de reserva, imágenes del hotel, instalaciones, etc. (Consulta los datos reales devueltos para más detalles).
P: ¿Hay límite en el número de llamadas?
R: Actualmente es de uso gratuito.
🔒 Seguridad y autenticación
Métodos de autenticación
| Entorno | Método de autenticación | Header |
|---|---|---|
| Remoto (nube) | Bearer Token | \Authorization: Bearer YOUR_API_KEY\ |
| Servicio local | Secret Key | \X-Secret-Key: YOUR_API_KEY\ |
Recomendaciones de seguridad
- Guarda bien tu clave API, no la codifiques directamente en el código
- En producción, se recomienda usar variables de entorno
- Para acceso público, usa el protocolo HTTPS
🤝 Soporte técnico
Agradecemos a cada desarrollador por su comunicación, intercambio y comentarios, que hacen que la iteración de DIDA sea más eficiente.
Únete al grupo de WeChat; el equipo central de desarrollo estará en línea durante todo el proceso para ayudarte con la configuración del entorno, la depuración de interfaces y lograr juntos la primera llamada exitosa de reserva de hotel, con una puesta en marcha sin obstáculos.

En el grupo podrás obtener:
- ✅ Guía de configuración de integración
- ✅ Resolución de problemas de llamadas API / MCP
- ✅ Explicación de los procesos de búsqueda de hoteles, precios y reservas
- ✅ Recomendaciones de integración adecuadas para tu escenario de negocio
Correo electrónico: york.lu@dida.com
⚠ Apéndice: Notas de actualización de 道旅Hotel MCP (OAuth) v2.3
La v2.3 optimiza la estructura de consulta de pedidos y agrega múltiples campos de detalle de pedido para ayudar al agente a manejar mejor los escenarios de check-in, pago y cancelación. Nota: esta actualización solo aplica a la versión de integración OAuth, no a la versión con clave API descrita en este documento. La versión OAuth requiere contacto comercial.
Qué cambió
Herramientas sin cambios (4)
getHotelSearchTags— Obtiene todas las etiquetas de filtro de hoteles disponiblessearchHotels— Busca la lista global de hoteles según condicionesgetHotelDetail— Obtiene los tipos de habitación y precios disponibles de un hotel específicohotelPriceConfirm— Bloquea el precio minorista final en tiempo real del tipo de habitación seleccionado
Herramientas modificadas (2)
createHotelBookingWithPaymentURL— Se elimina el parámetroalipayUrlScene;bookingResult.paymentUrlse unifica como caja de pago generalsearchHotelOrders— La salida se simplifica a 9 campos principales (orderNo,hotelName,roomName,orderStatus,totalPrice, etc.), solo para visualización en listas; los detalles completos se trasladan a una consulta de interfaz independiente
Herramientas nuevas (1)
getHotelOrderDetail— Consulta los detalles completos del pedido pororderNo, incluyendohotelConfirmationNo, lista de huéspedes, tipo de cama, teléfono de contacto, latitud/longitud, fecha límite de pago/cancelación, indicadores de política, etc.
Campos nuevos
hotelConfirmationNo— Número de confirmación real del hotel, para consultar el check-in en recepciónstayInfo.bedTypeStr— Descripción del tipo de cama en chino (por ejemplo,"1张特大床 (1.8m)")stayInfo.guestNames— Lista de nombres de huéspedes en pinyin/inglés, para verificación de check-inpriceInfo.paymentDeadline— Fecha límite de pago (YYYY-MM-DD HH:mm:ss), para recordatorios de cuenta regresivapolicyInfo.freeCancelDeadline— Fecha límite de cancelación gratuita, para determinar la ventana de reembolsopolicyInfo.isCancelable— Indica si aún se puede cancelar gratuitamente en el momento actual
Total de herramientas: 7 (V2.2 tenía 6) — 1 nueva, 2 modificadas, 4 sin cambios.
Hecho con ❤️ por DIDA Team
