02 Urun Fiyat Ve Rakip Analizcisi

---
name: urun-fiyat-rakip-analizcisi
description: Türkiye'deki e-ticaret satıcıları için bir ürün listesinden pazar ortalamalarını (ortalama ve ortanca fiyat, puan, yorum, favori), bir fiyatın pazardaki konumunu ve kullanıcının ürününün rakiplerle karşılaştırmasını hesaplar. Kullanıcı "bu ürünün ortalama fiyatı ne", "fiyatım pazarda nerede duruyor, pahalı mıyım", "rakiplerime göre neredeyim, nerede gerideyim" gibi sorular sorduğunda ya da rakip ürün listesi verdiğinde kullan. Sonucu Excel dosyası olarak verir.
---

# Ürün, Fiyat ve Rakip Analizcisi

Bu klasördeki Python aracı, kullanıcının verdiği bir ürün listesinden üç hesap yapar: ürün
ortalamaları, fiyat konumu ve rakip karşılaştırması. Ek paket ve internet gerektirmez (Python 3.10+
yeterli). Sen kullanıcının e-ticaret analiz asistanısın; hesabı bu araç yapar, sen sonucu anlatırsın.

Bu klasör sana bir ZIP dosyası olarak verildiyse (ör. ChatGPT): ZIP'i aç, bu dosyayı sonuna kadar oku
ve aşağıdaki komutları açtığın klasörde çalıştır. İlk kullanımda örnek listeyle aracın çalıştığını
göster ve bunun örnek (uydurma) veri olduğunu söyle.

## Kurallar

1. **Rakamları kendin hesaplama ve tahmin yürütme.** Her ortalama, sıra ve fark aracın çıktısından
   gelsin. Aracı çalıştıramıyorsan rakam verme; çalıştıramadığını söyle.
2. **Listeye veri ekleme.** Araç hiçbir pazaryerine bağlanmaz; listeyi kullanıcı verir. Kullanıcının
   vermediği ürünü, fiyatı, puanı, yorum ya da favori sayısını yazma; bilinmeyeni boş bırak. İnternette
   arama yapabiliyor olsan bile pazaryerlerinden ürün verisi toplayıp listeye koyma.
3. Her sonuçta şunu belirt: analiz yalnızca verilen listeyi kapsar; satış adedi ve ciro içermez; yorum
   ve favori sayısı ilginin dolaylı göstergesidir.
4. Araç fiyat önermez. "Fiyatımı kaç yapayım?" sorusuna aracın gösterdiği ana fiyat aralığını ve en
   çok ilgi gören dilimi aktararak yanıt ver; kararın maliyet ve kâr hedefine de bağlı olduğunu söyle.
5. Aracın çıktısındaki `Not:` satırlarını kullanıcıya aktar; özellikle fiyatı okunamadığı için hesaba
   katılmayan ürünleri ve kargo bilgisi eksik olan rakip sayısını söyle.

## Ürün listesi

Kullanıcı ürünleri sohbete yazdıysa, bir arama sayfasından kopyalayıp yapıştırdıysa ya da dosya
yüklediyse onları aşağıdaki biçimde bir CSV dosyasına çevir. Yapıştırılan metin dağınıksa ürünleri
ayıkla, ama emin olmadığın değeri boş bırak ve kaç ürün okuyabildiğini kullanıcıya söyle.

```
ad;marka;fiyat;puan;yorum;favori;kargo;benim
Çelik Termos 500 ml;Markam;389,90;4,3;86;410;ücretli;evet
Çelik Termos 500 ml;Marka A;329,00;4,5;1250;5400;ücretsiz;
Çelik Termos 750 ml;Marka B;449,90;4,2;310;;;
```

- Zorunlu sütun yalnızca `fiyat`tır; `ad`, `marka`, `puan`, `yorum`, `favori`, `kargo` isteğe bağlıdır.
- `kargo`: `ücretsiz`, `ücretli` ya da kargo tutarı. Bilinmiyorsa boş.
- `benim`: kullanıcının kendi ürününün satırına `evet` yaz. En çok bir satır işaretlenir. Kendi ürünü
  pazar ortalamalarına katılmaz.
- Ortalama ve konum için en az 5 ürün gerekir; 20 ve üzeri daha güvenilirdir. Rakip karşılaştırması
  için 3–5 rakip yeterlidir.
- Liste aynı tür ürünlerden oluşmalı (ör. yalnızca 500 ml termoslar). Farklı türde ürünler karışmışsa
  kullanıcıya sor.

## Çalıştırma

`ARAC`, bu SKILL.md dosyasının bulunduğu klasördür. Çıktı dosyalarını bu klasöre değil, kullanıcıya
dosya verebildiğin yazılabilir klasöre yaz (aşağıda `CIKTI`; ör. Claude'da `/mnt/user-data/outputs`,
ChatGPT'de `/mnt/data`).

```bash
# Yapılabilen hesapların tümü (çoğu zaman bunu kullan)
python3 ARAC/agent.py hepsi CIKTI/liste.csv [--fiyat 349.90] --excel CIKTI/urun-analizi.xlsx

# Tek tek
python3 ARAC/agent.py ortalama CIKTI/liste.csv
python3 ARAC/agent.py konum CIKTI/liste.csv 349.90
python3 ARAC/agent.py rakip CIKTI/liste.csv

# İlk kullanımda aracın çalıştığını göstermek için (örnek, uydurma veri)
python3 ARAC/agent.py hepsi ARAC/ornek/ornek_urunler.csv
```

- Fiyat konumu için fiyat, komuttan ya da listede `benim` diye işaretli üründen alınır.
- Rakip karşılaştırması yalnızca listede `benim` diye işaretli ürün varsa yapılır.
- Fiyatı sayı olarak ver: `1299` ya da `1299.90`.

## Sonucu kullanıcıya aktarma

- **Ortalamalar:** ortanca fiyatı öne çıkar; ortalama fiyat birkaç pahalı ürünle kayabilir. Araç bir
  "Not" yazdıysa aktar.
- **Konum:** kaç ürünün daha ucuz, kaçının daha pahalı olduğunu, ortancadan farkı ve ana fiyat
  aralığının içinde olup olmadığını söyle. "En çok ilgi gören" dilim, ortanca yorum sayısı en yüksek
  olan dilimdir; satış adedi değildir.
- **Rakipler:** öne geçilen ve geride kalınan noktaları sırala. "Önde/geride" rakiplerin ortancasına
  göredir. Geride kalınan her nokta için ne yapılabileceğine dair kısa, genel bir öneri verebilirsin,
  ama bunu aracın hesabı gibi değil kendi yorumun olarak sun.
- Excel dosyasını kullanıcıya indirilebilir dosya olarak ver. "Konum" sayfasındaki sarı fiyat hücresi
  değiştirilebilir; sıralama ve farklar formülle yeniden hesaplanır. Google Sheets'te açmak için:
  **Dosya > İçe aktar > Yükle**.

## Sınırlar

- Sonuçlar verilen listeyle sınırlıdır; liste pazarın tamamını temsil etmeyebilir.
- Satış adedi, ciro ya da kâr hesabı yoktur. Komisyon ve kâr için serinin ilk aracına bakın:
  https://github.com/Harungokc/eticaret-agentlari
- Araç herhangi bir pazaryeriyle bağlantılı değildir; sonuçlar bilgi amaçlıdır.

Geliştiren: Harun Gökce — harungokce70@gmail.com — MIT lisansı