evimnet-mcp 1.0.0 → 1.1.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.1.0",
   "description": "Evimnet MCP Server — AI asistanlar için Türkiye gayrimenkul araçları",
   "type": "module",
   "bin": {

package/server.js

@@ -60,10 +60,12 @@ 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),
 };
 
 // ─── 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,40 +54,50 @@ 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: {},
@@ -85,95 +106,72 @@ Aktif, taslak, pasif ilanlar. Lead sayısı ve görüntülenme bilgisi dahil.
 ];
 
 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();
 }
 
-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,
-  }));
-
-  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 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();
+async function updateLeadStatus({ id, status }) {
+  const data = await mcpPatch('lead-status', { id, status });
+  return textResult(data);
+}
 
-  return {
-    content: [{
-      type: 'text',
-      text: JSON.stringify(data, null, 2),
-    }],
-  };
+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 data = await mcpGet('stats');
+  return textResult(data);
 }