evimnet-mcp 1.0.0 → 1.2.0

package/DIZIN-KAYIT.md

@@ -0,0 +1,64 @@
+# MCP Dizin Kayıt Bilgileri
+
+Aşağıdaki bilgileri kopyala-yapıştır ile ilgili sitelere gir.
+
+---
+
+## 1. Smithery.ai (en kolay, anında yayınlanır)
+
+**URL:** https://smithery.ai/new
+
+| Alan | Değer |
+|------|-------|
+| Server Name | evimnet-mcp |
+| Display Name | Evimnet — Turkey Real Estate Search |
+| GitHub URL | https://github.com/high5emlak/evimnetglobal/tree/main/mcp-server |
+| npm Package | evimnet-mcp |
+| Description (EN) | Search properties for sale and rent across Turkey. Covers Istanbul, Bodrum, Antalya, Izmir and all cities. Includes currency conversion (TRY/EUR/USD), area info (schools, hospitals, transport), and market statistics. 9 tools for AI assistants. |
+
+---
+
+## 2. mcp.so
+
+**URL:** https://mcp.so/ → Submit butonu
+
+| Alan | Değer |
+|------|-------|
+| Name | Evimnet MCP |
+| Description | Turkey's real estate search for AI assistants. Search sale/rent properties, get property details, area info (POIs, weather, AQI), currency rates (TRY/EUR/USD), and platform stats. Supports Turkish, German, and English. |
+| GitHub | https://github.com/high5emlak/evimnetglobal/tree/main/mcp-server |
+| npm | https://www.npmjs.com/package/evimnet-mcp |
+| Install command | npx evimnet-mcp |
+| Category | Real Estate / Property |
+| Tools count | 9 |
+| Tools | search_properties, get_property_details, get_locations, search_location, get_area_info, send_inquiry, get_currency_rates, get_platform_stats, convert_price |
+
+---
+
+## 3. Glama.ai
+
+**URL:** https://glama.ai/mcp/servers → Add Server
+
+| Alan | Değer |
+|------|-------|
+| GitHub Repository URL | https://github.com/high5emlak/evimnetglobal |
+| Server path | mcp-server/ |
+
+---
+
+## Ortak bilgiler (her yerde kullanılabilir)
+
+**Kısa açıklama (TR):**
+Türkiye'de satılık ve kiralık emlak arama. İstanbul, Bodrum, Antalya, İzmir ve tüm şehirler. Döviz çevirimi, çevre bilgisi, piyasa istatistikleri. 9 AI aracı.
+
+**Kısa açıklama (EN):**
+Search properties for sale and rent across Turkey. Istanbul, Bodrum, Antalya, Izmir and all cities. Currency conversion, area info, market stats. 9 AI tools.
+
+**Kısa açıklama (DE):**
+Immobiliensuche in der Türkei — Kauf und Miete. Istanbul, Bodrum, Antalya, Izmir und alle Städte. Währungsumrechnung, Umgebungsinfos, Marktstatistiken. 9 KI-Tools.
+
+**Tags:** real-estate, turkey, property, mcp, ai, bodrum, istanbul, antalya, rental, sale
+
+**Website:** https://evimnet.com
+**npm:** https://www.npmjs.com/package/evimnet-mcp
+**License:** MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evimnet-mcp",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Evimnet MCP Server — AI asistanlar için Türkiye gayrimenkul araçları",
   "type": "module",
   "bin": {

package/server.js

@@ -60,10 +60,14 @@ const TOOL_HANDLERS = {
   convert_price:        (a) => handleMarketTool('convert_price',          a),
 
   // Emlakçı araçları (API key gerekli)
-  get_my_leads:         (a) => handleAgentTool('get_my_leads',            a),
-  update_lead_status:   (a) => handleAgentTool('update_lead_status',      a),
-  get_my_listings:      (a) => handleAgentTool('get_my_listings',         a),
-  get_my_stats:         (a) => handleAgentTool('get_my_stats',            a),
+  get_my_leads:          (a) => handleAgentTool('get_my_leads',            a),
+  get_lead_detail:       (a) => handleAgentTool('get_lead_detail',         a),
+  update_lead_status:    (a) => handleAgentTool('update_lead_status',      a),
+  get_my_listings:       (a) => handleAgentTool('get_my_listings',         a),
+  get_listing_analytics: (a) => handleAgentTool('get_listing_analytics',   a),
+  get_my_stats:          (a) => handleAgentTool('get_my_stats',            a),
+  create_listing:        (a) => handleAgentTool('create_listing',          a),
+  update_listing:        (a) => handleAgentTool('update_listing',          a),
 };
 
 // ─── Server oluştur ──────────────────────────────────────────────────────────

package/tools/agent.js

@@ -30,12 +30,23 @@ Filtreleme: durum (NEW=Yeni, CONTACTED=Arandı, MEETING=Görüşme, CLOSED=Kapan
           enum: ['NEW', 'CONTACTED', 'MEETING', 'CLOSED'],
           description: 'Durum filtresi (boş = hepsi)',
         },
-        page:  { type: 'number', description: 'Sayfa numarası (varsayılan: 1)' },
-        limit: { type: 'number', description: 'Sayfa başı kayıt (maks: 50, varsayılan: 20)' },
       },
     },
   },
 
