POST /v1/demo/adres · anahtarsız deneme
{
"binaNo": "42",
"daire": "3",
"postaKodu": "35220",
"hassasiyet": "sokak",
"guven": 1,
"dogrulanan": {
"il": true,
"ilce": true,
"mahalle": true,
"yol": true
},
"duzeltmeler": [
"Mah → Mahallesi",
"Cd → Caddesi",
"42/3 → No 42, Daire 3",
"Kibris Sehitleri → Kıbrıs Şehitleri"
],
"ayrisma": {
"serbest": [
"Konak",
"İzmir"
],
"mahalle": "Alsancak",
"yolAdi": "Kibris Sehitleri",
"yolTipi": "Caddesi",
"binaNo": "42",
"daire": "3"
},
"il": "İzmir",
"lat": 38.437595,
"lon": 27.143376,
"ilce": "Konak",
"mahalle": "Alsancak",
"yol": "Kıbrıs Şehitleri Caddesi"
}Adres, IBAN, TCKN, VKN ve telefon doğrulama, TCMB kuru ve kargo takibi. REST'ten ya da MCP'den, tek kredi havuzundan. Her ay 1.000 kredi ücretsiz.
Her alan kendi ucunda; kimlik, kredi ve hata biçimi ortak. Yeni bir alan eklendiğinde anahtarın da kredin de aynı kalır.
POST /v1/address/resolve
Dağınık adresi il, ilçe, mahalle, yol ve kapıya ayırır; yol adını sokak sicilinde doğrular.
Toplusu da var: CSV yükle, sütunları eklenmiş temiz CSV'yi panelden indir.
1 kredi · ayrıştırma ücretsiz
POST /v1/iban/dogrula
ISO 13616 kontrolü, banka kodu ve hesap numarası; dış servise gitmeden.
TR33 0006 1005 1978…26TR33 0006 1005 1978…271 kredi · banka listesi ücretsiz
POST /v1/dogrula/tckn · vkn · telefon
TCKN ve VKN kontrol haneleri, telefonun türü. Algoritmik: biçimi doğrular, kime ait olduğunu değil.
0532 ••• •• ••0850 ••• •• ••1 kredi · numara başına
GET /v1/kur · POST /v1/kur/cevir
Merkez Bankası'nın günlük yayını; geçmiş tarih ve para birimi çevirisi.
GET /v1/kur?tarih=2026-09-18ücretsiz
GET /v1/kargo/takip
Gönderi durumu ve hareketleri, taşıyıcıdan bağımsız tek biçimde. Gönderen ve alıcı adı dönmez.
Yurtiçi Kargo şimdilik yalnız bu
1 kredi
30.989 gerçek adres üzerinde. Doğruluk elle etiketlenmiyor: ayrıştırıcının bulduğu yol adı, aynı ilçenin sokak sicilinde aranıyor. Tekrarlanabilir ve tarafsız.
Koordinat zayıf taraf. Sicildeki 1.146.720 sokağın yalnız %10,7'sinin koordinatı var, kapı numarası veri seti hiç yok. Adreskit bir adres normalizasyon ve doğrulama motoru; çatı düzeyinde konum vermez.
OpenStreetMap bilerek kullanılmıyor: ODbL, API üzerinden sunulan türev veriyi de kendi lisansına bağlıyor.
Aynı anahtar, aynı kredi. İkisinin arkasında aynı motor çalışıyor.
$ curl -X POST "$ADRESKIT/v1/address/resolve" \
-H "authorization: Bearer ak_live_…" \
-H "content-type: application/json" \
-d '{"q":"kadikoy istanbul moda cad 14"}'
{
"il": "İstanbul",
"ilce": "Kadıköy",
"yol": "Moda Caddesi",
"binaNo": "14",
"guven": 0.85,
"duzeltmeler": ["cad → Caddesi"]
}$ADRESKIT = https://xacw6yute6famacx6a7tjafkfq0hqmug.lambda-url.eu-central-1.on.aws
Hata her uçta aynı biçimde: {"hata": "…"} ve anlamlı bir HTTP durum kodu.
Kurulacak paket yok: MCP adresi ve API anahtarı yeter. 12 araç, REST'le aynı kredi. Araç listesi ücretsiz; kredi yalnız araç çağrısında düşer.
Terminalde bir kez çalıştır:
claude mcp add --transport http adreskit https://xacw6yute6famacx6a7tjafkfq0hqmug.lambda-url.eu-central-1.on.aws/mcp \
--header "Authorization: Bearer ak_live_…"Tüm projelerde kullanmak için komuta --scope user ekle.
Cursor: ~/.cursor/mcp.json ya da projede .cursor/mcp.json. VS Code ve Streamable HTTP destekleyen diğer istemciler de url + headers ile bağlanır:
{
"mcpServers": {
"adreskit": {
"url": "https://xacw6yute6famacx6a7tjafkfq0hqmug.lambda-url.eu-central-1.on.aws/mcp",
"headers": {
"Authorization": "Bearer ${env:ADRESKIT_API_KEY}"
}
}
}
}Anahtarı ADRESKIT_API_KEY ortam değişkeninden okur; dosyaya yazmak zorunda kalmazsın. Yanıt JSON, SSE akışı yok.
Claude Desktop yapılandırmada yalnız yerel komut çalıştırır; uzak sunucuya mcp-remote köprüsüyle bağlanılır. claude_desktop_config.json içine:
{
"mcpServers": {
"adreskit": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://xacw6yute6famacx6a7tjafkfq0hqmug.lambda-url.eu-central-1.on.aws/mcp",
"--header",
"Authorization:${ADRESKIT_AUTH}"
],
"env": {
"ADRESKIT_AUTH": "Bearer ak_live_…"
}
}
}
}Node.js kurulu olmalı. Başlık ortam değişkeninden verilir, çünkü argümandaki boşluk bazı platformlarda bölünüyor. Kaydettikten sonra uygulamayı yeniden başlat. Bu köprü yolunu henüz geniş denemedik; takılırsan geri bildirimini volkanerenee@gmail.com adresine bekliyoruz.
Araçlar: adres_coz, adres_toplu_coz, adres_ayristir, iban_dogrula, iban_toplu_dogrula, iban_bankalar, kur_listesi, kur_cevir, tckn_dogrula, vkn_dogrula, telefon_dogrula, kargo_takip.
Bütün API'ler aynı havuzdan harcar; kalan krediyi tek sayı olarak görürsün (GET /v1/kullanim).
Kredi paketleri henüz satışta değil; ödeme altyapısı açıldığında süresiz kredi paketleri gelecek. Aylık ücretsiz kota her zaman önce harcanır.
| İşlem | Kredi |
|---|---|
Adres çözümle ve doğrulaPOST /v1/address/resolve | 1 |
Toplu çözümlemePOST /v1/address/resolve | 1 / adres başına |
CSV temizleme (panelden de)POST /v1/address/temizle | 1 / tekil adres başına |
Adres ayrıştır (sicile bakmaz)POST /v1/address/parse | ücretsiz |
IBAN doğrulaPOST /v1/iban/dogrula | 1 / IBAN başına |
TCMB banka kodu listesiGET /v1/iban/bankalar | ücretsiz |
Günlük TCMB kurlarıGET /v1/kur | ücretsiz |
Para birimi çevirPOST /v1/kur/cevir | ücretsiz |
Günlük ECB referans kurlarıGET /v1/kur/ecb | ücretsiz |
TCKN algoritma kontrolüPOST /v1/dogrula/tckn | 1 / numara başına |
VKN algoritma kontrolüPOST /v1/dogrula/vkn | 1 / numara başına |
Telefon numarası kontrolüPOST /v1/dogrula/telefon | 1 / numara başına |
Kargo takibi (Yurtiçi)GET /v1/kargo/takip | 1 |
Kalan kredi, anahtar yönetimiGET /v1/kullanim | ücretsiz |
Anahtar dağıtımı kısa süre sonra başlıyor; açıldığında kart istemeyeceğiz ve her ay 1.000 kredi ücretsiz olacak. O zamana kadar adres motorunu yukarıdaki levhada anahtarsız deneyebilirsin.