Metadata-Version: 2.4
Name: melek-fetch
Version: 3.0.0
Summary: Anahtarsız ve Ücretsiz API'ler üzerinden Canlı Hava Durumu, Döviz, Kripto Para, Wikipedia ve Web Arama motoru.
Author: Melek Project
Author-email: support@melekai.project
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Requires-Dist: beautifulsoup4>=4.11.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🌟 Melek AI Fetch Engine (`melek-fetch`)

[![Python Version](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-blue)](https://www.python.org/)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-windows%20%7C%20linux%20%7C%20macos-lightgrey)]()
[![PyPI](https://img.shields.io/pypi/v/melek-fetch)](https://pypi.org/project/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

```bash
pip install melek-fetch
```

---

## 💻 Kullanım Örnekleri

```python
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())
```