+  {
+    name: 'get_lead_detail',
+    description: `Tek bir lead'in detayını getir. İlan bilgisi, mesaj ve iletişim bilgileri dahil.
+Örnek: "Ahmet Yılmaz'ın başvuru detayını göster"`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: 'Lead ID (get_my_leads\'ten alınır)' },
+      },
+      required: ['id'],
+    },
+  },
+
   {
     name: 'update_lead_status',
     description: `Lead durumunu güncelle.
@@ -43,137 +54,217 @@ Filtreleme: durum (NEW=Yeni, CONTACTED=Arandı, MEETING=Görüşme, CLOSED=Kapan
     inputSchema: {
       type: 'object',
       properties: {
-        leadId: { type: 'string', description: 'Lead ID (get_my_leads\'ten alınır)' },
+        id: { type: 'string', description: 'Lead ID' },
         status: {
           type: 'string',
           enum: ['NEW', 'CONTACTED', 'MEETING', 'CLOSED'],
           description: 'Yeni durum',
         },
       },
-      required: ['leadId', 'status'],
+      required: ['id', 'status'],
     },
   },
 
   {
     name: 'get_my_listings',
-    description: `Emlakçının ilanlarını getir.
-Aktif, taslak, pasif ilanlar. Lead sayısı ve görüntülenme bilgisi dahil.
+    description: `Emlakçının ilanlarını getir. Görüntülenme ve favori sayıları dahil.
 Örnek: "Aktif ilanlarımı listele", "Taslak ilanlarım var mı?"`,
     inputSchema: {
       type: 'object',
       properties: {
         status: {
           type: 'string',
-          enum: ['DRAFT', 'PENDING', 'APPROVED', 'PASSIVE', 'SOLD', 'RENTED', 'REJECTED'],
+          enum: ['DRAFT', 'PENDING', 'APPROVED', 'PASSIVE'],
           description: 'Durum filtresi (boş = hepsi)',
         },
-        page:  { type: 'number', description: 'Sayfa numarası' },
-        limit: { type: 'number', description: 'Sayfa başı kayıt' },
       },
     },
   },
 
