道旅酒店MCP

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

GitHub
8
Experimente este MCPPatrocinado

Documentação

道旅酒店MCP | Hotel Search & Booking MCP

Version ModelScope Calls License: MIT Python 3.8+

🏠 官网🚀 快速开始📚 使用示例💬 技术支持📚 接入视频(0基础0代码可实操) 📚 接入文档 · 💰开发者变现

Sobre o Projeto

O 道旅酒店MCP fornece capacidade de reserva de hotéis para Agentes de IA e clientes MCP. É ideal para desenvolvedores que desejam integrar capacidade de transação hoteleira em produtos de IA, construtores de agentes, equipes de produtos de turismo e cenários de viagens corporativas. Empresas e indivíduos podem integrar gratuitamente com um clique, sem limite de chamadas.

🔍 Filtragem inteligente e comparação de preços conforme a necessidade, escolha hotéis com tranquilidade

📋 Consulta em tempo real de tipos de quarto, cotações e regras de cancelamento, tudo claro para evitar surpresas

🛏️ Garanta o tipo de quarto desejado com antecedência, sem preocupação de ficar sem vaga

💳 Diga "fazer pedido" e a disponibilidade e o preço são confirmados em tempo real, pagamento direto

📑 Status do pedido consultável a qualquer momento, tranquilidade do início ao fim

💴 Configure o monitoramento automático de preços 24 horas, com alerta imediato de queda de preço

ServiçoEndpointTools DisponíveisAutenticação
Hotel MCPhttps://mcp.rollinggo.cn/mcpsearchHotels, getHotelDetail, getHotelSearchTagsAuthorization: Bearer <YOUR_API_KEY>
  • Protocolo de transporte: streamable-http
  • Preço: totalmente gratuito, sem limite de chamadas
  • Método de integração: consulte este documento para concluir de forma autônoma, adequado para quem precisa de validação rápida de protótipo e desenvolvimento de ferramentas em curto prazo

O 道旅MCP também oferece o modo de código de autorização OAuth 2.0, com 7 ferramentas, incluindo: getHotelSearchTags, searchHotels, getHotelDetail, hotelPriceConfirm, searchHotelOrders, entre outras. Esse modo é adequado para integração profunda em aplicações empresariais de produção, exigindo contato comercial via contact@rollinggo.ai.

Se você é um usuário internacional, ou seu público-alvo são países internacionalizados fora da China, consulte Dida-Hotel-MCP-Global. Essa versão suporta pagamento com cartão de crédito, adequada para cenários de negócios fora da China continental.

Destaques do MCP

  • ✅ Confirmação de preço e disponibilidade em tempo real - conexão direta de inventário + capacidade de confirmação de preço em tempo real, zero atraso de informação, resultados de consulta podem ser reservados diretamente
  • ✅ Cadeia de suprimentos madura e confiável - fonte oficial de dados B2B do terceiro maior grupo de viagens do mundo, 14 anos de experiência em cadeia de suprimentos de produtos de viagem, conexão direta via API em todo o fluxo
  • ✅ Cobertura massiva de hotéis - mais de 2 milhões de recursos hoteleiros, cobrindo os principais destinos globais
  • ✅ Recursos hoteleiros com contrato direto - mais de 110 mil hotéis com contrato direto, preço e disponibilidade em resposta em tempo real, garantindo resultados precisos e reserváveis
  • ✅ Sistema de suprimentos diversificado - integra mais de 500 fornecedores globais, cobrindo diversas marcas de hotéis, atendendo às necessidades de reserva de diferentes usuários
  • ✅ Vantagem de preço diferenciada - ancorado no fornecimento upstream de OTAs, com vantagens significativas de preço em hotéis no exterior e destinos populares como Xangai, Hong Kong, Japão e Coreia
  • ✅ Compatibilidade - suporta mais de 40 agentes de modelos mainstream, incluindo Cursor, Claude Code, Codex, Windsurf, Copilot, entre outros. Para plataformas de agentes como ClawHub/扣子/Qclaw, também oferecemos o Skill de reserva de hotéis completa
  • ✅ Comissão para desenvolvedores - após a integração, é possível definir a margem de acréscimo por país. Quando um usuário conclui uma reserva através da sua ferramenta, o valor correspondente é pago como comissão. Pedidos, ganhos e status de saque podem ser consultados em tempo real, com saque flexível

Público-alvo

  • Equipes ou desenvolvedores individuais desenvolvendo Agentes de IA
  • Desenvolvedores que desejam integrar capacidade de reserva de hotéis em clientes MCP
  • Desenvolvedores criando agentes inteligentes de planejamento de viagens, gestão de viagens corporativas, OTAs e serviços de estilo de vida
  • Equipes de produto que desejam validar o ciclo fechado de transações comerciais de Agentes de IA
  • Usuários com necessidade de consulta de hotéis, comparação de preços e alertas de monitoramento de preços

