kelepeye

KelepEye

Kelepir mi, kazık mı? KelepEye’a sor.

Sahibinden ve Letgo’daki ikinci el bilgisayar/elektronik ilanlarını (ekran kartı, işlemci, laptop, masaüstü, telefon) analiz eden, yapay zeka destekli Chrome eklentisi. İlanı, sıfır piyasa fiyatını, ikinci el emsalleri, forum bilgisini ve mağaza yorumlarını birleştirip AL / PAZARLIK YAP / ALMA kararı, olması gereken fiyat, teklif fiyatı, vazgeçme fiyatı ve gerekçeli bir özet üretir.

Klasör	İçerik
`extension/`	Chrome MV3 eklentisi (sahibinden/letgo ayrıştırıcıları + side panel)
`backend/`	FastAPI: analiz uç noktası, emsal/sıfır fiyat, forum araması, Google Places
`decision-engine/`	Karar modeli (`karar` paketi): risk kuralları, fiyat modeli, darboğaz, Claude anlatımı
`ingestion/`	İzinli forum kaynaklarından veri toplama, döküm ve fiyat içe aktarma
`shared/`	Modüller arası JSON şemaları ve veritabanı şeması
`docs/`	Plan ve ajan görev tanımları
`site/`	Tanıtım sayfası ve uygulamalı demo (kelepeye.dormhi.com)

Nasıl çalışır

Eklenti, açık ilan sayfasından başlık, fiyat, açıklama ve özellikleri okur. Satıcı adı/telefonu okunmaz; açıklamadaki telefon/e-posta gizlenir.
Backend ürünü kanonik kataloğa eşler (RTX3060Ti → gpu/nvidia/rtx-3060-ti), sıfır fiyatı, son 60 günün emsallerini, forum kanıtlarını ve mağaza yorumlarını toplar.
Karar motoru deterministik olarak riskleri (ilandan birebir alıntıyla), adil/teklif/vazgeçme fiyatlarını ve darboğazı hesaplar.
Claude bu sonuçları Türkçe ana yoruma çevirir. Çıktı doğrulanır: uydurma alıntı, kaynaksız forum iddiası veya motorun üretmediği bir TL tutarı varsa ilgili kısım atılır ya da şablon özete düşülür.

Kurulum (yerel)

pip install -e decision-engine -e backend -e ingestion pytest

cd backend && API_KEYS=dev ADMIN_KEY=degistir ANTHROPIC_API_KEY=... uvicorn api.main:app --port 8787

Eklenti: chrome://extensions → Geliştirici modu → Paketlenmemiş öğe yükle → extension/ klasörü. Side panel’deki ⚙ Ayarlar’dan API anahtarını (dev) ve kendi sistemini (darboğaz analizi için) gir.

Demo modu

Gerçek ilan sayfası ve piyasa verisi olmadan ürünü göstermek için:

extension/demo/start-backend.sh

Bu komut backend’i ayrı bir demo veritabanıyla (data/demo.db) başlatır ve extension/demo/market-prices.json içindeki örnek sıfır fiyatları yükler. Ardından eklenti panelinde Örnek ilanlarla dene düğmesine basılır. Beş kurgusal senaryo vardır: riskli kart, temiz kart, darboğaz, dolandırıcılık şüphesi, pinleri düzeltilmiş işlemci. Demo ilanları ve fiyatları kurgusaldır, panelde DEMO etiketiyle gösterilir ve emsal havuzuna hiçbir zaman eklenmez.

Demo testi (demo backend’i çalışırken):

NODE_PATH=$(npm root -g) node extension/tests/demo.mjs

Ortam değişkenleri

Değişken	Açıklama
`ANTHROPIC_API_KEY`	Claude anlatım katmanı. Yoksa şablon özet kullanılır.
`KARAR_MODEL` / `KARAR_EFFORT`	Varsayılan `claude-opus-5-5` / `medium`
`KARAR_LLM=off`	LLM’i tamamen kapatır
`API_KEYS`	Virgülle ayrılmış eklenti anahtarları (boşsa auth kapalı — sadece yerel)
`ADMIN_KEY`	`/v1/admin/*` uç noktaları
`GOOGLE_PLACES_API_KEY`	Mağaza satıcıları için Google puan/yorumları
`DB_PATH`	SQLite dosyası (varsayılan `data/app.db`)

Veri besleme

python -m ingest status

python -m ingest market-prices fiyatlar.csv

python -m ingest import-dump donanimarsivi dokum.jsonl

python -m ingest crawl donanimarsivi

Forum kaynakları ingestion/sources.json içinde izin kapısıyla korunur: permission.granted=true ve ingestion/permissions/<kaynak>.md olmadan crawl / import-dump çalışmaz. Detay: python -m ingest --help.

Test

KARAR_LLM=off pytest -q decision-engine/tests backend/tests ingestion/tests

Uçtan uca (backend 8787’de çalışırken, Playwright gerekli):

NODE_PATH=$(npm root -g) node extension/tests/e2e.mjs

Plan ve ilerleme: docs/PLAN.md

Lisans

AGPL-3.0. “KelepEye” adı ve logosu lisansa dahil değildir; çatallanan sürümler bu adı kullanamaz.