RollingGo-Hotel-MCP

Um serviço de busca e reserva de hotéis de alto desempenho construído sobre o padrão MCP.

Documentação

RollingGo — MCP de Pesquisa e Reserva de Hotéis

🏠 Site oficial · 🚀 Início rápido · 📚 Exemplos de uso · 💬 Suporte técnico📚 Tutorial de integração - versão em vídeo (para iniciantes, sem código) 📚 Tutorial de integração - versão em documento

Sobre o Projeto

RollingGo Hotel MCP oferece 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 limites de chamadas.

🔍 Filtro inteligente e comparação de preços conforme suas necessidades, escolha hotéis com tranquilidade

📋 Consulte em tempo real tipos de quarto, preços e regras de cancelamento, sem surpresas

🛏️ Garanta o tipo de quarto desejado com antecedência, sem se preocupar com falta de disponibilidade

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

📑 Consulte o status do pedido a qualquer momento, com 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ço	Endpoint	Tools Disponíveis	Autenticação
MCP de Hotéis	`https://mcp.rollinggo.cn/mcp`	searchHotels, getHotelDetail, getHotelSearchTags	`Authorization: Bearer <YOUR_API_KEY>`
MCP de Passagens Aéreas	`https://mcp.rollinggo.cn/mcp/flight`	searchAirports, searchFlights	`Authorization: Bearer <YOUR_API_KEY>`

Destaques do MCP

✅ Confirmação de preço e disponibilidade em tempo real - Conexão direta de inventário + confirmação de preço em tempo real, zero latência de informação, resultados de consulta prontos para reserva
✅ Cadeia de suprimentos madura - 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 de ponta a ponta
✅ Cobertura massiva de hotéis - Mais de 2 milhões de hotéis, cobrindo os principais destinos globais
✅ Recursos de hotéis com contrato direto - Mais de 110 mil hotéis com contrato direto, preços e disponibilidade em tempo real, garantindo resultados precisos e reserváveis
✅ Sistema de suprimentos diversificado - Integra mais de 500 fornecedores globais, abrangendo diversas marcas de hotéis, atendendo às necessidades de diferentes usuários
✅ Vantagem de preço diferenciada - Posicionado na cadeia upstream das 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 de IA populares, incluindo Cursor, Claude Code, Codex, Windsurf, Copilot, entre outros. Para plataformas de agentes como ClawHub/Coze/Qclaw, também oferecemos o Rollinggo Skill de Reserva de Passagens e Hotéis.

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 que estão construindo agentes 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 comercial fechado de Agentes de IA
Usuários individuais com necessidades de pesquisa de hotéis, comparação de preços e alertas de monitoramento de preços

Casos de Uso

Agente de IA Genérico: Dê ao seu agente de modelo de linguagem capacidade nativa de reserva de hotéis, permitindo que os usuários concluam todo o fluxo — compreensão de necessidades, recomendação inteligente, filtragem por comparação e criação de pedidos — 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 suporte a correspondência multidimensional de necessidades
Ferramenta de Planejamento de Viagens: Integre perfeitamente a pesquisa e reserva de hotéis ao fluxo conversacional de planejamento de viagens, proporcionando uma experiência integrada de "planejar é reservar"
Demonstração de MCP/Agente: Valide rapidamente a capacidade de produto de "Agente de IA concluir transações hoteleiras diretamente", criando um ciclo fechado demonstrável

Funcionalidades Principais

Suporta pesquisa precisa por nome de cidade, pontos turísticos populares, centros de transporte, nome do hotel, endereço específico — 6 tipos de locais-alvo
Oferece 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
Fornece recomendações personalizadas com base nas preferências do usuário, gerando rankings profissionais multidimensionais como melhor custo-benefício, alta avaliação e populares
Interação totalmente em linguagem natural, concluindo inteligentemente o ciclo completo de análise de local, filtragem por comparação, recomendação personalizada e geração de pedido

Início Rápido

💡 Em resumo, você só precisa fazer duas coisas: solicitar uma chave de API + configurar com um clique no assistente de IA. Sem necessidade de escrever código, qualquer assistente de IA compatível com MCP pode obter capacidade de pesquisa de hotéis. Conclua sua primeira chamada de ferramenta MCP em 5 minutos.

Etapa 1: Obter a Chave de API

