first commit

README.md

@@ -0,0 +1,102 @@
+# metascraper
+
+Netflix URL'lerinden film ve dizi meta verilerini (başlık, yıl, sezon bilgisi) çıkaran modern Node.js kütüphanesi.
+
+## 🚀 Kurulum
+
+```bash
+npm install metascraper
+```
+
+## 💻 Kullanım
+
+### Film Meta Verisi
+
+```javascript
+import { scraperNetflix } from 'metascraper';
+
+const movie = await scraperNetflix('https://www.netflix.com/tr/title/82123114');
+console.log(movie);
+// {
+//   "url": "https://www.netflix.com/title/82123114",
+//   "id": "82123114",
+//   "name": "ONE SHOT with Ed Sheeran",
+//   "year": "2025",
+//   "seasons": null
+// }
+```
+
+### Dizi Meta Verisi
+
+```javascript
+import { scraperNetflix } from 'metascraper';
+
+const series = await scraperNetflix('https://www.netflix.com/tr/title/80189685');
+console.log(series);
+// {
+//   "url": "https://www.netflix.com/title/80189685",
+//   "id": "80189685",
+//   "name": "The Witcher",
+//   "year": "2025",
+//   "seasons": "4 Sezon"
+// }
+```
+
+### URL Normalizasyonu
+
+URL normalizasyonu artık `scraperNetflix` fonksiyonu içinde otomatik olarak yapılır.
+
+## ✨ Özellikler
+
+- ✅ **Film ve Dizi Destekli** - Her tür Netflix içeriği için meta veri
+- ✅ **Türkçe Arayüz Temizleme** - "izlemenizi bekliyor" gibi metinleri temizler
+- ✅ **JSON-LD Tabanlı** - Netflix'in yapısal verilerini kullanır
+- ✅ **Hızlı ve Güvenilir** - Statik HTML scraping + Playwright fallback
+- ✅ **Node.js 18+ Uyumlu** - Modern JavaScript özellikleri
+- ✅ **Türkiye Odaklı** - Netflix Türkiye URL'leri optimize edilmiş
+
+## 🔧 API
+
+### `scraperNetflix(url, options)`
+
+Netflix URL'sinden meta veri çeker. URL normalizasyonu otomatik olarak yapılır.
+
+**Parametreler:**
+- `url` (string): Netflix URL'i
+- `options` (object, isteğe bağlı):
+  - `headless` (boolean): Headless mode (default: false)
+  - `timeoutMs` (number): Timeout süresi (default: 15000)
+  - `userAgent` (string): Özel User-Agent
+
+**Dönen Veri:**
+```typescript
+{
+  url: string,           // Temizlenmiş URL
+  id: string,            // Netflix ID
+  name: string,          // İçerik adı
+  year: string | number, // Yılı
+  seasons: string | null // Sezon bilgisi (diziler için)
+}
+```
+
+## 🧪 Testler
+
+```bash
+npm test
+```
+
+## 🎮 Demo
+
+```bash
+npm run demo
+```
+
+## 📦 Gereksinimler
+
+- Node.js 18+
+- cheerio (otomatik)
+- playwright (isteğe bağlı, headless mode için)
+
+## 📄 Lisans
+
+MIT