📖 tdk-sozluk

TDK'nin (Türk Dil Kurumu) sözlük servislerini kolay ve düzenli bir API ile kullanmanızı sağlayan Node.js modülü.

Kelime anlamlarını, atasözlerini, deyimleri, köken bilgilerini, günlük içerikleri ve sesli okunuş bağlantılarını tek paket üzerinden alabilirsiniz.

✨ Özellikler

• 📚 8 farklı sözlükte arama: Güncel Türkçe Sözlük, Tarama Sözlüğü, Derleme Sözlüğü, Atasözleri ve Deyimler Sözlüğü, Batı Kökenli Kelimeler Sözlüğü, Yabancı Sözlere Karşılıklar Kılavuzu, Eren Etimoloji, Köken Bilgisi
• 📅 Günlük içerikler: Günün kelimesi, atasözü, yazım kuralı ve sık yapılan yanlışlar
• 🔊 Sesli okunuş: Kelimelerin ses dosyası bağlantılarını alma
• 🤟 Türk İşaret Dili bağlantıları: Harf bazlı GIF adresleri
• 🧹 Otomatik veri temizleme: HTML etiketleri ve gereksiz boşluklar temizlenmiş JSON sonuçları
• 🧠 VS Code desteği: Otomatik tamamlama, açıklama ve tip ipuçları
• 📦 CommonJS ve ESM desteği: Hem require, hem import ile kullanım

📦 Kurulum

npm install tdk-sozluk

🚀 Hızlı Başlangıç

CommonJS

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

(async () => {
  const sonuc = await tdk.guncel('araba');
  console.log(sonuc[0].anlamlarListe[0].anlam);

  const kelime = await tdk.gununKelimesi();
  console.log(kelime[0].madde);

  const sesLink = await tdk.sesGetir('araba');
  console.log(sesLink);
})();

ESM

import tdk, { guncel, gununKelimesi, sesGetir } from 'tdk-sozluk';

const sonuc = await guncel('araba');
console.log(sonuc[0].anlamlarListe[0].anlam);

const kelime = await gununKelimesi();
console.log(kelime[0].madde);

const sesLink = await sesGetir('araba');
console.log(sesLink);

await kullanmak istemiyorsanız

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

tdk.guncel('araba').then((sonuc) => {
  console.log(sonuc[0].anlamlarListe[0].anlam);
});

Not: Bu paket TDK servislerine HTTP isteği gönderdiği için sonuçlar Promise olarak döner. Bu nedenle await veya .then() kullanımı gereklidir.

📚 Sözlükler

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

const sonuc = await tdk.guncel('araba');

// sonuc[0].madde
// sonuc[0].anlam_say
// sonuc[0].anlamlarListe
// sonuc[0].atasozu
// sonuc[0].birlesikler

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

const sonuc = await tdk.bati('argo');

// sonuc[0].sozcuk
// sonuc[0].kistdil
// sonuc[0].dilacik
// sonuc[0].anlam

Tarama Sözlüğü

const sonuc = await tdk.tarama('bitik');
const detay = await tdk.taramaDetay(2087);

Derleme Sözlüğü

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

// sonuc[0].madde
// sonuc[0].anlam
// sonuc[0].sehir

Atasözleri ve Deyimler Sözlüğü

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

// sonuc[0].sozum
// sonuc[0].turu2
// sonuc[0].anlami

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

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

// sonuc[0].kkelime
// sonuc[0].kkoken
// sonuc[0].kkarsilik
// sonuc[0].anlam

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

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

// sonuc[0].madde
// sonuc[0].anlam1
// sonuc[0].aciklama

Köken Bilgisi Sözlüğü

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

// sonuc[0].word
// sonuc[0].meaning
// sonuc[0].etimology

📅 Günlük İçerikler

const icerik = await tdk.icerik();

// icerik.kelime
// icerik.atasoz
// icerik.kural
// icerik.karistirma
// icerik.syyd
// icerik.yabanci
// icerik.sayac

Ayrı ayrı kullanım:

const kelime = await tdk.gununKelimesi();
const atasozu = await tdk.gununAtasozu();
const kural = await tdk.gununKurali();
const karistirilan = await tdk.karistirilanSozler();
const yanlislar = await tdk.sikYapilanYanlislar();
const yabanci = await tdk.gununYabanciKarsiligi();

