Community라이팅 & 에디팅github.com

ScoutingAPI 여행 스킬

ScoutingAPI를 통해 숙소 검색, 가용성, 가격, OTA 간 비교 및 리뷰를 제공하는 휴대용 AI 에이전트 스킬(SKILL.md)입니다. Claude, MCP 등과 함께 사용할 수 있습니다. MIT-0 라이선스.

ScoutingAPI 여행 스킬란 무엇인가요?

ScoutingAPI의 travel-skills는 AI 에이전트(예: Claude, MCP)가 Airbnb, Booking.com, Vrbo, Google Hotels 등 주요 OTA의 숙소 데이터를 통합 조회할 수 있도록 설계된 휴대용 스킬입니다. 이 스킬은 Model Context Protocol(MCP) 서버를 기본 탑재하여, OAuth 2.1 + PKCE 인증을 통해 API 키 없이도 안전하게 연결됩니다. 제공되는 7개의 읽기 전용 도구(숙소 검색, 가용성 확인, 상세 정보, 가격 조회, OTA 간 가격 비교, 리뷰 조회, 작업 상태 폴링)로 에이전트가 실시간 데이터를 가져올 수 있습니다. REST API와 동일한 데이터와 스키마를 사용하지만, 대화형 에이전트 환경에 최적화되어 있으며, 크레딧 기반 과금과 별도 속도 제한이 적용됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add scoutingapi/travel-skills

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ScoutingAPI — MCP 서버 연결하기

ScoutingAPI는 기본 Model Context Protocol 서버를 제공하여 에이전트가 Airbnb, Booking.com, Vrbo, Google Hotels의 숙소 데이터를 일급 도구로 조회할 수 있게 해줍니다. API 키를 에이전트에 입력할 필요가 없습니다.

연결하기 (Claude.ai / Claude Desktop / Claude Code)

  1. 에이전트의 커넥터 설정을 열고 사용자 지정 커넥터(MCP 서버)를 추가합니다.
  2. URL https://mcp.scoutingapi.com을 입력합니다.
  3. 브라우저 팝업에서 OAuth 프롬프트를 완료합니다. 이렇게 하면 커넥터가 ScoutingAPI 계정에 연결됩니다. (처음 사용자는 계정을 만들고 이메일을 인증해야 합니다. 샌드박스 계정은 평가 용도로 사용할 수 있습니다. 자세한 내용은 https://scoutingapi.com/docs/mcp를 참조하세요.)
  4. 아래 7가지 도구를 에이전트가 사용할 수 있게 됩니다.

7가지 읽기 전용 도구

  • search_stays — 위치, 날짜, 인원, 필터를 기준으로 여러 플랫폼의 숙소를 검색합니다.
  • check_availability — 알려진 숙소의 특정 기간 동안 일별 가용성을 확인합니다.
  • get_listing — 하나의 숙소에 대한 전체 상세 정보(편의시설, 사진, 호스트, 평점)를 가져옵니다.
  • get_price — 하나의 숙소에 대해 특정 날짜와 인원에 대한 실제 가격 견적을 반환합니다.
  • compare_prices — 하나의 숙소를 여러 OTA에서 비교하고 계산된 최소 가격과 중간값을 제공합니다.
  • get_reviews — 하나의 플랫폼에 등록된 하나의 숙소에 대한 정규화된 리뷰를 페이지 단위로 조회합니다.
  • get_job — 비동기 스크래핑 작업의 상태를 폴링하고 결과를 가져옵니다(비용 없음).

비동기 동작

이 도구들은 REST와 동일한 비동기 계약을 공유합니다: 실시간 호출로 스크래핑이 필요한 경우 대기 중인 작업을 반환하며, 에이전트(또는 도구 계층)는 반환된 jobId로 get_job을 폴링하여 작업이 완료되면 data.result 아래에 결과 페이로드가 도착합니다. 샌드박스 및 캐시 적중 시에는 즉시 결과를 반환합니다.

크레딧 및 제한

MCP 호출은 REST 키와 동일한 단일 크레딧 잔액을 사용하지만, 별도의 사용자별 버킷에서 속도 제한이 적용됩니다. 비용 및 속도 제한: https://scoutingapi.com/pricing.

MCP vs REST — 어떤 것을 사용할까요?

  • MCP — 커넥터를 지원하는 대화형 에이전트/어시스턴트(예: Claude)에 가장 적합합니다. 키 관리 대신 OAuth를 사용하며, 도구가 모델에 기본적으로 표시됩니다.
  • REST (스킬: scoutingapi-search) — 프로그래밍 방식의 백엔드, 서버, 크론 작업, MCP를 지원하지 않는 모든 런타임에 가장 적합합니다. Bearer 키와 @scoutingapi/sdk를 사용합니다.

둘 다 동일한 데이터와 통합 스키마를 사용합니다. 문서: https://scoutingapi.com/docs/mcp.

관련 스킬