Genel Bakış

Airbnb MCP, uygulamanızın Airbnb listelemeleri üzerinde arama yapmasına ve detaylı bilgilere erişmesine olanak tanır. Bu sayede kullanıcılar, konum, fiyat, tarih ve kişi sayısı gibi parametrelere göre özelleştirilmiş arama yapabilir. MCP yapısına uygun biçimde çalışarak, Kuika uygulamanız Airbnb verilerini doğrudan MCP aracılığıyla kullanabilir.

Action Input (Girdi Parametreleri)

Airbnb aramalarında kullanılabilecek parametreler:

• location (String – Zorunlu)
  
  • Arama yapılacak bölge.
  • Örn: "İstanbul, Türkiye", "Greenwich"
• placeId (String – Opsiyonel)
  
  • Google Maps Place ID bilgisidir. 
  • Google Place ID Finder üzerinden bulunabilir.
• pageCursor (String – Opsiyonel)
  
  • Sayfalama imlecidir. İlk aramada birçok sonuç dönebilir, bu parametre ile  sonuçlara limit konulabilir.
• checkIn (Date – Opsiyonel): Konaklama giriş tarihi.
• checkout (Date – Opsiyonel): Konaklama çıkış tarihi.
• numberOfAdults (Integer – Varsayılan: 1)
• numberOfChildren (Integer – Varsayılan: 0)
• numberOfInfants (Integer – Varsayılan: 0)
• numberOfPets (Integer – Varsayılan: 0)
• minPrice (Decimal – Opsiyonel): Gecelik minimum fiyat (EUR).
• maxPrice (Decimal – Opsiyonel): Gecelik maksimum fiyat (EUR).

Action Output (Çıktılar)

Airbnb sorgusu aşağıdaki bilgileri döndürür:

• paginationInfo: Her sayfanın bir kimliği bulunur, bu ID üzerinden sayfa kısıtlaması yapılabilir.
• searchResults:  Dönen ilanların listesi.
• searchUrl: Yapılan aramanın URL çıktısı.

1. İlan Detayları (searchResults altında)

Her ilan aşağıdaki bilgileri içerir:

• avgRatingA11yLabel: Ortalama puanın erişilebilirlik açıklaması.
• Badges:  İlan rozetleri (Superhost, Guest Favorite, Rare Find, vb.).
• demandStayListing: İlanın yoğun talep bilgileri.
• structuredContent:  İlan açıklaması ve özelliklerinin yapılandırılmış hali.
• Id: Airbnb ilanının benzersiz kimliği.
• Url: İlanın Airbnb linki.
• listingParamOverrides:  Bu ilana özel parametre değişiklikleri.
• structuredDisplayPrice: Fiyat bilgisi.

2. demandStayListing Alanı

• Description: Yoğun talep mesajı.
• name.localizedStringWithTranslationPreference: Kullanıcı diline çevrilmiş mesaj.
• Id: Mesajın benzersiz kimliği.
• Location: İlgili koordinat bilgisi.

3. structuredContent Alanı

• mapCategory: Harita kategorisi (Superhost, Entire_Home vb.).
• mapSecondaryLine: Haritadaki ek açıklama.
• primaryLine: Kartta görünen ana içerik.
• secondaryLine: Karttaki ek bilgi.

4. listingParamOverrides Alanı

• Adults: Yetişkin sayısı.
• checkin / checkout: Aramada geçerli giriş/çıkış tarihleri.
• relaxedAmenityIds → Tercih edilen ama zorunlu olmayan imkanlar (örn: "kitchen", "wifi").
• splitStaysLocationPrecisions → oklu lokasyon varsa, konum hassasiyeti (örn: City, Neighborhood).
• splitStaysLocationsAcpIds → Ayrık lokasyonlar için Airbnb City/Place ID’leri.

5. structuredDisplayPrice Alanı

• primaryLine: Kartta görünen fiyat (örn: “€120 per night”).
• primaryLine.accessibilityLabel:  Fiyat bilgisinin erişilebilirlik açıklaması (örn: “120 Euro per night”).
• explanationData:Fiyatın hesaplama detayları.
  
  • Title: Açıklayıcı metin (örn: “Price breakdown”).
  • priceDetails:  Fiyatın bileşenleri (örn: gecelik ücret, temizlik ücreti, servis ücreti).