Electronic Markets TR - MCP Server

Bu proje, Türkiye'nin önde gelen elektronik bileşen marketlerinde (Robotistan, Robocombo, Direnc.net, Robo90) aynı anda ürün, fiyat ve stok araması yapmanızı sağlayan bir MCP (Model Context Protocol) sunucusudur.

Yapay zeka modellerinin (Claude, Gemini vb.) Türkiye yerel piyasasından gerçek zamanlı veri çekerek, en uygun fiyatlı ve stokta bulunan ürünleri bulmasına yardımcı olur.

🚀 Özellikler

• Geniş Kapsam: Tek bir sorgu ile 4 farklı mağazadan (Robotistan, Robocombo, Direnc.net, Robo90) veri toplar.
• Doğru Fiyatlandırma: Robocombo gibi sitelerdeki indirimli (nihai) fiyatları otomatik olarak yakalar.
• Dinamik Veri Çekme: Robo90 ve Direnc.net gibi dinamik yükleme yapan sitelerin loader servislerini kullanarak en güncel veriye ulaşır.
• Hız ve Optimizasyon: Paralel sorgulama sayesinde sonuçları hızlı döndürür. Gereksiz veri yükünden kaçınmak için sayfa limitleri uygulanmıştır.
• AI Odaklı Mimari: Veriler ham olarak AI'ya sunulur; alaka düzeyi ve sıralama işlemleri AI'nın muhakeme yeteneğine bırakılmıştır.

🛠 Desteklenen Marketler

| Market | Durum | Özellik | | :--- | :--- | :--- | | Robotistan | ✅ Aktif | Kategori bazlı geniş arama. | | Robocombo | ✅ Aktif | Sepetteki indirimli fiyat tespiti. | | Direnc.net | ✅ Aktif | Loader servisi üzerinden hızlı veri. | | Robo90 | ✅ Aktif | Dinamik loader üzerinden yüksek isabetli arama. |

📦 Kurulum

1. Depoyu klonlayın:

   git clone https://github.com/ismaileneskucuk/mcp-electronicmarkets-tr.git
   cd mcp-electronicmarkets-tr
   

2. Sanal ortam oluşturun ve kütüphaneleri kurun:

   python -m venv venv
   # Windows için:
   venv\Scripts\activate  
   # Linux/Mac için:
   # source venv/bin/activate  
   pip install .
   

🤖 Claude Desktop Entegrasyonu

Claude Desktop'ta kullanabilmek için claude_desktop_config.json dosyanıza aşağıdaki işletim sisteminize uygun yapılandırmayı ekleyin.

Önemli: command ve PYTHONPATH kısımlarında kendi kullanıcı adınıza ve proje dizininize göre tam dosya yolunu (Absolute Path) yazmalısınız.

Windows Yapılandırması

{
  "mcpServers": {
    "electronic-markets-tr": {
      "command": "C:/KULLANICI_YOLU/mcp-electronicmarkets-tr/venv/Scripts/python.exe",
      "args": ["-m", "app.main"],
      "env": {
        "PYTHONPATH": "C:/KULLANICI_YOLU/mcp-electronicmarkets-tr"
      }
    }
  }
}

Linux / Mac Yapılandırması

{
  "mcpServers": {
    "electronic-markets-tr": {
      "command": "/ABSOLUTE/PATH/TO/mcp-electronicmarkets-tr/venv/bin/python",
      "args": ["-m", "app.main"],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/mcp-electronicmarkets-tr"
      }
    }
  }
}

💡 Kullanım Örnekleri

Sunucu aktif olduğunda Claude veya Gemini'a şu tarz sorular sorabilirsiniz:

• "Arduino Uno R3 klon için 4 marketi tara, en ucuz ve stokta olanı bul."
• "Raspberry Pi 5 8GB fiyatlarını karşılaştır ve en uygununu listele."
• "BMP280 sensörü hangi mağazalarda stokta var?"

📝 Geliştirme Notu

Bu proje, Gemini ve Claude yapay zeka modelleri ile "pair-programming" yapılarak geliştirilmiştir. Yazılım mimarisi, yapay zekanın veriyi en verimli şekilde işleyebileceği "data pipeline" prensipleriyle optimize edilmiştir.

⚖️ Lisans

Bu proje MIT License ile lisanslanmıştır.