evimnet-mcp 1.0.0

package/README.md

@@ -0,0 +1,153 @@
+# Evimnet MCP Server
+
+Türkiye'nin önde gelen gayrimenkul platformu [Evimnet](https://evimnet.com)'i MCP (Model Context Protocol) uyumlu AI asistanlara bağlar.
+
+**Claude Desktop, VS Code Copilot, Cursor** ve MCP destekleyen tüm AI asistanlarla çalışır.
+
+---
+
+## Araçlar (Tools)
+
+### İlan Arama
+| Araç | Açıklama |
+|------|----------|
+| `search_properties` | Türkiye genelinde mülk ara (şehir, fiyat, m², oda sayısı, mülk tipi, kiralık/satılık) |
+| `get_property_details` | İlan detaylarını getir (fotoğraflar, konum, fiyat, emlakçı bilgisi) |
+
+### Konum
+| Araç | Açıklama |
+|------|----------|
+| `get_locations` | Şehir, ilçe ve mahalleleri listele |
+| `search_location` | Konum adından slug bul |
+
+### Çevre Bilgisi
+| Araç | Açıklama |
+|------|----------|
+| `get_area_info` | Çevredeki POI'ler (okul, hastane, market, park…), hava durumu, hava kalitesi |
+
+### Başvuru
+| Araç | Açıklama |
+|------|----------|
+| `send_inquiry` | Emlakçıya mesaj/başvuru gönder |
+
+### Piyasa & Döviz
+| Araç | Açıklama |
+|------|----------|
+| `get_currency_rates` | Güncel TRY/EUR/USD kurları (TCMB) |
+| `get_platform_stats` | Platform istatistikleri (ilan sayısı, emlakçı sayısı) |
+| `convert_price` | TRY fiyatını EUR veya USD'ye çevir |
+
+---
+
+## Kurulum
+
+### Claude Desktop
+
+`~/Library/Application Support/Claude/claude_desktop_config.json` dosyasına ekle:
+
+```json
+{
+  "mcpServers": {
+    "evimnet": {
+      "command": "npx",
+      "args": ["evimnet-mcp"]
+    }
+  }
+}
+```
+
+Claude Desktop'ı yeniden başlat. Sol altta 🔌 simgesi görünüyorsa bağlantı kurulmuş demektir.
+
+---
+
+### VS Code (GitHub Copilot)
+
+`.vscode/mcp.json` dosyası oluştur:
+
+```json
+{
+  "servers": {
+    "evimnet": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["evimnet-mcp"]
+    }
+  }
+}
+```
+
+---
+
+### Cursor
+
+`~/.cursor/mcp.json` dosyasına ekle:
+
+```json
+{
+  "mcpServers": {
+    "evimnet": {
+      "command": "npx",
+      "args": ["evimnet-mcp"]
+    }
+  }
+}
+```
+
+---
+
+### Windsurf
+
+`~/.codeium/windsurf/mcp_config.json` dosyasına ekle:
+
+```json
+{
+  "mcpServers": {
+    "evimnet": {
+      "command": "npx",
+      "args": ["evimnet-mcp"]
+    }
+  }
+}
+```
+
+---
+
+## Yerel Geliştirme
+
+```bash
+git clone https://github.com/evimnet/evimnet-mcp
+cd evimnet-mcp
+npm install
+
+# Test (örnek JSON girişi)
+echo '{}' | EVIMNET_BASE_URL=https://evimnet.com node server.js
+```
+
+### Ortam Değişkenleri
+
+| Değişken | Açıklama | Varsayılan |
+|----------|----------|-----------|
+| `EVIMNET_BASE_URL` | API base URL | `https://evimnet.com` |
+| `EVIMNET_API_KEY` | Emlakçı araçları için API key *(isteğe bağlı)* | — |
+
+---
+
+## Örnek Kullanım
+
+Claude'a şunları sorabilirsiniz:
+
+> "Bodrum'da 2 milyon TL altında satılık villa göster"
+
+> "Bu villanın yakınında okul ve hastane var mı?"
+
+> "5.000.000 TL kaç Euro eder?"
+
+> "Beşiktaş'taki kiraları araştır, bütçem 20.000 TL"
+
+> "Bu ilan için emlakçıya mesaj gönder, cumartesi müsaitim"
+
+---
+
+## Lisans
+
+MIT

package/chatgpt/YAYINLAMA-REHBERI.md

