POST /v1/demo/adres · anahtarsız deneme

İl › İlçe: İzmirKonak
Mahalle: Alsancak
Yol: Kıbrıs Şehitleri Caddesi
Kapı: No 42Daire 3güven 1,00 · konum sokak düzeyindesicilde doğrulandı: il · ilçe · mahalle · yol

Düzeltildi

~~Mah~~Mahallesi
CdCaddesi
~~42/3~~No 42, Daire 3
~~Kibris Sehitleri~~Kıbrıs Şehitleri

Yanıtın JSON'u

{
  "binaNo": "42",
  "daire": "3",
  "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"
}

Türkiye verisi için tek anahtar.

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.

Tek anahtar, on yön.

Her alan kendi ucunda; kimlik, kredi ve hata biçimi ortak. Yeni bir alan eklendiğinde anahtarın da kredin de aynı kalır.

Adres
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.
Kibris Sehitleri Cd.Kıbrıs Şehitleri Caddesi
Toplusu da var: CSV yükle, sütunları eklenmiş temiz CSV'yi panelden indir.
1 kredi · ayrıştırma ücretsiz
IBAN
POST /v1/iban/dogrula
ISO 13616 kontrolü, banka kodu ve hesap numarası; dış servise gitmeden.
TR33 0006 1005 1978…26
geçerli
TR33 0006 1005 1978…27
kontrol basamağı
1 kredi · banka listesi ücretsiz
Doğrulama
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 ••• •• ••
gsm
0850 ••• •• ••
ulusal_850
1 kredi · numara başına
TCMB kuru
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
Kargo
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
Nöbetçi eczane
GET /v1/eczane/nobetci
Günün nöbetçi eczaneleri, ilçeye göre süzülür: unvan, adres, iş yeri telefonu, konum. Eczacı adı ve cep numarası verilmez.
İzmirBursaAntalya3 il, büyüyor
1 kredi · il başına

Akaryakıt fiyatı
GET /v1/akaryakit/fiyat?il=istanbul
EPDK'ya bildirilen bayi fiyatları: 81 il, 41 marka, 11 ürün; İstanbul Anadolu ve Avrupa ayrı. Günde iki tur, her fiyatın tarihi yanıtta.
1 kredi · il başına
Benzin 95
78,83–96,35
Motorin
95,55–101,19
İstanbul, 22 Eylül 2026; en düşük – en yüksek, TL/litre. Bayiye bildirilen fiyat; pompadaki farklı olabilir.
Hal fiyatı
GET /v1/hal/fiyat?urun=domates
Ticaret Bakanlığı Hal Kayıt Sistemi'nin günlük bülteni: yaklaşık 400 ürün ve cins, ortalama fiyat ve işlem hacmi. Türkiye geneli; konvansiyonel, iyi tarım, organik ayrı.
1 kredi · sorgu başına
Domates 13.482 ton
18,49
Salatalık 3.362 ton
14,78
Limon 3.876 ton
20,99
22 Eylül 2026 bülteni (21 Eylül verisi), konvansiyonel, en çok işlem gören cins; TL/kg. Kaynak hatalı değer olabileceğini kendisi yazıyor.

E-ticaret kuralları
Sipariş sayfası ve destek ekibi için tarih hesabı: kargonun tahmini varışı, cayma hakkının ve faturanın son günü, paketin desisi. Resmî tatiller ve arife yarım günleri iş günü sayılmaz.
POST /v1/kargo/teslim-tahmini
İstanbul → Van, 27 Ekim4 Kasım1 kredi
GET /v1/ticaret/cayma
teslim 26 Ekim9 Kasımücretsiz
GET /v1/ticaret/fatura-suresi
teslim 26 Ekim2 Kasımücretsiz
POST /v1/kargo/desi
30 × 40 × 20 cm, 5 kg8 desiücretsiz
GET /v1/takvim/is-gunu-ekle
27 Ekim + 3 iş günü, 29 Ekim tatil2 Kasımücretsiz
Teslim tarihi tahmindir, taşıyıcının taahhüdü değil. Cayma ve fatura süreleri Mesafeli Sözleşmeler Yönetmeliği ve VUK'tan hesaplanır; hukuki tavsiye değildir. Dayanak
Metin ve KVKK araçları
POST /v1/kvkk/maskele · 1 kredi
Modele göndermeden kişisel veriyi temizle.
IBAN: TR33 0006 1005 1978 6457 8413 26, e-posta ornek@example.comIBAN: **** **** **** **** **** **** **, e-posta *****@*******.***
TCKN, IBAN, telefon, kart numarası, e-posta ve plaka bulunur; ilk dördü kontrol hanesiyle. Kural tabanlıdır, yüzde yüz değildir; ad ve adres aranmaz. Metin saklanmaz.
POST /v1/metin/yaziyla
1250,50bin iki yüz elli TL elli kuruşücretsiz
POST /v1/metin/slug
Çağlayan Şişli Güneş Ürünlericaglayan-sisli-gunes-urunleriücretsiz
POST /v1/metin/sirala
Zeytin, çay, ırmak, İnci, camcam, çay, ırmak, İnci, Zeytinücretsiz
POST /v1/metin/ad-normalize
iSTANBUL ŞUBESİİstanbul Şubesiücretsiz

