POST /v1/demo/adres · anahtarsız deneme
{
"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"
}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
Form doldurma
il, ilçe, mahalle listeleri 81 · İstanbul’da 39 · Kadıköy’de 21
GET /v1/address/sokak-tamamla?il=istanbul&ilce=kadikoy&q=bagd
bagd Bağdat Caddesi
Listeler ücretsiz; sokak tamamlama 1 kredi, öneri yoksa ücretsiz.
Aynı adres mi?
POST /v1/address/ayni-mi
a Bağdat Caddesi 12/5 Kadıköy
b Bağdat Cad. No 12 Daire 5 Kadıköy
karar ayni_adres benzerlik 1
Karşılaştırma 1 kredi. Müşteri listesindeki tekrarları panelden tekilleştir: 1 kredi, dolu kayıt başına.
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/vergi-dairesi?ara=kadikoy
Kadıköy 34272 Kadıköy Vergi Dairesi Müdürlüğü
GİB listesindeki 1.093 vergi dairesi ve şube, koduyla. Ücretsiz.
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
TÜFE ve kira artışı
GET /v1/ekonomi/tufe
Ağustos 2026, yıllık %31,51 12 aylık ort. %31,79
GET /v1/ekonomi/kira-artis
20.000 TL konut, 15 Eylül yenileme en çok 26.358 TL
TÜİK’ten, kaynak gösterilerek; ücretsiz. Kira sınırı TBK m.344’ten; hukuki tavsiye değildir.
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
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.
77 il il listesi ve kaynaklar
1 kredi · il başına
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
İstanbul, 22 Eylül 2026; en düşük – en yüksek, TL/litre. Bayiye bildirilen fiyat; pompadaki farklı olabilir.
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
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.
GET /v1/deprem/son?saat=24&minBuyukluk=3
AFAD'dan, dakikada bir tazelenir: zaman (UTC ve Türkiye saati), büyüklük, derinlik, konum, il ve ilçe. Son 7 gün; saat, büyüklük ve ile göre süzülür. Resmî uyarının yerine geçmez.
1 kredi · sorgu başına
Son 24 saatte 3 ve üstü, en yeni üç olay. Sayfa derlenirken AFAD’dan alındı: 23 Eylül 2026 01:09; canlı uçta dakikada bir tazelenir.
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-tahminiGET /v1/ticaret/caymaGET /v1/ticaret/fatura-suresiPOST /v1/kargo/desiGET /v1/takvim/is-gunu-ekleVergi 2026, resmî belgeden
GET /v1/vergi/kdvGET /v1/vergi/gelir-vergisiGET /v1/vergi/parametrelerTeslim 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. Vergi değerleri resmî belgelerden, her Ocak elle güncellenir. Hukuki ya da mali tavsiye değildir. Dayanak
POST /v1/kvkk/maskele · 1 kredi
Modele göndermeden kişisel veriyi temizle.
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/yaziylaPOST /v1/metin/slugPOST /v1/metin/siralaPOST /v1/metin/kisaltmaPOST /v1/metin/ad-normalize30.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. Bütün kaynaklar, lisansları ve kaldırma talebi: Kaynaklar.
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. 99 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, posta_kodu_ilce, plaka_il, barkod_kontrol, adres_listesi, ters_geokod, mesafe, sokak_tamamla, iban_dogrula, iban_toplu_dogrula, iban_bankalar, kur_listesi, kur_cevir, kur_ecb, nobetci_eczane, akaryakit_fiyat, son_depremler, ibb_trafik, ibb_otopark, ibb_hava_kalitesi, ibb_metro_durum, ibb_nokta_ara, altin_fiyati, baraj_doluluk, hava_durumu, vergi_dairesi_bul, tufe, kira_artis_orani, enerji_tarifesi, universite_listesi, program_ara, sinav_takvimi, avukatlik_ucreti, noter_ucreti, ilac_ara, gecis_ucreti, okul_ara, vergi_parametreleri, gelir_vergisi_hesapla, kdv_hesapla, mtv_hesapla, bordro_hesapla, tazminat_hesapla, asgari_ucret, trafik_cezasi, trafik_cezasi_indirim, harc, tapu_harci, emlak_vergisi, damga_vergisi, veraset_vergisi, hal_fiyat, resmi_gazete, tckn_dogrula, vkn_dogrula, telefon_dogrula, kargo_takip, takip_no_tani, kargo_etiketi, teslim_tahmini, is_gunu_ekle, namaz_vakitleri, hicri_tarih, kvkk_maskele, cayma_hakki, fatura_suresi, il_bilgi, nufus, il_ilceler, alan_kodu, bolge_listesi, yaziyla, slug, adres_ayni_mi, adres_kisaltma, turkce_sirala, ad_normalize, turkce_ek, tarih_ayristir, turkcelestir, metin_ayikla, desi, test_verisi_uret, resmi_tatiller, gun_bilgisi, is_gunu_say, futbol_ligler, futbol_takimlar, futbol_puan_durumu, futbol_fikstur, futbol_sonuclar, futbol_gol_kralligi, futbol_mac, futbol_form, futbol_h2h, futbol_olasilik, futbol_xg.
İkisi de yazıldı, henüz npm'de yayımlanmadı; aşağıdaki komutlar bugün çalışmaz. O güne kadar REST'i doğrudan, MCP'yi yukarıdaki kurulumla kullan.
adreskit TypeScript SDKHer uç için tipli metot, sıfır bağımlılık, fetch üstünde. Node 18+, tarayıcı, Workers, Deno ve Bun.
npm i adreskit
import { Adreskit } from 'adreskit';
const ak = new Adreskit({ anahtar: process.env.ADRESKIT_ANAHTAR });
await ak.adres.cozumle({ adres: 'cankaya ankara kızılay mah' });adreskit-mcp MCP köprüsüClaude Desktop, Cursor ve Windsurf için yerel stdio köprüsü; mcp-remote gerekmez. Araç tanımları sunucuda durur, paket güncellenmeden yeni araçlar görünür.
{
"mcpServers": {
"adreskit": {
"command": "npx",
"args": [
"-y",
"adreskit-mcp"
],
"env": {
"ADRESKIT_ANAHTAR": "ak_live_…"
}
}
}
}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 12 ay geçerli 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 | 1adres başına |
CSV temizleme (panelden de)POST /v1/address/temizle | 1tekil adres başına |
İki adres aynı mıPOST /v1/address/ayni-mi | 1karşılaştırma başına |
Müşteri listesi tekilleştirmePOST /v1/musteri/tekillestir | 1dolu kayıt başına |
Sokak adı tamamlamaGET /v1/address/sokak-tamamla | 1istek başına; öneri yoksa ücretsiz |
Koordinattan en yakın sokakGET /v1/address/ters | 1istek başına; sonuç yoksa ücretsiz |
IBAN doğrulaPOST /v1/iban/dogrula | 1IBAN başına |
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 (77 il)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ülteniGET /v1/hal/fiyat | 1sorgu başına; boş liste ücretsiz |
Son depremler (AFAD)GET /v1/deprem/son | 1sorgu başına; boş liste ücretsiz |
Altın ve serbest piyasa döviz fiyatıGET /v1/altin/fiyat | 1sorgu başına |
Baraj doluluk oranlarıGET /v1/su/baraj-doluluk | 1sorgu başına |
İstanbul trafik indeksi (İBB)GET /v1/ibb/trafik | 1sorgu başına |
İSPARK otoparkları ve boş yerGET /v1/ibb/otopark | 1sorgu başına; boş liste ücretsiz |
İSPARK otopark ayrıntısı ve tarifeGET /v1/ibb/otopark/{id} | 1sorgu başına; bulunamazsa ücretsiz |
İstanbul hava kalitesi ölçümü (İBB)GET /v1/ibb/hava | 1sorgu başına; ölçüm yoksa ücretsiz |
Metro İstanbul hat aksaklıklarıGET /v1/ibb/metro/durum | 1sorgu başına; aksaklık yoksa ücretsiz |
Hava durumu tahmini (MET Norway)GET /v1/hava/durum | 1sorgu başına |
Resmî Gazete: gün ya da sayıGET /v1/resmi-gazete | 1sorgu başına; boş liste ücretsiz |
Resmî Gazete başlıklarında araGET /v1/resmi-gazete/ara | 1sorgu başına; boş liste ücretsiz |
Kargo takibi (Yurtiçi)GET /v1/kargo/takip | 1 |
Kargo teslim tahminiPOST /v1/kargo/teslim-tahmini | 1gönderi başına |
Kargo etiketi adres bloğuPOST /v1/kargo/etiket | 1gönderi başına |
Kişisel veri maskelemePOST /v1/kvkk/maskele | 1metin başına |
Serbest metinden alan çıkarPOST /v1/metin/ayikla | 1metin başına |
Sağlamalı test verisiPOST /v1/test-verisi/uret | 1her başlanan 100 kayıt; ilk 100 ücretsiz |
Futbol puan durumuGET /v1/futbol/puan-durumu | 1sorgu başına; boş sonuç ücretsiz |
Fikstür: oynanmamış maçlarGET /v1/futbol/fikstur | 1sorgu başına; boş sonuç ücretsiz |
Maç sonuçları ve skorlarGET /v1/futbol/sonuclar | 1sorgu başına; boş sonuç ücretsiz |
Gol krallığıGET /v1/futbol/gol-kralligi | 1sorgu başına; boş sonuç ücretsiz |
Maç ayrıntısıGET /v1/futbol/mac/{id} | 1sorgu başına; bulunamazsa ücretsiz |
Takımın son maçları (form)GET /v1/futbol/takim/{id}/form | 1sorgu başına; boş sonuç ücretsiz |
İki takımın karşılaşmalarıGET /v1/futbol/h2h | 1sorgu başına; boş sonuç ücretsiz |
Şampiyonluk, yükselme ve düşme olasılığıGET /v1/futbol/olasilik | 1sorgu başına; boş sonuç ücretsiz |
xG: beklenen gol (Avrupa ligleri)GET /v1/futbol/xg | 1sorgu başına; boş sonuç ücretsiz |
Anahtarla çağrılır, krediden düşmez. Uç adresleri dokümanda.
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.