İsterseniz servis nesnesi üzerinden de kullanabilirsiniz:

const kelime = await tdk.icerik.gununKelimesi();
const atasozu = await tdk.icerik.gununAtasozu();

🔊 Yazım ve Sesli Okunuş

const yazim = await tdk.yazim('araba');
const sesLink = await tdk.sesGetir('araba');
const url = tdk.sesUrl('a3672');

Servis nesnesiyle kullanım:

const yazim = await tdk.yazim.ara('araba');
const sesLink = await tdk.yazim.sesGetir('araba');

Not: Her kelimenin sesli okunuşu bulunmayabilir. Böyle durumlarda sesGetir() metodu null döner.

🤟 Türk İşaret Dili

const gif = tdk.isaretDiliUrl('a');

🧹 Yardımcı Fonksiyonlar

tdk.htmlTemizle('<strong>araba</strong>');
// "araba"

tdk.veriTemizle([{ anlam: '<b>örnek</b>' }]);
// [{ anlam: 'örnek' }]

🔁 Geriye Dönük Uyum

Eski kullanım biçimlerini korumak için aşağıdaki adlar da desteklenir:

await tdk.guncelSozluk.ara('araba');
await tdk.batiKokenli.ara('argo');
await tdk.tarama.ara('bitik');
await tdk.tarama.getirId(2087);
await tdk.yazim.ara('araba');
await tdk.yazim.sesGetir('araba');
await tdk.icerik.gununKelimesi();

🧠 VS Code Otomatik Tamamlama

Bu paket artık tip tanımlarıyla birlikte gelir. Yani VS Code içinde:

• tdk. yazdığınızda metodlar listelenir
• metod açıklamaları görünür
• parametre ipuçları gösterilir
• dönen veri yapıları için alan önerileri alınır

Örneğin tdk.guncel, tdk.gununKelimesi, tdk.sesGetir ve tdk.icerik.gununKurali gibi alanlar düzenleyicide açıklamalı şekilde görünür.

📋 Hızlı Referans

| Modül | Metot | Açıklama | |-------|-------|----------| | tdk.guncel | (kelime) | Güncel Türkçe Sözlük'te arama yapar | | tdk.bati | (kelime) | Batı kökenli kelimeleri arar | | tdk.derleme | (kelime) | Derleme Sözlüğü'nde arama yapar | | tdk.atasozu | (kelime) | Atasözleri ve deyimler arasında arama yapar | | tdk.yabanciKarsiliklar | (kelime) | Yabancı sözlere önerilen Türkçe karşılıkları getirir | | tdk.erenEtimoloji | (kelime) | Eren etimoloji verisini getirir | | tdk.kokenBilgisi | (kelime) | Köken bilgisi verisini getirir | | tdk.tarama | (kelime) | Tarama Sözlüğü'nde arama yapar | | tdk.taramaDetay | (id) | Tarama kaydını kimliğine göre getirir | | tdk.icerik | () | Tüm günlük içeriği getirir | | tdk.gununKelimesi | () | Günün kelimesini getirir | | tdk.gununAtasozu | () | Günün atasözü veya deyimini getirir | | tdk.gununKurali | () | Günün yazım kuralını getirir | | tdk.karistirilanSozler | () | Sıkça karıştırılan sözleri getirir | | tdk.sikYapilanYanlislar | () | Sık yapılan yanlışları getirir | | tdk.gununYabanciKarsiligi | () | Günün yabancı söz karşılığını getirir | | tdk.yazim | (kelime) | Yazım bilgilerini getirir | | tdk.sesGetir | (kelime) | Sesli okunuş bağlantısını getirir | | tdk.sesUrl | (sesKodu) | Ses kodundan WAV bağlantısı üretir | | tdk.isaretDiliUrl | (harf) | İşaret dili GIF bağlantısı üretir | | tdk.htmlTemizle | (html) | HTML içeriğini düz metne çevirir | | tdk.veriTemizle | (veri) | Nesne veya dizideki metin alanlarını temizler |

⚙️ Gereksinimler

• Node.js 14.0.0 veya üzeri
• axios bağımlılığı paketle birlikte kurulur

📝 Lisans

MIT © 2026