道旅酒店MCP

全球酒店推荐预订MCP,200万+酒店API直连,全球第三大酒旅B2B公司官方数据源,实时库存价确,免费无调用上限。可按地点、日期、星级、人数、标签等条件搜索酒店列表,返回候选酒店及展示价。可查询指定酒店的实时房型列表、价格计划和取消政策。

Documentación

道旅酒店MCP | Búsqueda y Reserva de Hoteles MCP

Version ModelScope Calls License: MIT Python 3.8+

🏠 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

ServicioEndpointHerramientas disponiblesAutenticación
Hotel MCPhttps://mcp.rollinggo.cn/mcpsearchHotels, getHotelDetail, getHotelSearchTagsAuthorization: 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

  1. Haz clic para solicitar
  2. Completa la información básica, sin esperas, la obtienes al instante.
  3. ¿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_KEY con 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 (/mcp vs /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"

showcase1 showcase2

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"

showcase3 showcase5

✨ Características

FunciónDescripción
🏙️ Búsqueda por múltiples ubicacionesAdmite ciudades, atracciones, aeropuertos, estaciones de tren, estaciones de metro, etc.
📅 Filtro por fechasEspecifica fecha de entrada y noches de estancia
Filtro por estrellasAdmite filtro de 0 a 5 estrellas, con precisión de 0.5 estrellas
📍 Búsqueda por distanciaCentrada en la atracción, con radio limitado (metros)
🛏️ Detalles de instalacionesOpcional: devuelve información de instalaciones del hotel y de la habitación
🌐 MultilingüeAdmite entornos en chino, inglés, etc.

Descripción de parámetros de configuración

Parámetros principales comunes

ParámetroObligatorioDescripciónEjemplo
placeLugar de búsquedaHangzhou, Disney
placeTypeTipo de lugarCiudad, atracción, aeropuerto, estación de metro, distrito/condado...
originQueryTu descripción original de la necesidadAyúdame a encontrar un hotel
checkInFecha de entrada (yyyy-MM-dd)2026-05-01
stayNightsNoches de estancia2
starRatingsRango de estrellas[4, 5] indica 4-5 estrellas
sizeCantidad de resultados (por defecto 10), máximo 205

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

EntornoMétodo de autenticaciónHeader
Remoto (nube)Bearer Token\Authorization: Bearer YOUR_API_KEY\
Servicio localSecret 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.

Support WeChat

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 disponibles
  • searchHotels — Busca la lista global de hoteles según condiciones
  • getHotelDetail — Obtiene los tipos de habitación y precios disponibles de un hotel específico
  • hotelPriceConfirm — Bloquea el precio minorista final en tiempo real del tipo de habitación seleccionado

Herramientas modificadas (2)

  • createHotelBookingWithPaymentURL — Se elimina el parámetro alipayUrlScene; bookingResult.paymentUrl se unifica como caja de pago general
  • searchHotelOrders — 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 por orderNo, incluyendo hotelConfirmationNo, 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ón
  • stayInfo.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-in
  • priceInfo.paymentDeadline — Fecha límite de pago (YYYY-MM-DD HH:mm:ss), para recordatorios de cuenta regresiva
  • policyInfo.freeCancelDeadline — Fecha límite de cancelación gratuita, para determinar la ventana de reembolso
  • policyInfo.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