🌟 Melek AI Fetch Engine (melek-fetch)

Melek AI Asistan Projesi için tasarlanmış; tamamen ücretsiz, API anahtarı (No-Key) gerektirmeyen, yüksek hızlı, RAM önbellekli, çok motorlu yedekli ve anti-bot korumalı veri toplama motoru.

📖 Genel Bakış

Melek AI Fetch Engine, asistanınızın internetten anlık olarak ihtiyaç duyduğu bilgileri (hava durumu, döviz kurları, canlı kripto paralar, Wikipedia özetleri ve canlı web araması) çeken hafif ama dayanıklı bir motor sunar. Ücretli veya API anahtarı gerektiren hiçbir servise bağımlı değildir; çok katmanlı yedek motor mimarisiyle web format değişimlerine karşı dirençlidir.

✨ Öne Çıkan Özellikler

🌤️ 1. Hava Durumu Motoru (Open-Meteo)

• Şehir adını enlem ve boylama otomatik çeviren Geocoding entegrasyonu.
• Türkçe WMO durum kodları eşleştirmesi.
• Sıcaklık, hissedilen, nem ve rüzgar hızı.
• Hem metin (hava_durumu) hem dict (hava_durumu_data) formatı.

💱 2. Döviz Kurları (3 Katmanlı Savunmacı Mimari)

• Katman 1: open.er-api.com (TRY bazlı USD, EUR, GBP, CHF).
• Katman 2 (Yedek): api.frankfurter.dev (Avrupa Merkez Bankası verisi).
• Katman 3 (Yedek): TCMB XML (Standart xml.etree ile sıfır harici parser bağımlılığı).

🪙 3. Canlı Kripto Para & Piyasa Özeti (CoinGecko)

• Bitcoin (BTC), Ethereum (ETH), Solana (SOL), BNB, DOGE canlı USD ve TRY fiyatları.
• Asistan sabah brifingleri için tek tuşla Döviz + Kripto piyasa özeti (piyasa_ozeti).

📖 4. Akıllı Wikipedia Özetleyici (Anlam Ayrımı / Disambiguation Çözücü)

• Disambiguation sayfalarına (örn. Galatasaray, Merkür) takılmadan ilk 5 adayı tarayıp asıl maddeyi getiren akıllı tarayıcı.
• Temiz 2-3 cümlelik Türkçe özet ve masaüstü bağlantı linki.

🔍 5. Canlı Web Arama (Bing + Wikipedia + DDG)

• Wikipedia dışındaki serbest aramalar için Bing canlı web araması, Base64 URL çözücü ve zengin özetler.
• Yedek olarak Wikipedia tam metin arama entegrasyonu.

⚡ 6. Performans ve Güvenlik

• RAM Tabanlı TTL Önbellek: Hava durumu (30 dk), Döviz (10 dk), Kripto (2 dk), Wiki (1 saat), Web Arama (5 dk).
• User-Agent Rotasyonu: İsteklerde gerçekçi tarayıcı kimlikleri havuzu.
• Asenkron / Senkron Güvenliği: Asistan ana döngüsünü dondurmayan korumalı timeout'lar.

🚀 Kurulum

pip install melek-fetch

💻 Kullanım Örnekleri

from melek_fetch import MelekFetchController

melek = MelekFetchController()

# 1. Hava Durumu
print(melek.hava_durumu("İstanbul"))

# 2. Döviz Kurları
print(melek.doviz_kurlari())

# 3. Kripto Fiyatları
print(melek.kripto_fiyatlari(["BTC", "ETH", "SOL"]))

# 4. Wikipedia Özeti
print(melek.wikipedia_ozet("Galatasaray"))

# 5. Canlı Web Arama
print(melek.web_ara("Python yapay zeka", limit=3))

# 6. Piyasa Özeti
print(melek.piyasa_ozeti())