+  {
+    name: 'get_listing_analytics',
+    description: `Bir ilanın performans analitiğini getir: görüntülenme, tıklama, Avrupa görüntülenme, lead sayısı, boost durumu.
+Örnek: "Yalıkavak villamın performansı nasıl?"`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: 'İlan ID (get_my_listings\'ten alınır)' },
+      },
+      required: ['id'],
+    },
+  },
+
   {
     name: 'get_my_stats',
     description: `Dashboard özeti: aktif ilan sayısı, yeni lead sayısı, toplam görüntülenme.
-Örnek: "Durumumu özetle", "Bu hafta kaç kişi ilanlarımı gördü?"`,
+Örnek: "Durumumu özetle", "Genel performansım nasıl?"`,
     inputSchema: {
       type: 'object',
       properties: {},
     },
   },
+
+  {
+    name: 'create_listing',
+    description: `Yeni ilan oluştur. Şehir ve ilçe adını Türkçe yazabilirsiniz, otomatik eşleştirilir.
+Taslak olarak oluşturulur; panelden fotoğraf ekleyip onaya gönderebilirsiniz. status: "PENDING" ile direkt onaya da gönderilebilir.
+Örnek: "Bodrum Yalıkavak'ta 3+1 villa ekle, 4.500.000 TL, 180m², deniz manzaralı"`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        title:        { type: 'string', description: 'İlan başlığı' },
+        type:         { type: 'string', enum: ['SALE', 'RENT'], description: 'SALE=Satılık, RENT=Kiralık' },
+        propertyType: { type: 'string', enum: ['APARTMENT', 'VILLA', 'LAND', 'PROJECT'], description: 'Mülk tipi' },
+        priceTRY:     { type: 'number', description: 'Fiyat (TRY)' },
+        city:         { type: 'string', description: 'Şehir adı (ör: Bodrum, İstanbul, Antalya)' },
+        district:     { type: 'string', description: 'İlçe adı (ör: Yalıkavak, Beşiktaş)' },
+        rooms:        { type: 'string', description: 'Oda sayısı (ör: 3+1, 2+1, Stüdyo)' },
+        sqmNet:       { type: 'number', description: 'Net m²' },
+        sqmGross:     { type: 'number', description: 'Brüt m²' },
+        bathrooms:    { type: 'number', description: 'Banyo sayısı' },
+        floor:        { type: 'number', description: 'Bulunduğu kat' },
+        totalFloors:  { type: 'number', description: 'Toplam kat' },
+        buildingAge:  { type: 'number', description: 'Bina yaşı' },
+        heating:      { type: 'string', description: 'Isıtma tipi (ör: Doğalgaz, Klima, Yerden)' },
+        description:  { type: 'string', description: 'İlan açıklaması (Türkçe)' },
+        descriptionDE: { type: 'string', description: 'İlan açıklaması (Almanca, opsiyonel)' },
+        viewType:     { type: 'string', description: 'Manzara tipi JSON array (ör: ["SEA","NATURE"])' },
+        seaDistance:   { type: 'number', description: 'Denize uzaklık (metre)' },
+        villaType:    { type: 'string', enum: ['DETACHED', 'SEMI_DETACHED', 'TRIPLEX', 'DUPLEX'], description: 'Villa tipi' },
+        poolType:     { type: 'string', enum: ['PRIVATE', 'SHARED', 'NONE'], description: 'Havuz tipi' },
+        gardenSqm:    { type: 'number', description: 'Bahçe m²' },
+        lat:          { type: 'number', description: 'Enlem' },
+        lng:          { type: 'number', description: 'Boylam' },
+        features:     { type: 'object', description: 'Özellikler (ör: {"barbeku": true, "klima": true})' },
+        status:       { type: 'string', enum: ['DRAFT', 'PENDING'], description: 'DRAFT=Taslak, PENDING=Onaya gönder' },
+      },
+      required: ['title', 'type', 'propertyType', 'priceTRY', 'city'],
+    },
+  },
+
+  {
+    name: 'update_listing',
+    description: `Mevcut bir ilanı düzenle. Sadece değişen alanları gönderin.
+Fiyat, açıklama, m², oda sayısı vb. güncellenebilir. İçerik değişirse ilan otomatik onaya gider.
+Örnek: "Yalıkavak villamın fiyatını 4 milyona düşür", "İlan açıklamasını güncelle"`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id:           { type: 'string', description: 'İlan ID (get_my_listings\'ten alınır)' },
+        title:        { type: 'string', description: 'Yeni başlık' },
+        priceTRY:     { type: 'number', description: 'Yeni fiyat (TRY)' },
+        description:  { type: 'string', description: 'Yeni açıklama' },
+        descriptionDE: { type: 'string', description: 'Almanca açıklama' },
+        rooms:        { type: 'string', description: 'Oda sayısı' },
+        sqmNet:       { type: 'number', description: 'Net m²' },
+        sqmGross:     { type: 'number', description: 'Brüt m²' },
+        bathrooms:    { type: 'number', description: 'Banyo sayısı' },
+        floor:        { type: 'number', description: 'Kat' },
+        buildingAge:  { type: 'number', description: 'Bina yaşı' },
+        heating:      { type: 'string', description: 'Isıtma tipi' },
+        viewType:     { type: 'string', description: 'Manzara tipi' },
+        seaDistance:   { type: 'number', description: 'Denize uzaklık' },
+        features:     { type: 'object', description: 'Özellikler' },
+        status:       { type: 'string', enum: ['DRAFT', 'PENDING', 'PASSIVE'], description: 'Durum' },
+      },
+      required: ['id'],
+    },
+  },
 ];
 
 export async function handleAgentTool(name, args) {
-  if (name === 'get_my_leads')       return getMyLeads(args);
-  if (name === 'update_lead_status') return updateLeadStatus(args);
-  if (name === 'get_my_listings')    return getMyListings(args);
-  if (name === 'get_my_stats')       return getMyStats();
+  if (name === 'get_my_leads')          return getMyLeads(args);
+  if (name === 'get_lead_detail')       return getLeadDetail(args);
+  if (name === 'update_lead_status')    return updateLeadStatus(args);
+  if (name === 'get_my_listings')       return getMyListings(args);
+  if (name === 'get_listing_analytics') return getListingAnalytics(args);
+  if (name === 'get_my_stats')          return getMyStats();
+  if (name === 'create_listing')        return createListing(args);
+  if (name === 'update_listing')        return updateListing(args);
 }
 
-async function getMyLeads({ status, page = 1, limit = 20 } = {}) {
-  const params = new URLSearchParams({ page: String(page), limit: String(limit) });
-  if (status) params.set('status', status);
-
-  const res = await fetch(`${BASE_URL}/api/mcp/leads?${params}`, { headers: agentHeaders() });
-  if (!res.ok) throw new Error(`API hatası: ${res.status}`);
-  const data = await res.json();
-
-  const leads = data.leads.map(l => ({
-    id:        l.id,
-    name:      l.name,
-    email:     l.email,
-    phone:     l.phone || null,
-    status:    l.status,
-    message:   l.message || null,
-    listing:   l.listing ? { title: l.listing.title, slug: l.listing.slug, price: `${l.listing.priceTRY?.toLocaleString('tr-TR')} ₺` } : null,
-    createdAt: l.createdAt,
-  }));
+async function mcpPost(action, body) {
+  const qs = new URLSearchParams({ action });
+  const res = await fetch(`${BASE_URL}/api/mcp/agent?${qs}`, {
+    method: 'POST',
+    headers: agentHeaders(),
+    body: JSON.stringify(body),
+  });
+  if (!res.ok) {
+    const data = await res.json().catch(() => ({}));
+    throw new Error(data.error || `API hatasi: ${res.status}`);
+  }
+  return res.json();
+}
 
-  return {
-    content: [{
-      type: 'text',
-      text: JSON.stringify({ leads, total: data.total, page: data.page }, null, 2),
-    }],
-  };
+async function mcpGet(action, params = {}) {
+  const qs = new URLSearchParams({ action, ...params });
+  const res = await fetch(`${BASE_URL}/api/mcp/agent?${qs}`, { headers: agentHeaders() });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error || `API hatası: ${res.status}`);
+  }
+  return res.json();
 }
 
-async function updateLeadStatus({ leadId, status }) {
-  const res = await fetch(`${BASE_URL}/api/mcp/leads/${leadId}`, {
-    method:  'PATCH',
+async function mcpPatch(action, body) {
+  const qs = new URLSearchParams({ action });
+  const res = await fetch(`${BASE_URL}/api/mcp/agent?${qs}`, {
+    method: 'PATCH',
     headers: agentHeaders(),
-    body:    JSON.stringify({ status }),
+    body: JSON.stringify(body),
   });
-  if (!res.ok) throw new Error(`API hatası: ${res.status}`);
+  if (!res.ok) {
+    const data = await res.json().catch(() => ({}));
+    throw new Error(data.error || `API hatası: ${res.status}`);
+  }
+  return res.json();
+}
 
-  return {
-    content: [{
-      type: 'text',
-      text: JSON.stringify({ success: true, leadId, status }, null, 2),
-    }],
-  };
+function textResult(data) {
+  return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
 }
 
-async function getMyListings({ status, page = 1, limit = 20 } = {}) {
-  const params = new URLSearchParams({ page: String(page), limit: String(limit) });
-  if (status) params.set('status', status);
-
-  const res = await fetch(`${BASE_URL}/api/mcp/listings?${params}`, { headers: agentHeaders() });
-  if (!res.ok) throw new Error(`API hatası: ${res.status}`);
-  const data = await res.json();
-
-  const listings = data.listings.map(l => ({
-    id:        l.id,
-    title:     l.title,
-    slug:      l.slug,
-    type:      l.type,
-    status:    l.status,
-    price:     `${l.priceTRY?.toLocaleString('tr-TR')} ₺`,
-    sqm:       l.sqmNet ? `${l.sqmNet}m²` : null,
-    rooms:     l.rooms || null,
-    city:      l.city?.name || null,
-    district:  l.district?.name || null,
-    leads:     l._count?.leads || 0,
-    url:       `https://evimnet.com/ilan/${l.slug}`,
-  }));
+async function getMyLeads({ status } = {}) {
+  const params = {};
+  if (status) params.status = status;
+  const data = await mcpGet('leads', params);
+  return textResult(data);
+}
 