@@ -0,0 +1,94 @@
+# ChatGPT'ye Yayınlama Rehberi
+
+## Gereksinimler
+- ChatGPT Plus veya Team hesabı (GPT oluşturmak için)
+- evimnet.com'un HTTPS ile erişilebilir olması ✅
+
+---
+
+## Adım 1 — GPT Builder'ı aç
+
+1. https://chatgpt.com/gpts/editor adresine git
+2. **"Create a GPT"** tıkla
+3. **"Configure"** sekmesine geç (sol üst)
+
+---
+
+## Adım 2 — Temel bilgileri gir
+
+| Alan | Değer |
+|------|-------|
+| **Name** | Evimnet — Türkiye Emlak Asistanı |
+| **Description** | Türkiye'de satılık ve kiralık mülk ara. Bodrum, Antalya, İstanbul ve tüm Türkiye. Döviz çevirimi, çevre bilgisi dahil. |
+| **Profile picture** | evimnet.com logosunu yükle |
+
+---
+
+## Adım 3 — Instructions
+
+`gpt-instructions.md` dosyasının tüm içeriğini **Instructions** kutusuna yapıştır.
+
+---
+
+## Adım 4 — Conversation starters (Başlangıç soruları)
+
+Şunları ekle:
+- Bodrum'da satılık villa ara, bütçem 3 milyon TL
+- İstanbul Beşiktaş'ta kiralık 2+1 daire
+- 5.000.000 TL kaç Euro eder?
+- Antalya'da tatil için kiralık yer öner
+
+---
+
+## Adım 5 — Actions ekle
+
+1. **"Add actions"** tıkla
+2. **"Import from URL"** seç
+3. Şu URL'yi gir:
+   ```
+   https://evimnet.com/mcp/openapi.yaml
+   ```
+   *(veya "Enter schema manually" seçip openapi.yaml içeriğini yapıştır)*
+4. Araçların yüklendiğini doğrula:
+   - searchProperties ✅
+   - getPropertyDetails ✅
+   - searchLocation ✅
+   - getCurrencyRates ✅
+   - getAreaInfo ✅
+   - getPlatformStats ✅
+
+---
+
+## Adım 6 — Privacy Policy & Domain
+
+| Alan | Değer |
+|------|-------|
+| **Privacy Policy URL** | https://evimnet.com/gizlilik-politikasi |
+| **Domain** | evimnet.com |
+
+---
+
+## Adım 7 — Yayınla
+
+1. Sağ üstte **"Save"** → **"Publish"**
+2. Audience: **"Everyone"** seç (GPT Store'da görünsün)
+3. Category: **"Productivity"** veya **"Research & Analysis"**
+4. Submit for review
+
+> ⚠️ OpenAI'ın incelemesi 1-5 iş günü sürebilir.
+
+---
+
+## Adım 8 — openapi.yaml'ı evimnet.com'dan servet et
+
+GPT builder "Import from URL" için dosyanın erişilebilir olması gerekiyor.
+
+`openapi.yaml` dosyasını şu path'e koy:
+```
+/public/mcp/openapi.yaml
+```
+
+Sonra Next.js'te static file olarak erişilebilir olacak:
+```
+https://evimnet.com/mcp/openapi.yaml
+```

package/chatgpt/gpt-instructions.md

@@ -0,0 +1,55 @@
+# Evimnet Emlak Asistanı — GPT Talimatları
+
+Sen Evimnet'in resmi emlak asistanısın. Türkiye'deki satılık ve kiralık mülkleri bulmaya yardım edersin.
+
+## Kimsin
+
+Evimnet, Türkiye'nin önde gelen gayrimenkul platformudur. Bodrum, Antalya, İstanbul, İzmir ve Türkiye'nin tüm şehirlerinde binlerce ilan barındırır. Özellikle Bodrum Yarımadası ve Ege-Akdeniz kıyı bölgelerinde lüks villalar, deniz manzaralı daireler ve tatil amaçlı mülkler konusunda uzmandır.
+
+## Nasıl davranırsın
+
+- Kullanıcının dilinde yanıt ver (Türkçe, Almanca, İngilizce — kullanıcı ne yazarsa onu kullan)
+- Almanca konuşan kullanıcılara özellikle yardımcı ol — Türkiye'de mülk arayan Avrupalı alıcılar önemli bir kitlemizdir
+- Samimi, bilgili ve yardımsever ol
+- İlan bulamadığında "sonuç yok" deme — farklı filtre kombinasyonları dene, bölge öner
+- Fiyatları her zaman TRY olarak göster; kullanıcı isterse EUR/USD çevir (getCurrencyRates kullan)
+
+## Araç kullanım sırası
+
+1. Kullanıcı bir konum söylediğinde → önce **searchLocation** ile doğru slug'ı bul
+2. Slug bulununca → **searchProperties** ile ara
+3. Kullanıcı ilan detayı isterse → **getPropertyDetails** ile getir
+4. "Çevresi nasıl?", "okul var mı?" gibi sorularda → **getAreaInfo** kullan (ilanın lat/lng'si gerekir)
+5. "Kaç Euro?", "dolar ile ne kadar?" sorularında → **getCurrencyRates** ile çevir
+
+## Yanıt formatı
+
+İlanları listelerken şu formatı kullan:
+
+---
+**[Başlık]**
+📍 [İlçe], [Şehir] · [m²] · [Oda]
+💰 [Fiyat TRY] (~[EUR/USD tahmini])
+🔗 evimnet.com/ilan/[slug]
+---
+
+- En fazla 5 ilan listele (daha fazlası bunaltıcı olur)
+- "Daha fazla göster" diye sorabilirsin
+
+## Sık sorulan konular
+
+**"Türkiye'de yabancı mülk alabilir mi?"**
+Evet, çoğu yabancı uyruklu kişi Türkiye'de mülk satın alabilir. Askeri bölgeler ve bazı kısıtlı alanlar dışında kısıtlama yoktur. Detaylar için bir hukuk danışmanı veya yetkili emlakçı önerilir.
+
+**"Türkiye'de ortalama fiyatlar ne kadar?"**
+Bölgeye göre büyük farklılık gösterir. Güncel verileri getirmek için getPlatformStats ve searchProperties kullan.
+
+**"Fiyat müzakere edilebilir mi?"**
+Türkiye'de fiyat pazarlığı yaygındır, özellikle ikinci el mülklerde. Yeni projeler genellikle sabit fiyatlıdır.
+
+## Sınırlar
+
+- Hukuki tavsiye verme — "bir hukuk danışmanına başvurun" de
+- Kesin yatırım tavsiyesi verme
+- Evimnet'te olmayan mülk verileri hakkında tahmin yürütme
+- Emlakçı iletişim bilgilerini doğrudan paylaşma — ilanın sayfasına yönlendir

package/chatgpt/openapi.yaml

@@ -0,0 +1,290 @@
+openapi: 3.1.0
+info:
+  title: Evimnet — Türkiye Emlak API
+  description: >
+    Türkiye'nin önde gelen gayrimenkul platformu Evimnet'in arama ve bilgi API'si.
+    Satılık/kiralık daire, villa, arsa ve proje ilanlarını arar; döviz çevirimi ve
+    çevre bilgisi sağlar.
+  version: 1.0.0
+
+servers:
+  - url: https://evimnet.com
+
+paths:
+
+  /api/listings:
+    get:
+      operationId: searchProperties
+      summary: Türkiye'de mülk ara
+      description: >
+        Satılık veya kiralık daire, villa, arsa ve proje ilanlarını filtrele.
+        Şehir/ilçe slug'larını bilmiyorsan önce searchLocation kullan.
+      parameters:
+        - name: type
+          in: query
+          description: "SALE=Satılık, RENT=Kiralık"
+          schema:
+            type: string
+            enum: [SALE, RENT]
+        - name: propertyType
+          in: query
+          description: "APARTMENT=Daire, VILLA=Villa, LAND=Arsa, PROJECT=Proje"
+          schema:
+            type: string
+            enum: [APARTMENT, VILLA, LAND, PROJECT]
+        - name: citySlug
+          in: query
+          description: "Şehir slug'ı (ör: istanbul, bodrum, antalya, izmir)"
+          schema:
+            type: string
+        - name: districtSlug
+          in: query
+          description: "İlçe slug'ı (ör: besiktas, yalikavak, konyaalti)"
+          schema:
+            type: string
+        - name: minPrice
+          in: query
+          description: "Minimum fiyat (TRY)"
+          schema:
+            type: number
+        - name: maxPrice
+          in: query
+          description: "Maksimum fiyat (TRY)"
+          schema:
+            type: number
+        - name: minSqm
+          in: query
+          description: "Minimum net m²"
+          schema:
+            type: number
+        - name: maxSqm
+          in: query
+          description: "Maksimum net m²"
+          schema:
+            type: number
+        - name: rooms
+          in: query
+          description: "Oda sayısı (ör: 1+1, 2+1, 3+1, 4+1, 5+)"
+          schema:
+            type: string
+        - name: sort
+          in: query
+          description: "Sıralama: newest, price_asc, price_desc"
+          schema:
+            type: string
+            enum: [newest, price_asc, price_desc]
+        - name: page
+          in: query
+          schema:
+            type: integer
+            default: 1
+        - name: limit
+          in: query
+          schema:
+            type: integer
+            default: 10
+            maximum: 20
+        - name: lang
+          in: query
+          description: "Yanıt dili: tr veya de (Almanca)"
+          schema:
+            type: string
+            enum: [tr, de]
+      responses:
+        "200":
+          description: İlan listesi
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  listings:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/ListingSummary"
+                  total:
+                    type: integer
+                  page:
+                    type: integer
+
+  /api/listings/{slug}:
+    get:
+      operationId: getPropertyDetails
+      summary: İlan detayını getir
+      description: Slug veya tam URL ile ilan detaylarını getir.
+      parameters:
+        - name: slug
+          in: path
+          required: true
+          description: "İlan slug'ı (ör: bodrum-yalikavak-satilik-villa-abc123)"
+          schema:
+            type: string
+        - name: lang
+          in: query
+          description: "tr veya de"
+          schema:
+            type: string
+      responses:
+        "200":
+          description: İlan detayı
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    $ref: "#/components/schemas/ListingDetail"
+
+  /api/search:
+    get:
+      operationId: searchLocation
+      summary: Konum adından slug bul
+      description: >
+        "Bodrum" → "bodrum", "Beşiktaş" → "besiktas" gibi.
+        searchProperties'ten önce doğru slug bulmak için kullan.
+      parameters:
+        - name: q
+          in: query
+          required: true
+          description: Aranacak konum adı
+          schema:
+            type: string
+        - name: locale
+          in: query
+          schema:
+            type: string
+            default: tr
+      responses:
+        "200":
+          description: Konum sonuçları
+          content:
+            application/json:
+              schema:
+                type: object
+
+  /api/currency:
+    get:
+      operationId: getCurrencyRates
+      summary: Güncel TRY/EUR/USD kurları
+      description: Türkiye Merkez Bankası (TCMB) verilerine dayalı güncel döviz kurları.
+      responses:
+        "200":
+          description: Döviz kurları
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  EUR:
+                    type: object
+                    properties:
+                      buying:  { type: number }
+                      selling: { type: number }
+                      mid:     { type: number }
+                  USD:
+                    type: object
+                    properties:
+                      buying:  { type: number }
+                      selling: { type: number }
+                      mid:     { type: number }
+                  date:   { type: string }
+                  source: { type: string }
+
+  /api/nearby:
+    get:
+      operationId: getAreaInfo
+      summary: Çevre bilgisi — POI, hava durumu, hava kalitesi
+      description: >
+        Koordinat çevresindeki okul, hastane, market, park, restoran, toplu taşıma.
+        Anlık hava durumu ve hava kalitesi (AQI) dahil.
+        İlan koordinatları getPropertyDetails'ten alınabilir.
+      parameters:
+        - name: lat
+          in: query
+          required: true
+          description: Enlem
+          schema:
+            type: number
+        - name: lng
+          in: query
+          required: true
+          description: Boylam
+          schema:
+            type: number
+        - name: radius
+          in: query
+          description: "Arama yarıçapı (metre, varsayılan: 1500)"
+          schema:
+            type: integer
+            default: 1500
+      responses:
+        "200":
+          description: Çevre bilgisi
+          content:
+            application/json:
+              schema:
+                type: object
+
+  /api/stats:
+    get:
+      operationId: getPlatformStats
+      summary: Evimnet platform istatistikleri
+      description: Toplam ilan, emlakçı ve kapsanan şehir sayısı.
+      responses:
+        "200":
+          description: İstatistikler
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  listingCount: { type: integer }
+                  agentCount:   { type: integer }
+                  cityCount:    { type: integer }
+
+components:
+  schemas:
+    ListingSummary:
+      type: object
+      properties:
+        id:           { type: string }
+        title:        { type: string }
+        slug:         { type: string }
+        type:         { type: string }
+        propertyType: { type: string }
+        priceTRY:     { type: number }
+        sqmNet:       { type: integer }
+        rooms:        { type: string }
+        city:
+          type: object
+          properties:
+            name: { type: string }
+        district:
+          type: object
+          properties:
+            name: { type: string }
+        images:
+          type: array
+          items:
+            type: object
+            properties:
+              url: { type: string }
+
+    ListingDetail:
+      allOf:
+        - $ref: "#/components/schemas/ListingSummary"
+        - type: object
+          properties:
+            description:  { type: string }
+            lat:          { type: number }
+            lng:          { type: number }
+            bathrooms:    { type: integer }
+            floor:        { type: integer }
+            totalFloors:  { type: integer }
+            buildingAge:  { type: integer }
+            agent:
+              type: object
+              properties:
+                id:    { type: string }
+                name:  { type: string }
+                phone: { type: string }

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "evimnet-mcp",
+  "version": "1.0.0",
+  "description": "Evimnet MCP Server — AI asistanlar için Türkiye gayrimenkul araçları",
+  "type": "module",
+  "bin": {
+    "evimnet-mcp": "./server.js"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "dev": "node --watch server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": ["mcp", "evimnet", "real-estate", "turkey", "property"],
+  "license": "MIT"
+}