📖 tdk-sozluk

TDK'nin (Türk Dil Kurumu) resmi sözlük API'sini kolayca kullanmanızı sağlayan Node.js modülü.

Kelime anlamlarını, atasözlerini, deyimleri, etimolojik bilgileri ve çok daha fazlasını tek bir modülle çekin.

✨ Neler Yapabilirsiniz?

• � 8 Farklı Sözlükte Arama — Güncel Türkçe, Batı Kökenli, Tarama, Derleme, Atasözleri, Yabancı Karşılıklar, Eren Etimoloji, Köken Bilgisi
• 📅 Günlük İçerik — Günün kelimesi, deyimi, kuralı ve sıkça karıştırılan sözler
• 🔊 Sesli Okunuş — Kelimelerin WAV formatında sesli okunuş linkleri
• 🤟 Türk İşaret Dili — Harflerin işaret dili GIF görselleri
• 🧹 HTML Temizleme — API yanıtlarındaki HTML etiketlerini otomatik temizleme
• 🛡️ Hata Yönetimi — Anlık ve detaylı hata mesajları

📦 Kurulum

npm install tdk-sozluk

🚀 Hızlı Başlangıç

const tdk = require('tdk-sozluk');

(async () => {
  // Bir kelimenin anlamını öğren
  const sonuc = await tdk.guncelSozluk.ara('araba');
  console.log(sonuc[0].anlamlarListe[0].anlam);
  // → "Tekerlekli, motorlu veya motorsuz her türlü kara taşıtı"

  // Günün kelimesini al
  const kelime = await tdk.icerik.gununKelimesi();
  console.log(kelime);

  // Kelimenin sesli okunuşunu al
  const sesLink = await tdk.yazim.sesGetir('araba');
  console.log(sesLink);
  // → "https://sozluk.gov.tr/ses/a3672.wav"
})();

📚 Sözlükler

Güncel Türkçe Sözlük

TDK'nin ana sözlüğü. Kelimelerin anlamları, örnekleri, atasözleri ve bileşik kelimeleri döner.

const sonuc = await tdk.guncelSozluk.ara('araba');

// sonuc[0].madde          → "araba"
// sonuc[0].anlam_say      → "2"
// sonuc[0].anlamlarListe  → [ { anlam: "Tekerlekli, motorlu...", ... }, ... ]
// sonuc[0].atasozu        → [ { madde: "araba devrilince yol gösteren çok olur" }, ... ]
// sonuc[0].birlesikler    → "araba araba, araba vapuru, at arabası, ..."

Batı Kökenli Kelimeler Sözlüğü

Türkçeye Batı dillerinden girmiş kelimelerin kökenleri ve anlamları.

const sonuc = await tdk.batiKokenli.ara('argo');

// sonuc[0].sozcuk   → "argo"
// sonuc[0].kistdil  → "Fr."
// sonuc[0].dilacik  → "argot"
// sonuc[0].anlam    → "1. Her yerde ve her zaman kullanılmayan..."

Tarama Sözlüğü

Tarihî Türkçe eserlerdeki kelimelerin sözlüğü.

// Kelime ara
const sonuc = await tdk.tarama.ara('bitik');

// ID ile detay getir
const detay = await tdk.tarama.getirId(2087);

Derleme Sözlüğü

Türkiye halk ağızlarından derlenen kelimelerin sözlüğü.

const sonuc = await tdk.derleme.ara('çellig');

// sonuc[0].madde  → "çellig"
// sonuc[0].anlam  → "Çocukların çelik çomak oyununda kullandıkları küçük değnek."
// sonuc[0].sehir  → "-Burdur"

Atasözleri ve Deyimler Sözlüğü

Türkçedeki atasözleri ve deyimleri arayın.

const sonuc = await tdk.atasozu.ara('bir kalem geçmek');

// sonuc[0].sozum   → "bir kalem geçmek"
// sonuc[0].turu2   → "Deyim"
// sonuc[0].anlami  → "boş vermek, bir an için göz ardı etmek..."

Yabancı Sözlere Karşılıklar Kılavuzu

Yabancı kökenli kelimelere önerilen Türkçe karşılıklar.

const sonuc = await tdk.yabanciKarsiliklar.ara('voleybol');

// sonuc[0].kkelime    → "voleybol"
// sonuc[0].kkoken     → "İng. volleyball"
// sonuc[0].kkarsilik  → "uçan top"
// sonuc[0].anlam      → "Altışar kişilik iki takım arasında..."

Eren Türk Dilinin Etimolojik Sözlüğü

Hasan Eren'in etimolojik çalışmasına dayalı kelime köken bilgileri.

const sonuc = await tdk.erenEtimoloji.ara('aba');

// sonuc[0].madde     → "aba"
// sonuc[0].anlam1    → "'yünden yapılan bir çeşit kaba ve kalın kumaş'"
// sonuc[0].aciklama  → "~ Az aba esk. 'yünden yapılan kolsuz...'"