Clique para solicitar
Preencha as informações básicas, sem espera, receba imediatamente.
Por que é necessário preencher informações para solicitar a chave? Preços de hotéis, disponibilidade e capacidade de pedidos envolvem transações reais. Portanto, precisamos emitir uma chave exclusiva para cada desenvolvedor. A solicitação exige apenas poucas informações, principalmente para reduzir custos de configuração inválida, proteger a estabilidade da interface, evitar chamadas maliciosas ou tráfego anormal, e permitir que possamos contatá-lo rapidamente em questões como pedidos de teste, consulta de preços e verificação de disponibilidade.

Etapa 2: Integrar à Ferramenta de Agente

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

Claude CLI

Crie .mcp.json no diretório raiz do projeto:

{
  "mcpServers": {
    "RollingGo-Hotel": {
      "url": "https://mcp.rollinggo.cn/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "RollingGo-Flight": {
      "url": "https://mcp.rollinggo.cn/mcp/flight",
      "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" \
  RollingGo-Hotel \
  https://mcp.rollinggo.cn/mcp

claude mcp add \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  RollingGo-Flight \
  https://mcp.rollinggo.cn/mcp/flight

Codex

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

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

Cursor

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

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

Substitua YOUR_API_KEY pela chave de API real que você recebeu. 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á erro 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
  }'

Etapa 3: Primeira Chamada MCP

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

"Pesquise hotéis 5 estrelas perto do Bund, em Xangai, para depois de amanhã"

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

Exemplo de Pesquisa 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

"Monitore o preço deste hotel perto da Zona Úmida de Xixi, em Hangzhou"

Exemplo 2: Pesquisa de Hotéis por Cidade

"Quais hotéis 4 estrelas ou superiores você recomenda em Hangzhou nos próximos três dias?"

showcase1 showcase2

Exemplo 2: Pesquisa Perto 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"

✨ Recursos

Recurso	Descrição
🏙️ Pesquisa por múltiplos locais	Suporta cidades, pontos turísticos, aeroportos, estações de trem, estações de metrô, etc.
📅 Filtro por data	Especifique data de check-in e número de noites
⭐ Filtro por estrelas	Suporta filtro de 0 a 5 estrelas, com precisão de 0,5 estrela
📍 Pesquisa por distância	Centralizada no ponto turístico, com raio limitado (metros)
🛏️ Detalhes de instalações	Opcionalmente retorna informações de instalações do hotel e do quarto
🌐 Multilíngue	Suporta ambientes em chinês, inglês, etc.

Descrição dos Parâmetros de Configuração

Parâmetros Principais Comuns

Parâmetro	Obrigatório	Descrição	Exemplo
place	✅	Local de pesquisa	Hangzhou, Disney
placeType	✅	Tipo de local	Cidade, ponto turístico, aeroporto, estação de metrô, distrito/condado...
originQuery	✅	Sua descrição original da necessidade	Encontre um hotel para mim
checkIn	❌	Data de check-in (yyyy-MM-dd)	2026-05-01
stayNights	❌	Número de noites	2
starRatings	❌	Faixa de estrelas	[4, 5] significa 4-5 estrelas
size	❌	Quantidade de retorno (padrão 10), máximo 20	5

Observação:

Os campos reais dependem dos dados retornados pela interface; os exemplos acima mostram apenas alguns campos.

À medida que a capacidade do backend evolui, os campos podem ser adicionados ou ajustados. Recomenda-se que o lado do cliente MCP use a abordagem "use se disponível, ignore se ausente" para compatibilidade.

❓ Perguntas Frequentes

P: Quais assistentes/IDEs de IA 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 da pesquisa incluem?

R: Por padrão, retorna nome do hotel, classificação por estrelas, preço, endereço, link de reserva, imagens do hotel, instalações do hotel, 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

Ambiente	Método de Autenticação	Cabeçalho
Remoto (nuvem)	Bearer Token	\Authorization: Bearer YOUR_API_KEY\
Serviço local	Secret Key	\X-Secret-Key: YOUR_API_KEY\

Recomendações de Segurança

Guarde sua chave de API com segurança; não a codifique diretamente no código
Em produção, use variáveis de ambiente para gerenciamento
Para acesso pela internet pública, use o protocolo HTTPS

🤝 Suporte Técnico

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

Junte-se ao 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 sua primeira chamada de reserva de hotel com sucesso, permitindo um lançamento rápido 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 de API/MCP
✅ Explicações sobre pesquisa de hotéis, preços e fluxo de reserva
✅ Recomendações de integração adequadas ao seu cenário de negócios

E-mail: york.lu@dida.com

Feito com ❤️ pela Equipe RollingGo