-  return {
-    content: [{
-      type: 'text',
-      text: JSON.stringify({ listings, total: data.total }, null, 2),
-    }],
-  };
+async function getLeadDetail({ id }) {
+  const data = await mcpGet('lead', { id });
+  return textResult(data);
+}
+
+async function updateLeadStatus({ id, status }) {
+  const data = await mcpPatch('lead-status', { id, status });
+  return textResult(data);
+}
+
+async function getMyListings({ status } = {}) {
+  const params = {};
+  if (status) params.status = status;
+  const data = await mcpGet('listings', params);
+  return textResult(data);
+}
+
+async function getListingAnalytics({ id }) {
+  const data = await mcpGet('analytics', { id });
+  return textResult(data);
 }
 
 async function getMyStats() {
-  const res = await fetch(`${BASE_URL}/api/mcp/stats`, { headers: agentHeaders() });
-  if (!res.ok) throw new Error(`API hatası: ${res.status}`);
-  const data = await res.json();
+  const data = await mcpGet('stats');
+  return textResult(data);
+}
 
-  return {
-    content: [{
-      type: 'text',
-      text: JSON.stringify(data, null, 2),
-    }],
-  };
+async function createListing(args) {
+  const data = await mcpPost('create-listing', args);
+  return textResult(data);
+}
+
+async function updateListing(args) {
+  const data = await mcpPatch('update-listing', args);
+  return textResult(data);
 }