01 · Sistem nedir
Piyasayı sizin yerinize izleyen bir asistan — ama kararı size bırakan
Bu bir karar-destek sistemidir; otomatik alım-satım botu değildir. Kendi bilgisayarınızda, Claude Code içinde kurulur. Görevi tek: sizin izlediğiniz varlıkları (dolar, euro, birkaç coin) gözlemek, belirgin bir hareket olduğunda size sade bir özet + temsilî bir düşünme çerçevesi çıkarmak. İşlemi hiçbir zaman yapmaz.
Çalışma mantığı 6 adımlı bir döngüdür: TARA → FIRSAT → PLAN → RİSK → İZLE → KARAR. Sistem tarar, dikkat çeken hareketi işaretler, temsilî bir çerçeve çıkarır, riski kontrol eder, döngüyü tekrarlar ve önünüze tek sade bir karar notu koyar: BAK / GÖZLE / GEÇ. Butona hep siz basarsınız.
02 · Ne işinize yarar
Siz uyurken bir şey izlesin, fırsatı kaçırmayın — ama parayı riske atmasın
Gün boyu ekran başında duramıyorsunuz ama piyasayı da tamamen bırakmak istemiyorsunuz. Bu sistem tam o boşluğu doldurur: kendi izleme listenizi bir kez yazarsınız, o da sizin belirlediğiniz eşiklere göre "burada dikkat çeken bir hareket var" der. Sinyal vermez, "şu yükselecek" demez — sadece gürültüyü eler, dikkatinizi doğru yere çeker.
önce
Gün içinde 10 kez telefonu açıp kur/coin bakıyorsunuz, çoğu zaman bir şey değişmemiş. Bir gün bakmayınca da "acaba kaçırdım mı" diye tedirgin oluyorsunuz.
sonra
Sistem sizin eşiklerinizi bekler. Sakinse "her şey sakin" der, geçersiniz. Eşik aşılınca sade bir not çıkarır. Bakma yükünü o taşır, kararı siz verirsiniz.
03 · Gereken araçlar (hepsi ücretsiz, anahtar gerekmez)
Kod bilmenize gerek yok — üç ücretsiz kaynak, sıfır API anahtarı
Sistem tek bir ücretli araç, tek bir gizli anahtar istemez. Kullandığı veri kaynaklarının hepsi herkese açık ve resmî:
# Döviz — TCMB resmî günlük kur (en güvenilir)
https://www.tcmb.gov.tr/kurlar/today.xml
# Kripto — CoinGecko, anahtarsız, yakın-gerçek-zamanlı
https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=try
# (Opsiyonel) BIST — ~15 dk GECİKMELİ, canlı değildir, sadece bilgiTek gereksinim: bilgisayarınızda Claude Code kurulu olması (resmî kurulum: code.claude.com). Gerisini bu rehberdeki hazır dosyalar ve promptlar yapar.
04 · Önce bunu okuyun — yasal çerçeve
Bu sistem size ne vaat ediyor, ne vaat etmiyor
Dürüst olmak güveni artırır, o yüzden en baştan net: bu bir bilgi ve düşünme aracıdır, para kazanma makinesi değil.
Bu bir KARAR-DESTEK sistemidir; otomatik alım-satım botu DEĞİLDİR.
Sizin yerinize İŞLEM YAPMAZ. Bilgi toplar, özetler, temsilî çerçeve sunar.
Karar ve işlemi HER ZAMAN SİZ verirsiniz.
Tüm örnek rakam ve planlar TEMSİLÎDİR — al-sat önerisi değildir.
YATIRIM TAVSİYESİ DEĞİLDİR. Kâr veya kazanç garantisi verilmez.
Yatırım kararlarınız için lisanslı bir uzmana danışın.
Piyasa verisi gecikmeli olabilir (özellikle BIST ~15 dk).00
Önce sistemi indirin — kendini kurar
Bu bir rehber değil, çalışan bir sistemdir. Yukarıdaki ZIP'i indirin, açın ve içinden çıkan borsa-asistani klasöründe üç adım uygulayın:
# 1) Claude Code'u aç (kurulum: code.claude.com)
# 2) borsa-asistani klasöründe terminal aç ve başlat
claude
# 3) tek kelime yaz — gerisini proje kendisi yapar
kur"kur" komutunda sistem kendini kurar: Python'u kontrol eder, TCMB + CoinGecko verisinin canlı olduğunu test eder, örnek bir tarama çalıştırıp çalıştığını gösterir. Paket gerçek veriyle test edilmiş olarak gelir — indirdiğiniz gün çalışır.
Pakette ne var — ZIP'in içi
Aşağıdaki dosyaların hepsi ZIP'in içinde hazır gelir. Bu bölümler, sistemin içine ne koyduğumuzun dökümüdür — merak edenler için; kurulum için sadece "kur" yazmanız yeterli:
README.md > 3 adımlık başlangıç rehberi
CLAUDE.md > sistemin anayasası (kurallar + kendini kur)
izleme.md > senin izleme listen (kendi varlıkların)
araclar/tara.py > TCMB + CoinGecko veri çekici (key yok)
komutlar/1..6 > 6 modülün hazır Türkçe komutları
ornek-cikti.md > gerçek veriyle üretilmiş örnek çıktı05
Hiç kod bilmeyene 5 adımda kurulum
Aşağıdaki beş adımı sırayla yaparsınız. Kod yazmıyorsunuz; sadece hazır metinleri yapıştırıyorsunuz.
# 1) Boş bir klasör aç ve içinde Claude Code'u başlat
mkdir borsa-asistani
cd borsa-asistani
claude
# 2) Aşağıdaki CLAUDE.md içeriğini bir CLAUDE.md dosyasına yapıştır
# 3) İzleme listesini izleme.md dosyasına yapıştır (kendi varlıklarınla)
# 4) Modül promptlarını sırayla Claude'a ver (aşağıda)
# 5) "5 dakikada bir tekrarla" diyerek döngüyü başlat06
Sistemin beyni — CLAUDE.md (kopyala-yapıştır)
Bu tek dosya sistemin karakterini belirler: neyi yapar, neyi asla yapmaz. Klasörünüze CLAUDE.md adıyla kaydedin. Saklayın — bir daha yazmanıza gerek kalmaz.
# BORSA KARAR-DESTEK ASİSTANI — kurallar
Sen benim borsa KARAR-DESTEK asistanımsın. Görevin: izleme listemdeki
varlıkları takip etmek, hareketleri özetlemek, temsilî bir düşünme
çerçevesi sunmak.
MUTLAK KURALLAR:
- ASLA "al", "sat", "şu yükselecek/düşecek" DEME. Sinyal/tavsiye VERME.
- Her plan ve karar çıktının başına şunu yaz:
"TEMSİLÎ ÖRNEK — yatırım tavsiyesi değildir."
- Kararı DAİMA bana bırak. Sen akıl verirsin, işlemi ben yaparım.
- Çekemediğin/bilmediğin veriyi UYDURMA. "Veri alınamadı" de.
- Rakamları sade, Türkçe, jargonsuz anlat.
VERİ KAYNAKLARI (ücretsiz, anahtar gerekmez):
- Döviz: https://www.tcmb.gov.tr/kurlar/today.xml (TCMB resmî, günlük)
- Kripto: https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=try
- (Opsiyonel) BIST: ~15 dk GECİKMELİ, gerçek zamanlı değil.
İzleme listem: izleme.md dosyasında. Önceki değerleri de oraya yazıp kıyasla.07
İzleme listeniz — izleme.md (kendi varlıklarınızı yazın)
Neyi izleyeceğinizi ve hangi yüzde harekette dikkat isteyeceğinizi burada belirlersiniz. Eşik ne kadar küçükse o kadar hassas olur.
# İzleme listem
- USD/TRY | eşik: %1
- EUR/TRY | eşik: %1
- bitcoin | eşik: %3
- ethereum | eşik: %3
# (son değerler buraya otomatik yazılır)08
6 modülün hazır Türkçe promptları
Her birini sırayla Claude'a yapıştırın. Sistem çıktıyı size şablona dökülmüş ve damgalı verir.
İzleme listemdeki (izleme.md) her varlığın güncel fiyatını yukarıdaki ücretsiz kaynaklardan çek. Sade bir tablo yap: varlık, şu anki değer, önceki değere göre % değişim. Tabloyu şu sütunlarla ver: Varlık | Şu an | Önceki | % değişim.Her varlık için değişimi izleme.md'deki eşikle kıyasla. Eşiği aşanları "dikkat çeken hareket" olarak işaretle, eşik altındakileri "sakin" say. Bu bir alım-satım sinyali DEĞİL, sadece dikkat notudur.Dikkat çeken bir varlık için TEMSİLÎ bir düşünme çerçevesi çıkar: hangi seviyeye bakılabilir, hangi durumda vazgeçilir, ne izlenir. Çıktının başına "TEMSİLÎ ÖRNEK — yatırım tavsiyesi değildir" yaz. Gerçek al-sat rakamı verme.Şu 4 soruyu benim yerime kontrol et ve işaretle: (1) Bu hareket eşiğimi gerçekten aştı mı? (2) Toplam ne kadarına bakıyorum? (3) Ani düşüşte ne kaybederim? (4) En kötü senaryoyu göze alabilir miyim? Cevaplayamadığını "belirsiz" işaretle.Bu taramayı her 5 dakikada bir tekrarla (veri kaynağı sınırlarına saygı için daha sık deneme). Yeni bir eşik aşımı olursa bana bildir, olmazsa "her şey sakin" de.Bana TEK sade özet ver: her dikkat çeken varlık için > BAK / GÖZLE / GEÇ. Sonuna şunu yaz: "Kararı sen verirsin. Bu yatırım tavsiyesi değildir."09
Gerçek örnek çıktı (temsilî — sistemin ürettiği)
Aşağıdaki çıktı, bu rehber yayınlanmadan önce sistemin gerçek TCMB ve CoinGecko verisiyle ürettiği örnektir. Varlık adları gerçek, ama karar çerçevesi ve senaryo temsilîdir.
MODÜL 1 — TARA | TEMSİLÎ ÖRNEK — yatırım tavsiyesi değildir
Varlık Şu an Önceki % değişim
USD/TRY 47,11 46,82 +0,63%
EUR/TRY 53,81 53,71 +0,18%
bitcoin 3.142.406 3.000.000 +4,75%
ethereum 90.902 89.600 +1,45%
MODÜL 2 — FIRSAT
· USD/TRY %0,63 — sakin (eşik %1)
⚠ bitcoin %4,75 — eşik %3 AŞILDI > dikkat çeken hareket
MODÜL 3 — PLAN | TEMSİLÎ ÖRNEK — yatırım tavsiyesi değildir
Dikkat çeken: bitcoin (%4,75)
• Nereye bakılır: değişimin sürüp sürmediği
• Vazgeçme: yön tersine dönerse dikkat notu düşer
MODÜL 6 — KARAR
bitcoin: GÖZLE (hareket eşiği aştı, yön netleşsin)
diğerleri: GEÇ (sakin)
Kararı sen verirsin. Bu yatırım tavsiyesi değildir.10
Bu sistem size ne VAAT ETMEZ
Dürüstlük kontrol listesi — kurmadan önce okuyun:
1) Kâr vaat etmez. "Kazandıracak" demez.
2) Al-sat sinyali vermez. "Şunu al" demez.
3) Senin yerine işlem yapmaz. Butona sen basarsın.
4) Geleceği bilmez. Sadece geçmiş/anlık veriyi özetler.
5) Danışman değildir. Lisanslı uzmanın yerine geçmez.11
Son kontrol — kurdum mu? (10 kutu)
[ ] 1) Claude Code klasörümü açtım
[ ] 2) CLAUDE.md dosyasını oluşturdum ve yapıştırdım
[ ] 3) izleme.md'ye kendi varlıklarımı yazdım
[ ] 4) Her varlık için bir eşik (%) belirledim
[ ] 5) TARA promptunu çalıştırdım, tablo geldi
[ ] 6) FIRSAT promptu eşik kıyasını yaptı
[ ] 7) PLAN/KARAR çıktısında "temsilî / tavsiye değildir" damgasını gördüm
[ ] 8) İZLE promptuyla 5 dk döngüyü başlattım
[ ] 9) "Al-sat" diyen bir çıktı gelmediğini doğruladım
[ ] 10) Kararı benim vereceğimi kabul ediyorum12
Sırada ne var — sistemi kendinize göre büyütün
Çekirdek çalışınca sistemi kendi ihtiyacınıza göre genişletebilirsiniz — hepsi aynı CLAUDE.md mantığında, yeni araç gerekmez:
• Yeni varlık ekleyin: izleme.md'ye bir satır daha yazın (ör. USD/EUR | eşik: %0.5).
• Eşiği kişiselleştirin: çok bildirim geliyorsa eşiği büyütün, az geliyorsa küçültün.
• BIST ekleyin (opsiyonel): gecikmeli veriyi kabul ederseniz borsapy ile hisse ekleyebilirsiniz — ama "canlı" saymayın, ~15 dk geridedir.
• Günlük özet: "her sabah 09:00'da tek özet çıkar" diyerek döngüyü seyreltebilirsiniz.
Bu tarz sistemleri düzenli paylaşıyorum — takip edin, bir sonrakini kaçırmayın: @kaandoganai