Cenários de aplicação

  • Agente genérico: dê ao Agente capacidade nativa de reserva de hotéis; o usuário pode concluir todo o fluxo, da comparação de preços à criação do pedido, em conversa natural
  • Assistente de viagem com IA: recomende hotéis com precisão com base no destino, datas, orçamento e preferências personalizadas do usuário, com correspondência multidimensional de necessidades
  • Demonstração de MCP / Agente: valide rapidamente a capacidade do produto "Agente de IA conclui diretamente transações hoteleiras", criando um ciclo fechado demonstrável e completo

Funcionalidades principais

  • Suporte a busca precisa por nome de cidade, pontos turísticos populares, centros de transporte, nome do hotel, endereço específico e outros 6 tipos de locais-alvo
  • Filtros profissionais flexíveis, como filtro por estrelas, definição de data de check-in, configuração de número de noites, filtro por faixa de preço
  • Recomendações personalizadas com base nas preferências individuais do usuário, gerando rankings profissionais multidimensionais como melhor custo-benefício, bem avaliados, populares
  • Interação totalmente em linguagem natural, concluindo inteligentemente o ciclo completo de análise de local, filtragem e comparação de preços, recomendação personalizada e geração de pedidos

Início Rápido

💡 Em resumo, você só precisa fazer duas coisas: solicitar a API Key + configurar em um clique no assistente de IA. Sem necessidade de escrever código, qualquer assistente de IA compatível com MCP terá capacidade de busca de hotéis. Conclua a primeira chamada de Tool MCP em 5 minutos.

Passo 1: Obter a chave da API

  1. Clique para solicitar
  2. Preencha as informações básicas, sem espera, receba na hora.
  3. Por que é necessário preencher informações para solicitar a KEY? Preços de hotéis, disponibilidade e capacidade de pedidos envolvem fluxos de transação reais, por isso precisamos criar uma KEY exclusiva e independente para cada desenvolvedor. A solicitação da KEY exige apenas poucas informações, principalmente para reduzir custos de configuração ineficazes, proteger a estabilidade da interface, evitar chamadas maliciosas ou tráfego anormal, e permitir contato rápido em questões como pedidos de teste, consulta de preços e verificação de disponibilidade.

Passo 2: Integrar à ferramenta de Agente

Recomendamos os clientes Claude CLI, Codex e Cursor. Outros clientes compatíveis com MCP (como Kiro, 豆包, etc.) têm configuração semelhante.

Claude CLI

Crie o arquivo .mcp.json na raiz do projeto:

