--- name: turkey-real-estate description: متابعة أسعار شقق تركيا (خاصة أفجلار/إسطنبول) من المواقع التركية الرئيسية. يدعم sahibinden.com, hepsiemlak.com, endeksa, emlakjet. يستخدم Firecrawl/Oxylabs/Playwright للـ scraping (مجاني تماماً - بديل لـ Polygon real-estate). يخزن البيانات في LanceDB للمقارنة التاريخية + تنبيهات تغير الأسعار + تقارير دورية. license: MIT ---

Turkey Real Estate Scraper (للأخ د. وائل — شقتاه في تركيا)

نظام متكامل لمتابعة أسعار شقق تركيا، خاصة منطقة أفجلار / إسطنبول حيث يمتلك د. وائل شقتين.

المواقع المدعومة

| الموقع | المحتوى | الـ scraper | |---|---|---| | sahibinden.com | الأشهر — مبيعات + إيجار | Oxylabs + Playwright | | hepsiemlak.com | عقارات متنوعة | Firecrawl | | emlakjet.com | مبيعات | Firecrawl | | endeksa.com | مؤشرات الأسعار + احصائيات | requests + bs4 | | zingat.com | البحث المتقدم | Firecrawl |

Features

• 🔍 بحث عقاري متقدم (منطقة + سعر + غرف + مساحة)
• 📊 تحليل تاريخي للأسعار (اتجاه الزيادة/النقصان)
• 🔔 تنبيهات عند تغير سعر مماثل لشقتك
• 💱 تحويل تلقائي TL → USD → KWD
• 📍 جيوكودينج (إحداثيات الشقق على الخريطة)
• 📈 تقرير أسبوعي ضمن weekly investment report
• 🤖 تنبؤ السعر القادم (مع MiroFish)

Environment

bash
FIRECRAWL_API_KEY=...     # عندنا ✅
OXYLABS_AISTUDIO_API_KEY=... # عندنا ✅
TR_REA_DB=/data/.openclaw/workspace/turkey-real-estate/db/  # LanceDB

Commands

📍 Avcılar focus (مفضل لـ د. وائل)

bash
python3 tr_realestate.py avcilar --days 30

يجيب أحدث 30 يوم لشقق أفجلار + متوسط السعر + اتجاه السوق

🔍 بحث مخصص

bash
python3 tr_realestate.py search --city istanbul --district avcilar \
  --rooms 2+1 --min-area 90 --max-area 130 \
  --max-price-tl 5000000

📊 سعر شقة معينة (متابعة)

bash
python3 tr_realestate.py track --listing-url https://www.sahibinden.com/ilan/xxx
python3 tr_realestate.py tracked --limit 10

📈 تحليل سوق

bash
python3 tr_realestate.py analyze avcilar --period 90  # 90 يوم
Output: avg price, m² price, change %, hot listings, deals

🔔 تنبيهات

bash
python3 tr_realestate.py alert --district avcilar \
  --max-price-tl 4500000 --min-rooms 2+1
Saves alert config; weekly heartbeat checks for matches

💱 تحويل عملات

bash
python3 tr_realestate.py fx --amount 4500000 --from TL --to KWD

📋 تقرير أسبوعي

bash
python3 tr_realestate.py weekly-report
يظهر في weekly investment report تلقائياً

Schema

LanceDB table tr_listings:

• id (sahibinden_id or generated)
• source (sahibinden|hepsiemlak|emlakjet)
• url, title, district, city, coordinates
• price_tl, price_usd, price_kwd
• area_m2, rooms, floor, building_age
• embedding (description vector for semantic search)
• scraped_at, tracked (bool)

Privacy

• لا scraping متلكأ (يستخدم rate limiting + احترام robots.txt)
• لا login credentials needed
• البيانات تخزن محلياً فقط

Cost vs Polygon Real Estate

| | Polygon Real Estate | This Skill | |---|---|---| | US data | ✅ | ❌ | | Turkey data | ❌ | ✅ | | Subscription | $99+/شهر | 🆓 | | Customization | ⚠️ Limited | ✅ Full | | Avcılar focus | ❌ | ✅ |