Köken Bilgisi Sözlüğü (Deneme Sürümü)

Kelimelerin detaylı tarihî köken bilgilerini içerir.

const sonuc = await tdk.kokenBilgisi.ara('araba');

// sonuc[0].word       → "araba"
// sonuc[0].meaning    → "Tekerlekli, motorlu veya motorsuz her türlü kara taşıtı."
// sonuc[0].etimology  → "Türk dili tarihinde ilk defa Codex Cumanicus'ta..."

📅 Günlük İçerik

TDK'nin her gün güncellenen içeriklerine tek bir fonksiyonla veya ayrı ayrı erişin.

// Tüm günlük içeriği bir seferde al
const icerik = await tdk.icerik.getir();
// icerik.kelime      → Günün kelimesi
// icerik.atasoz      → Günün atasözü/deyimi
// icerik.kural       → Günün kuralı
// icerik.karistirma  → Sıkça karıştırılan sözler
// icerik.syyd        → Sıkça yapılan yanlışlar
// icerik.yabanci     → Yabancı söz karşılığı
// icerik.sayac       → Toplam ziyaretçi sayısı

// Ya da tek tek al
const kelime   = await tdk.icerik.gununKelimesi();
const atasoz   = await tdk.icerik.gununAtasozu();
const kural    = await tdk.icerik.gununKurali();
const karist   = await tdk.icerik.karistirilanSozler();
const yanlislar = await tdk.icerik.sikYapilanYanlislar();
const yabanci  = await tdk.icerik.gununYabanciKarsiligi();

🔊 Yazım ve Sesli Okunuş

Kelimelerin yazım bilgilerini ve sesli okunuş linklerini alın.

// Yazım bilgisi al
const yazim = await tdk.yazim.ara('araba');
// [{ yazim_id: '3822', sozu: 'araba', ekler: '', seskod: 'a3672' }]

// Sesli okunuş linkini doğrudan al
const sesLink = await tdk.yazim.sesGetir('araba');
// → "https://sozluk.gov.tr/ses/a3672.wav"

// Ses kodundan manuel URL oluştur
const url = tdk.sesUrl('a3672');
// → "https://sozluk.gov.tr/ses/a3672.wav"

Not: Her kelimenin sesli okunuşu bulunmayabilir. sesGetir() bu durumda null döner.

🤟 Türk İşaret Dili

Harflerin Türk İşaret Dili karşılıklarının GIF görsellerine erişin.

const gif = tdk.isaretDiliUrl('a');
// → "https://sozluk.gov.tr/assets/img/isaret/a.gif"

🧹 Yardımcı Fonksiyonlar

// API yanıtlarındaki HTML etiketlerini temizle
tdk.htmlTemizle('<strong>araba</strong>');
// → "araba"

📋 Hızlı Referans Tablosu

| Modül | Metod | Açıklama | |-------|-------|----------| | tdk.guncelSozluk | .ara(kelime) | Güncel Türkçe Sözlük'te arama | | tdk.batiKokenli | .ara(kelime) | Batı kökenli kelimeler sözlüğü | | tdk.tarama | .ara(kelime) | Tarama Sözlüğü'nde arama | | tdk.tarama | .getirId(id) | Tarama Sözlüğü'nden ID ile detay | | tdk.derleme | .ara(kelime) | Derleme Sözlüğü'nde arama | | tdk.atasozu | .ara(kelime) | Atasözleri ve deyimler arama | | tdk.yabanciKarsiliklar | .ara(kelime) | Yabancı söz karşılıkları | | tdk.erenEtimoloji | .ara(kelime) | Eren Etimolojik Sözlük | | tdk.kokenBilgisi | .ara(kelime) | Köken Bilgisi Sözlüğü | | tdk.icerik | .getir() | Tüm günlük içerik | | tdk.icerik | .gununKelimesi() | Günün kelimesi | | tdk.icerik | .gununAtasozu() | Günün atasözü/deyimi | | tdk.icerik | .gununKurali() | Günün kuralı | | tdk.icerik | .karistirilanSozler() | Sıkça karıştırılan sözler | | tdk.icerik | .sikYapilanYanlislar() | Sıkça yapılan yanlışlar | | tdk.icerik | .gununYabanciKarsiligi() | Günün yabancı söz karşılığı | | tdk.yazim | .ara(kelime) | Yazım bilgisi ve ses kodu | | tdk.yazim | .sesGetir(kelime) | Sesli okunuş WAV linki | | tdk | .sesUrl(sesKodu) | Ses kodu → WAV URL | | tdk | .isaretDiliUrl(harf) | Harf → İşaret dili GIF URL | | tdk | .htmlTemizle(html) | HTML etiketlerini temizle |

⚙️ Gereksinimler

• Node.js 14.0.0 veya üzeri
• axios (otomatik kurulur)

📝 Lisans

MIT © 2026