İstanbul vapurları, yapay zekâ asistanınız için
Iskelesi'nin verileri bütün yapay zekâ asistanlarına açık. Asistanınızı bağlayın; Kadıköy'den bir sonraki vapurun kaçta kalktığını, Eminönü'nden Adalar'a nasıl gidileceğini ya da Galata Köprüsü'nden gördüğünüz vapurun hangisi olduğunu sorun.
Bu, herkese açık bir Model Context Protocol (MCP) sunucusudur: ücretsiz, salt okunur; anahtar da hesap da gerekmez. Adresi:
https://api.iskelesi.com/mcp
Bağlanın
Claude
claude.ai'de ya da Claude uygulamalarında: Settings → Connectors → Add custom connector. Adını Iskelesi koyun ve yukarıdaki adresi yapıştırın. Yetkilendirme gerekmez.
Claude Code
claude mcp add --transport http iskelesi https://api.iskelesi.com/mcp
Cursor
~/.cursor/mcp.json dosyasına ekleyin:
{ "mcpServers": { "iskelesi": { "url": "https://api.iskelesi.com/mcp" } } }
VS Code
.vscode/mcp.json dosyasına ekleyin:
{ "servers": { "iskelesi": { "type": "http", "url": "https://api.iskelesi.com/mcp" } } }
Model Context Protocol'ü HTTP üzerinden konuşan diğer bütün istemciler de aynı şekilde çalışır: adresi verin ve "Streamable HTTP" seçin.
Asistanınız neler yapabilir
Sekiz araç var; hepsi salt okunur. Her biri, modelin doğrudan okuyabileceği kısa bir yanıt ve aynı bilgiyi yapılandırılmış JSON olarak döndürür. Araçlar Türkçe sorularla da çalışır; yanıt metinleri İngilizcedir.
| Araç | Neyi yanıtlar | Örnek soru |
|---|---|---|
search_piers | Ada, işletmeciye, yakaya ya da bir noktaya yakınlığa göre iskeleler | "Mısır Çarşısı'na en yakın iskele hangisi, oradan kimler kalkıyor?" |
next_departures | Bir iskeleden sıradaki kalkışlar; nereye gittikleri, nerelere uğradıkları | "Karaköy'den Kadıköy'e bir sonraki vapur kaçta?" |
plan_trip | İki iskele arasında direkt seferler; daha hızlıysa tek aktarmalı yolculuk | "Ortaköy'deyim. Öğleden sonra Büyükada'ya nasıl giderim?" |
boats_now | Vapurlar şu anda ya da günün herhangi bir saatinde nerede | "Şu anda Boğaz'ı geçen bütün vapurları göster." |
boat_journey | Tek bir seferin uğradığı iskeleler ve saatleri | "Eminönü'nden 17:00'de kalkan Turyol Karaköy'e uğruyor mu?" |
timetable | Bir iskelenin ya da bir hattın bütün günlük tarifesi | "Pazar günü Heybeliada'dan dönen son vapur kaçta?" |
list_operators | İşletmeciler, kendi tarife sayfaları ve logoları | "Iskelesi'nde hangi vapur işletmecilerinin tarifesi var?" |
data_sources | Her verinin nereden geldiği ve en son ne zaman okunduğu | "Kullandığın Şehir Hatları tarifesi ne kadar güncel?" |
İskele adlarında esnek davranır. kadikoy, Kadıköy ve KADIKÖY İSKELESİ aynı yeri bulur; eminonu turyol ise Turyol'un Eminönü'ndeki kendi iskelesi demektir.
Veriler hakkında bilmeniz gerekenler
Vapur konumları tahminidir. İstanbul'un vapurları konumlarını yayımlamıyor. Her vapuru tarifesine bakarak hattı üzerinde bir yere koyuyoruz: vaktinde gidiyorsa olması gereken yere. Her konum positionSource: "estimated" olarak işaretlenir ve asistanınıza da bunu söylemesi bildirilir.
Saatler tarifedir, canlı sefer bilgisi değildir. Tarifeleri her gün Şehir Hatları, Turyol, Mavi Marmara ve İDO'dan okuyoruz. Hava muhalefeti seferleri iptal ettirir, tarifeler mevsime göre değişir. Yola çıkmadan önce işletmeciye bakın; her yanıt işletmecinin kendi tarife sayfasına bağlantı verir.
Her seferin uğradığı iskeleler kendine aittir. Turyol'un Eminönü'nden 17:00 seferi hafta içi doğrudan Kadıköy'e gider, hafta sonu Karaköy'e de uğrar. Veri bu ayrımı korur; yanıt, gerçekten bineceğiniz vapur içindir.
Bütün saatler İstanbul saatidir (yıl boyu UTC+03:00) ve saat farkıyla birlikte yazılır.
JSON API de var
Aynı veriler HTTPS üzerinden düz JSON olarak da sunulur; tanımı OpenAPI 3.1 biçimindedir:
| Uç nokta | Ne döndürür |
|---|---|
GET /v1/network | İşletmeciler, iskeleler ve hatlar |
GET /v1/piers/{id}/departures | Bir iskeleden sıradaki kalkışlar |
GET /v1/sailings?date=YYYY-MM-DD | Bir günün bütün seferleri, uğradıkları iskelelerle |
GET /v1/vessels | Şu anda seferde olan vapurlar |
GET /v1/health | Her veri kaynağı ve en son ne zaman okunduğu |
Dil modelleri için bir llms.txt, sunucuları kendi kendine keşfeden MCP istemcileri için de bir sunucu kartı bulunur.
Adil kullanım
MCP sunucusunda üst sınır, IP adresi başına dakikada 600 istektir; aşıldığında yanıt HTTP 429 olur. Yanıtlar önbelleğe alınır; lütfen sürekli sorgulamak yerine cache-control başlığına uyun. Kesintisiz çalışma sözü vermiyoruz: bu, Iskelesi uygulamasının da kullandığı hizmetin ta kendisi. Kullanım koşulları geçerlidir.
Kaynak gösterimi
İskeleler ve hatlar: Kaynak: İBB Açık Veri Portalı. Tarifeler işletmecilerine aittir: Şehir Hatları, Turyol, Mavi Marmara ve İDO. Iskelesi'nin İBB veya herhangi bir işletmeciyle bağlantısı yoktur. Bu verilerle bir şey geliştirirseniz kaynağı belirtin ve kullanıcılarınıza işletmeciye bakmalarını söyleyin.
Sorunuz mu var, yanlış görünen bir şey mi? ferry@iskelesi.com