Real-time product, price, and stock search across Turkish electronic retailers.
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
Depoyu klonlayın:
git clone https://github.com/ismaileneskucuk/mcp-electronicmarkets-tr.git cd mcp-electronicmarkets-trSanal 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:
commandvePYTHONPATHkı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.
Tools (1)
search_productsSearches for electronic components across multiple Turkish retailers simultaneously.Environment Variables
PYTHONPATHrequiredThe absolute path to the project directory.Configuration
{"mcpServers": {"electronic-markets-tr": {"command": "python", "args": ["-m", "app.main"], "env": {"PYTHONPATH": "/PATH/TO/mcp-electronicmarkets-tr"}}}}