{
  "mcpServers": {
    "DIDA-Hotel": {
      "url": "https://mcp.rollinggo.cn/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Você também pode adicionar diretamente pela linha de comando:

claude mcp add \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  DIDA-Hotel \
  https://mcp.rollinggo.cn/mcp

Codex

Local do arquivo de configuração: raiz do projeto .codex/config.json ou global ~/.codex/config.json

{
  "mcpServers": {
    "DIDA-Hotel": {
      "url": "https://mcp.rollinggo.cn/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Local do arquivo de configuração: raiz do projeto .cursor/mcp.json ou global ~/.cursor/mcp.json

{
  "mcpServers": {
    "DIDA-Hotel": {
      "url": "https://mcp.rollinggo.cn/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Substitua YOUR_API_KEY pela sua chave de API real recebida. Hotéis e passagens aéreas usam o mesmo método de autenticação, a diferença está apenas na URL (/mcp vs /mcp/flight).

Teste direto com cURL

Atenção: o cURL deve incluir o cabeçalho -H "Accept: application/json, text/event-stream", caso contrário o servidor retornará 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
  }'

Passo 3: Primeira chamada MCP

Após a configuração, diga ao seu assistente de IA:

"Me ajude a buscar hotéis 5 estrelas perto do Bund, em Xangai, para depois de amanhã"

A IA chamará automaticamente a Tool searchHotels e retornará a lista de hotéis.

Exemplo de busca de hotéis

{
  "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
}

Exemplos de uso

Exemplo 1: Alerta de monitoramento de preço de hotel

"Me ajude a monitorar este hotel perto de Xixi Wetland, em Hangzhou"

Exemplo 2: Busca de hotéis por cidade

"Me ajude a ver, nos próximos três dias, quais hotéis 4 estrelas ou mais são recomendados em Hangzhou?"

showcase1 showcase2

Exemplo 2: Busca ao redor de pontos turísticos

"No Dia dos Namorados chinês de 2026, quero encontrar um hotel com bom custo-benefício perto da Disney de Hong Kong"

showcase3 showcase5

✨ Recursos e funcionalidades

RecursoDescrição
🏙️ Busca por múltiplos locaisSuporta cidades, pontos turísticos, aeroportos, estações de trem, estações de metrô, etc.
📅 Filtro por dataDefinir data de check-in e número de noites
⭐ Filtro por estrelasSuporta filtro de 0 a 5 estrelas, com precisão de 0,5 estrela
📍 Busca por distânciaCom ponto turístico como centro, limitar raio (em metros)
🛏️ Detalhes de instalaçõesOpcional retornar informações de instalações do hotel e do quarto
🌐 MultilíngueSuporta ambientes em chinês, inglês, entre outros

Descrição dos parâmetros de configuração

Parâmetros principais comuns

ParâmetroObrigatórioDescriçãoExemplo
place✅Local de buscaHangzhou, Disney
placeType✅Tipo de localCidade, ponto turístico, aeroporto, estação de metrô, distrito/condado...
originQuery✅Sua descrição original da necessidadeMe ajude a encontrar hotéis
checkIn❌Data de check-in (yyyy-MM-dd)2026-05-01
stayNights❌Número de noites2
starRatings❌Faixa de estrelas[4, 5] indica 4-5 estrelas
size❌Quantidade de retorno (padrão 10), máximo 205

Observação:

  • Os campos reais devem seguir os dados retornados pela interface; os exemplos acima mostram apenas alguns campos.
  • Com a evolução das capacidades do backend, os campos podem ser adicionados ou ajustados. No lado do cliente MCP, recomenda-se compatibilidade no modo "usar se disponível, ignorar se ausente".

❓ Perguntas frequentes

P: Quais assistentes de IA/IDEs são suportados?

R: Atualmente, as seguintes plataformas são suportadas:

  • Cursor
  • Windsurf
  • Antigravity
  • Claude Desktop
  • Cherry studio e outros clientes compatíveis com o protocolo MCP

P: Quais informações os resultados de busca incluem?

R: Por padrão, retorna nome do hotel, estrelas, preço, endereço, link de reserva, imagens do hotel, instalações, etc. (Consulte os dados reais retornados para detalhes.)

P: Há limite de número de chamadas?

R: Atualmente, o uso é gratuito.

🔒 Segurança e autenticação

Método de autenticação

AmbienteMétodo de autenticaçãoHeader
Remoto (nuvem)Bearer Token\Authorization: Bearer YOUR_API_KEY\
Serviço localSecret Key\X-Secret-Key: YOUR_API_KEY\

Recomendações de segurança

  • Guarde bem a API Key, não a codifique diretamente no código
  • Em produção, use variáveis de ambiente para gerenciamento
  • Para acesso público, use o protocolo HTTPS

🤝 Suporte técnico

Agradecemos a cada desenvolvedor pela comunicação, compartilhamento e feedback, que tornam a evolução da DIDA mais eficiente.

Entre no grupo do WeChat; a equipe principal de desenvolvimento estará online o tempo todo para ajudar com configuração de ambiente, depuração de interface e para executar juntos a primeira chamada de reserva de hotel bem-sucedida, com integração rápida e sem obstáculos.

Support WeChat

No grupo, você pode obter:

  • ✅ Orientação de configuração de integração
  • ✅ Solução de problemas de chamadas API / MCP
  • ✅ Explicação sobre busca de hotéis, preços e fluxo de reservas
  • ✅ Recomendações de integração adequadas ao seu cenário de negócios

E-mail: york.lu@dida.com

⚠ Apêndice: Notas de atualização do 道旅Hotel MCP (OAuth) v2.3

A v2.3 otimizou a estrutura de consulta de pedidos, adicionando vários campos de detalhes do pedido para ajudar o Agente a lidar melhor com cenários de check-in, pagamento e cancelamento. Observação: esta atualização se aplica apenas à versão de integração OAuth, não à versão com API Key descrita neste documento. A versão OAuth requer contato comercial.

O que mudou

Tools inalteradas (4)

  • getHotelSearchTags — Obtém todas as tags de filtro de hotéis disponíveis
  • searchHotels — Busca lista global de hotéis por condições
  • getHotelDetail — Obtém tipos de quarto e preços disponíveis de um hotel específico
  • hotelPriceConfirm — Bloqueia o preço final de varejo em tempo real do tipo de quarto selecionado

Tools modificadas (2)

  • createHotelBookingWithPaymentURL — Removido o parâmetro alipayUrlScene; bookingResult.paymentUrl unificado como checkout genérico
  • searchHotelOrders — Saída simplificada para 9 campos principais (orderNo、hotelName、roomName、orderStatus、totalPrice etc.), apenas para exibição em lista; detalhes completos movidos para consulta em interface separada

Novas tools (1)

  • getHotelOrderDetail — Consulta detalhes completos do pedido por orderNo, incluindo hotelConfirmationNo, lista de hóspedes, tipo de cama, telefone de contato, latitude/longitude, prazo de pagamento/cancelamento, indicadores de política, etc.

Novos campos

  • hotelConfirmationNo — Número de confirmação real do hotel, para consulta de check-in na recepção
  • stayInfo.bedTypeStr — Descrição do tipo de cama em chinês (ex.: "1张特大床 (1.8m)")
  • stayInfo.guestNames — Lista de nomes dos hóspedes em pinyin/inglês, para verificação no check-in
  • priceInfo.paymentDeadline — Prazo de pagamento (YYYY-MM-DD HH:mm:ss), para lembretes de contagem regressiva
  • policyInfo.freeCancelDeadline — Prazo para cancelamento gratuito, para determinar a janela de reembolso
  • policyInfo.isCancelable — Se ainda é possível cancelar gratuitamente no momento atual

Total de tools: 7 (V2.2 tinha 6) — 1 nova, 2 modificadas, 4 inalteradas.

Feito com ❤️ pela equipe DIDA