CommunityEscrita e Ediçãogithub.com

scoutingapi/travel-skills

Habilidades portáteis para agentes de IA (SKILL.md) para busca de acomodações, disponibilidade, preços, comparação entre OTAs e avaliações via ScoutingAPI. Funciona com Claude, MCP e mais. MIT-0.

O que é travel-skills?

O ScoutingAPI, através do seu arquivo SKILL.md, fornece um conjunto de ferramentas de leitura para agentes de IA interagirem com dados de acomodações de plataformas como Airbnb, Booking.com, Vrbo e Google Hotels. A habilidade se conecta via um servidor MCP (Model Context Protocol) nativo usando OAuth 2.1 + PKCE para autenticação, eliminando a necessidade de gerenciar chaves de API manualmente. Ela oferece sete ferramentas principais, incluindo busca de estadias, verificação de disponibilidade diária, obtenção de detalhes de listagens, cotações de preços reais, comparação entre OTAs, avaliações paginadas e monitoramento de trabalhos assíncronos. O comportamento assíncrono garante que chamadas que exigem scraping retornem um ID de trabalho para polling, enquanto resultados em cache ou sandbox são imediatos. Ideal para agentes interativos como Claude, a habilidade é melhor utilizada em ambientes com suporte a MCP, enquanto a versão REST é mais adequada para backends programáticos. Ambos compartilham o mesmo saldo de créditos e esquema unificado.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add scoutingapi/travel-skills

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

ScoutingAPI — conecte o servidor MCP

O ScoutingAPI disponibiliza um servidor Model Context Protocol nativo para que um agente possa consultar dados de acomodações no Airbnb, Booking.com, Vrbo e Google Hotels como ferramentas de primeira classe — sem necessidade de colar chave de API no agente.

Conectar (Claude.ai / Claude Desktop / Claude Code)

  1. Abra as configurações do conector do seu agente e adicione um conector personalizado (servidor MCP).
  2. Use a URL https://mcp.scoutingapi.com.
  3. Complete o prompt OAuth no pop-up do navegador — isso vincula o conector à sua conta do ScoutingAPI. (Usuários iniciantes: crie uma conta e verifique o e-mail primeiro; uma conta sandbox funciona para avaliação. Veja https://scoutingapi.com/docs/mcp.)
  4. As sete ferramentas abaixo ficam disponíveis para o agente.

As sete ferramentas somente leitura

  • search_stays — pesquise estadias em várias plataformas por local, datas, ocupação, filtros.
  • check_availability — disponibilidade dia a dia para uma listagem conhecida em um intervalo de datas.
  • get_listing — detalhes completos de uma listagem (comodidades, fotos, anfitrião, avaliações).
  • get_price — uma cotação de preço real para uma listagem com datas e ocupação específicas.
  • compare_prices — compare uma propriedade entre OTAs com o mínimo e a mediana calculados.
  • get_reviews — avaliações normalizadas e paginadas para uma listagem em uma plataforma.
  • get_job — consulte o status e obtenha os resultados de um trabalho de scraping assíncrono (custa 0).

Comportamento assíncrono

As ferramentas compartilham o mesmo contrato assíncrono da REST: uma chamada ao vivo que precisa fazer scraping retorna um trabalho pendente; o agente (ou a camada de ferramenta) consulta get_job com o jobId retornado até que ele seja concluído, e a carga útil do resultado chega em data.result. Acessos sandbox e em cache retornam imediatamente.

Créditos e limites

As chamadas MCP consomem do mesmo saldo único de créditos que suas chaves REST, mas são limitadas por taxa em um bucket separado por usuário. Custos e limites de taxa: https://scoutingapi.com/pricing.

MCP vs REST — qual usar

  • MCP — melhor para agentes/assistentes interativos (ex.: Claude) que suportam conectores: OAuth em vez de gerenciamento de chaves, ferramentas expostas nativamente ao modelo.
  • REST (habilidade: scoutingapi-search) — melhor para backends programáticos, servidores, tarefas agendadas e qualquer runtime sem suporte a MCP: uma chave Bearer + o @scoutingapi/sdk.

Ambos acessam os mesmos dados e o mesmo esquema unificado. Documentação: https://scoutingapi.com/docs/mcp.

Habilidades Relacionadas