İddia değil, ölçüm.

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.

Veri nereden geliyor

81 il, 973 ilçe, 50.046 mahalle adı · ubeydeozdmr/turkiye-api · MIT
1.146.720 sokak (NVİ/MAKS sicili) · onurusluca/turkey-geo-api · MIT
122.581 sokağın koordinatı, posta kodu → ilçe · Overture Places'ten türetildi · CDLA-Permissive 2.0

OpenStreetMap bilerek kullanılmıyor: ODbL, API üzerinden sunulan türev veriyi de kendi lisansına bağlıyor. Bütün kaynaklar, lisansları ve kaldırma talebi: Kaynaklar.

Yol adı sokak sicilinde bulundu: %84,2
Yol adı çıkarıldı: %84,3
Bina no çıkarıldı: %72,4
Kullanılabilir koordinat: %4,8
Uçtan uca, adres başına: 84 µs

Koduna REST, ajanına MCP.

Aynı anahtar, aynı kredi. İkisinin arkasında aynı motor çalışıyor.

REST

Açık

$ 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.

MCP

Açık

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.

Her ay 1.000 kredi ücretsiz.

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.

Uç başına kredi
İşlem	Kredi
Adres çözümle ve doğrula`POST /v1/address/resolve`	1
Toplu çözümleme`POST /v1/address/resolve`	1adres başına
CSV temizleme (panelden de)`POST /v1/address/temizle`	1tekil adres başına
Adres ayrıştır (sicile bakmaz)`POST /v1/address/parse`	ücretsiz
IBAN doğrula`POST /v1/iban/dogrula`	1IBAN başına
TCMB banka kodu listesi`GET /v1/iban/bankalar`	ücretsiz
Günlük TCMB kurları`GET /v1/kur`	ücretsiz
Para birimi çevir`POST /v1/kur/cevir`	ücretsiz
Günlük ECB referans kurları`GET /v1/kur/ecb`	ücretsiz
TCKN algoritma kontrolü`POST /v1/dogrula/tckn`	1numara başına
VKN algoritma kontrolü`POST /v1/dogrula/vkn`	1numara başına
Telefon numarası kontrolü`POST /v1/dogrula/telefon`	1numara başına
Nöbetçi eczaneler`GET /v1/eczane/nobetci`	1il başına; boş liste ücretsiz
Akaryakıt bayi fiyatları (EPDK)`GET /v1/akaryakit/fiyat`	1il başına; boş liste ücretsiz
Hal fiyat bülteni`GET /v1/hal/fiyat`	1sorgu başına; boş liste ücretsiz
Kargo takibi (Yurtiçi)`GET /v1/kargo/takip`	1
Kargo teslim tahmini`POST /v1/kargo/teslim-tahmini`	1gönderi başına
Desi hesabı`POST /v1/kargo/desi`	ücretsiz
Cayma hakkı son günü`GET /v1/ticaret/cayma`	ücretsiz
Fatura düzenleme süresi`GET /v1/ticaret/fatura-suresi`	ücretsiz
İş günü ekle (resmî tatiller)`GET /v1/takvim/is-gunu-ekle`	ücretsiz
Kişisel veri maskeleme`POST /v1/kvkk/maskele`	1metin başına
Tutarı yazıyla`POST /v1/metin/yaziyla`	ücretsiz
Türkçe slug`POST /v1/metin/slug`	ücretsiz
Türkçe alfabetik sıralama`POST /v1/metin/sirala`	ücretsiz
Ad ve unvan büyük-küçük harf`POST /v1/metin/ad-normalize`	ücretsiz
Kalan kredi, anahtar yönetimi`GET /v1/kullanim`	ücretsiz

Kayıt yakında açılıyor.

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.

Yakında Kayıt

Bu sırada:

Türkiye verisi için tek anahtar.

Tek anahtar, on yön.

Adres

IBAN

Doğrulama

TCMB kuru

Kargo

Nöbetçi eczane

Akaryakıt fiyatı

Hal fiyatı

E-ticaret kuralları

Metin ve KVKK araçları

İddia değil, ölçüm.

Veri nereden geliyor

Koduna REST, ajanına MCP.

Her ay 1.000 kredi ücretsiz.

Kayıt yakında açılıyor.