ehliyet.digital
Türkiye ehliyet (sürücü belgesi) sınavına ücretsiz hazırlık platformu.
MEB MTSK müfredatına uygun 43 ders notu, 80 hap bilgi, 200 çıkmış sınav sorusu ve gerçek formatta deneme sınavları. Reklamsız, açık kaynak.
🌐 Site: ehliyet.digital
📄 LLM dizini: llms.txt · llms-full.txt
🔌 MCP: ehliyet-production.up.railway.app/mcp · MCP Market · Smithery · MCP Registry: io.github.merlhn/ehliyet-digital
Ne içerir?
| İçerik | Adet | Açıklama |
|---|
| Ders notları | 43 | 4 kategoride sınav odaklı konu anlatımı |
| Hap bilgiler | 80 | Tek cümlelik ezberlenecek kurallar |
| Atomik özetler | ~560 | Her ders sayfasında makine-okunur bilgi satırları |
| Sınav soruları | 200 | 4 deneme sınavından çıkmış sorular + cevaplar |
| Bireysel soru sayfaları | 186 | Her soru kendi URL'inde, cevap + açıklama ile |
| Bireysel hap bilgi sayfaları | 80 | Her hap bilgi kendi URL'inde, bağlam + ilgili ders ile |
Ders kategorileri
| Kategori | Konu sayısı | Sınav dağılımı |
|---|
| İlk Yardım | 12 | 12 soru (%24) |
| Trafik ve Çevre Bilgisi | 11 | 23 soru (%46) |
| Araç Tekniği (Motor) | 15 | 9 soru (%18) |
| Trafik Adabı | 5 | 6 soru (%12) |
- 50 soru, 45 dakika
- Her doğru cevap 2 puan, yanlış doğruyu götürmez
- Geçme notu: 70 puan (en az 35 doğru)
API
Tüm verilere programatik erişim — CORS açık, kimlik doğrulama yok.
REST API (Vercel)
curl "https://ehliyet.digital/api/questions?section=ilk_yardim&count=5"
curl "https://ehliyet.digital/api/quick-facts?section=trafik_ve_cevre"
curl "https://ehliyet.digital/api/mock-exam"
curl "https://ehliyet.digital/api/lesson-summary?section=arac_teknigi&topic=fren"
Endpoint'ler:
| Endpoint | Parametreler | Açıklama |
|---|
/api/questions | section, count | Rastgele soru döner |
/api/quick-facts | section | Hap bilgiler |
/api/mock-exam | — | 50 soruluk tam deneme |
/api/lesson-summary | section, topic | Ders atomik özeti |
section değerleri: ilk_yardim, trafik_ve_cevre, arac_teknigi, trafik_adabi, all
Örnek yanıt
{
"count": 1,
"section": "ilk_yardim",
"source": "ehliyet.digital",
"questions": [
{
"id": "sinav1-q02",
"exam": "Sınav 1",
"section": "İlk Yardım",
"stem": "Yetişkinlerde temel yaşam desteği ile ilgili uygulamalardan hangisi doğrudur?",
"options": [
"A) Göğüs kemiği 3 cm aşağı inecek şekilde bası yapılması",
"B) Temel yaşam desteğine yapay solunum ile başlanması",
"C) 30 kalp masajı, 2 yapay solunum şeklinde uygulanması",
"D) Kalp masajı hızının dakikada 30 bası olacak şekilde ayarlanması"
],
"correct_index": 2,
"correct_letter": "C",
"correct_text": "30 kalp masajı, 2 yapay solunum şeklinde uygulanması",
"has_image": false
}
]
}
MCP Sunucusu
AI agent'lar Model Context Protocol ile doğrudan bağlanabilir.
Remote (canlı):
Streamable HTTP: https://ehliyet-production.up.railway.app/mcp (önerilen)
SSE (eski): https://ehliyet-production.up.railway.app/sse
Claude Desktop yapılandırması:
{
"mcpServers": {
"ehliyet-digital": {
"type": "http",
"url": "https://ehliyet-production.up.railway.app/mcp"
}
}
}
Lokal çalıştırma:
cd mcp
pip install -r requirements.txt
python server.py
python server.py --http
Araçlar:
| Araç | Açıklama |
|---|
get_practice_questions(section, count) | Rastgele soru döner |
get_quick_facts(section) | Hap bilgiler |
generate_mock_exam() | 50 soruluk deneme sınavı |
get_lesson_summary(section, topic) | Ders atomik özeti |
explain_answer(question_id) | Soru açıklaması + ilgili dersler |
Veri dosyaları
Makine-okunur JSON formatında:
Teknoloji
- Frontend: Statik HTML/CSS/JS — build adımı yok, SSR
- Hosting: Vercel (site) + Railway (MCP)
- Auth: Firebase (Google OAuth)
- Veritabanı: Firestore (yalnızca kullanıcı profili ve sınav sonuçları)
- Analytics: GA4 (custom event'ler: log_in (her başarılı Google girişi; yeni_uye, sayfa), standart_sign_up, sign_up_end_of_exam_no_1, exam_start / exam_complete (panel), start_exam_1 / exam_1_complete (web Sınav 1), exam_abandon, result_gate_view, banner_click, feedback_submit; sınav event'leri
kaynak = web / panel taşır)
Yerelde çalıştırma
python3 -m http.server 8000
Proje yapısı
├── index.html Ana sayfa
├── dersler/ 43 ders notu (4 kategori)
├── hap-bilgiler/ 80 hap bilgi (4 kategori)
├── ehliyet-sinav-sorulari/ 20 örnek soru + 186 sorunun dizini; alt dizinler: konu bazlı soru sayfaları
├── deneme-sinavi/ Herkese açık deneme sınavı (yalnız Sınav 1, giriş gerekmez)
├── ehliyet-fiyatlari/ 2026 ehliyet fiyatları (harç, sınav, kurs)
├── soru/ 186 bireysel soru sayfası
├── panel/ Giriş gerektiren alan (sınavlar)
├── api/ REST API (Vercel serverless)
├── mcp/ MCP sunucusu + veri dosyaları
├── assets/js/questions-*.js Soru bankaları (4 sınav)
├── tools/ Üretici scriptler
│ ├── schema-uret.py JSON-LD yapısal veri
│ ├── sitemap-uret.py sitemap.xml
│ ├── llms-uret.py llms-full.txt
│ ├── feed-uret.py RSS feed + discovery link
│ ├── soru-sayfa-uret.py Bireysel soru sayfaları
│ ├── hap-sayfa-uret.py Bireysel hap bilgi sayfaları
│ ├── konu-deneme-uret.py Panel konu denemesi sayfası
│ ├── banner-ekle.py Header üstü deneme sınavı banner'ı (zincirin en sonunda çalışır)
│ ├── atomik-ekle.py Ders atomik özetleri
│ ├── cevap-ac.py Soru cevaplarını HTML'e taşı
│ ├── indexnow.py Değişen sayfaları Bing/IndexNow'a bildir
│ └── mcp-veri-uret.py MCP JSON veri dosyaları
├── llms.txt AI/LLM site dizini
├── llms-full.txt Detaylı içerik dizini
├── feed.xml RSS feed
├── sitemap.xml 251 URL
├── robots.txt AI tarayıcıları açık
└── 404.html Özel hata sayfası
İçerik kaynakları
- MEB Motorlu Taşıt Sürücüleri Kursu (MTSK) müfredatı
- 2918 sayılı Karayolları Trafik Kanunu ve ilgili yönetmelikler
- Türkiye Kızılay Derneği ilk yardım eğitim materyalleri
- Gerçek MTSK e-sınavlarında çıkmış sorular
Lisans
Bu proje açık kaynak olarak yayınlanmıştır. İçerikler MEB MTSK müfredatından derlenmiştir.
İletişim