portfoy-yonetimi

A Claude Code skill for Turkish macro & portfolio analysis. Tracks positions over time, audits decisions, calibrates predictions, and generates visual P&L reports — all powered by live data from TEFAS, TCMB EVDS, KAP, and financial news sources.

Türkiye ekonomisi, BIST hisseleri ve TEFAS fonları odaklı kıdemli portföy analiz partneri. Tek seferlik analiz değil — portföyü zaman içinde takip eden, kararları denetleyen, kullanıcının öngörü kalitesini haritalandıran kalıcı bir sistem.

Kurulum

1. Skill'i kopyala

cp -r portfoy-yonetimi ~/.claude/skills/

2. Python bağımlılıklarını kur

pip3 install -r ~/.claude/skills/portfoy-yonetimi/requirements.txt

Gerekli paketler: matplotlib, pyyaml

3. TCMB EVDS API anahtarı al (ücretsiz)

1. https://evds2.tcmb.gov.tr/index.php?/evds/login adresinden kayıt ol
2. API anahtarını shell profiline ekle:

echo 'export EVDS_API_KEY=<senin-anahtarın>' >> ~/.zshrc
source ~/.zshrc

4. Chrome MCP (opsiyonel ama önerilen)

TEFAS ve JS-render finansal siteler için Chrome MCP browser otomasyonu gerekir. Claude Code'da Chrome MCP kurulu değilse skill yine çalışır ama fon verisi sınırlı kalır.

Ne yapar?

Portföy takibi

• ~/portfoy/snapshots/ altında tarihli YAML snapshot'lar oluşturur
• Pozisyon ekleme/çıkarma diff'i çıkarır
• Kapatılan pozisyonları verdict matrisi ile denetler (doğru/yanlış gerekçe x sonuç)
• 5 grafik türü: P&L + projeksiyon, drawdown, rolling getiri, varlık sınıfı dağılımı, korelasyon heatmap

Kantitatif analiz

• Risk metrikleri: Sharpe, Sortino, max drawdown, Calmar, yıllıklaştırılmış volatilite
• Benchmark karşılaştırması: BIST-100'e karşı alfa, tracking error, information ratio
• Korelasyon analizi: pozisyonlar arası Pearson korelasyon + HHI konsantrasyon
• Performans attribution: varlık sınıfı bazlı getiri dekompozisyonu, FX ayrıştırma
• Stres testi: kur şoku, BIST çöküşü, faiz artışı, stagflasyon ve custom senaryolar
• Rebalancing sinyali: hedef dağılımdan sapma tespiti ve düzeltme önerisi
• Maliyet takibi: stopaj, komisyon, brüt vs net getiri karşılaştırması

Canlı veri

• TEFAS fonları: fiyat, AUM, getiri, kompozisyon (Chrome MCP veya API fallback)
• TCMB EVDS: faiz, kur, TÜFE, çekirdek enflasyon, net rezerv, M2 (API script)
• KAP: şirket/fon duyuruları
• Haber: Bloomberg HT, Reuters TR, AA Finans, Foreks

Analiz metodolojisi

• Sayılarla konuşma (genel ifade yasak)
• Mekanizma sökme (sistemi işleyen parçalara ayırma)
• Asimetrik tehdit ve fırsat avı (öcü kuralı: sadece risk söyleme)
• Dengeli olasılıklı senaryolar (baz / aşağı kırılma / yukarı yumuşama)
• Aksiyon miladı (tarih + eşik ile somut çıktı)
• Predictions kalibrasyon (kullanıcının öngörü kalitesini zamanla ölçme)

Dosya yapısı

~/.claude/skills/portfoy-yonetimi/
  SKILL.md                    # ana skill prompt
  README.md                   # bu dosya
  CHANGELOG.md                # versiyon geçmişi
  LICENSE                     # MIT
  requirements.txt            # Python bağımlılıkları
  scripts/
    portfolio_analytics.py    # kantitatif analiz motoru (risk, benchmark, stres, rebalance)
    portfolio_chart.py        # 5 grafik türü (P&L, drawdown, rolling, allocation, correlation)
    evds_fetch.py             # TCMB EVDS veri çekme
    tefas_fund.py             # TEFAS API fallback
  docs/
    DESIGN.md                 # tasarım belgesi
    sources.yaml              # tüm veri kaynağı URL'leri ve metadata
  examples/
    example_snapshot.md        # örnek portföy snapshot'ı
    example_journal.md         # örnek denetim defteri
    example_predictions.md     # örnek tahmin kalibrasyonu
  tests/
    conftest.py               # paylaşılan test fixture'ları
    test_portfolio_chart.py    # grafik üretim testleri
    test_evds_fetch.py         # EVDS script testleri
    test_tefas_fund.py         # TEFAS script testleri

~/portfoy/                     # kullanıcı verisi (skill repo'suna girmez)
  snapshots/<YYYY-MM-DD>.md
  predictions.md
  journal.md
  charts/<YYYY-MM-DD>.png

Kullanım

Skill, portföy/fon/hisse/makro ile ilgili sorularda otomatik tetiklenir:

• "BIST bugün nasıl?" — direkt snapshot analiz
• "TI4 nasıl?" — fon detay analizi
• "TI4 mü AAK mı?" — karşılaştırma
• "Portföyümü analiz et" — tam portföy snapshot oluşturma
• "Portföyümü güncelledim" — diff + verdict matrisi
• "Grafik göster" — P&L chart üretimi

Scriptleri doğrudan çalıştırma

# Kantitatif analiz (tüm raporlar)
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_analytics.py --report full

# Tek rapor türleri
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_analytics.py --report risk
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_analytics.py --report benchmark
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_analytics.py --report stress
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_analytics.py --report rebalance
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_analytics.py --report costs

# Stres testi (custom parametreler)
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_analytics.py \
  --report stress --stress-params "equity_tr:-30,fx:+15"

# Grafikler
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_chart.py --chart pnl --open
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_chart.py --chart drawdown
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_chart.py --chart rolling
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_chart.py --chart allocation
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_chart.py --chart correlation
python3 ~/.claude/skills/portfoy-yonetimi/scripts/portfolio_chart.py --chart all

# EVDS'ten makro veri çek
python3 ~/.claude/skills/portfoy-yonetimi/scripts/evds_fetch.py \
  --series TP.PY.P01,TP.DK.USD.A.YTL --days 90

# TEFAS fon verisi (API fallback)
python3 ~/.claude/skills/portfoy-yonetimi/scripts/tefas_fund.py \
  --code TI4 --days 30

Testler

cd ~/.claude/skills/portfoy-yonetimi
pip3 install pytest
pytest tests/ -v

Kapsam

V1 dahil: BIST hisseleri, TEFAS fonları, tahvil, mevduat, döviz, altın, ABD hisseleri V1 kapsam dışı: kripto, opsiyon, VIOP vadeli işlem, FX türevleri, structured products

Kısıtlar

• Real-time tick fiyat yok (TEFAS gün sonu, hisseler 15-30 dk gecikme)
• Otomatik emir gönderme yok (sadece analiz)
• Vergi/hukuk danışmanı değil
• TEFAS API kararsız olabilir (Chrome MCP tercih edilir)

Lisans

MIT