Python ve Yapay Zeka ile TEFAS Fon ve BIST Verilerini Çekme Rehberi (API & Claude MCP)

Türkiye Finans Piyasalarında Veri Çekme Çilesi: Neden Scraper'lar Çıkmaz Sokak?

Türkiye'de borsa, fon veya döviz verisiyle algoritmik işlem yapmak, veri analizi yürütmek veya kişisel yatırım botu geliştirmek isteyen her yazılımcının ilk karşılaştığı duvar veri erişimindeki yetersizliktir.

Geliştiricilerin yıllardır izlediği geleneksel yöntem genelde şöyledir:

• Selenium veya BeautifulSoup ile TEFAS web sitesini kazımaya (scraping) çalışmak.
• Yahoo Finance üzerinden .IS uzantısıyla BIST hisselerini çekmeyi denemek.
• KAP'ın karmaşık tablo yapısından bilanço ve bildirim ayıklamak.

Ancak bu yöntemlerin ömrü en fazla birkaç aydır. TEFAS sitede küçük bir JavaScript parametresini değiştirdiği an tüm crawler'lar çöker, IP adresleri hız sınırına takılır ya da sunucular engellenir.

Bu rehberde, sıfır dış bağımlılık (zero-dependency) ile çalışan modern iki yolu inceleyeceğiz: Resmi Python SDK ve 2026'nın en popüler yapay zeka arayüz standardı olan Model Context Protocol (MCP).

Yöntem 1: Python SDK ile 3 Satırda Veri Çekme

Bürküt Açık Kaynak Finans SDK, arka plandaki güçlü ve önbellek destekli REST API'yi Python geliştiricilerine temiz, hızlı ve tip güvenli (type-safe) olarak sunar.

1. Kütüphaneyi Yükleyin

pip install burkut

2. TEFAS Fon Getirilerini Sıralama Örneği

Aşağıdaki kod parçasıyla, TEFAS'taki tüm fonları tarayabilir ve son 1 yılda en yüksek getiri sağlayan fonları tek bir satırda filtreleyebilirsiniz:

from burkut import BurkutClient

# API anahtarsız da temel modda kullanılabilir
client = BurkutClient()

# TEFAS fonlarını çek
funds = client.funds.list()

# 1 yıllık getirisine göre büyükten küçüğe sırala ve ilk 5 fonu yazdır
top_funds = sorted([f for f in funds if f.yield_1y is not None], key=lambda x: x.yield_1y, reverse=True)[:5]

for fund in top_funds:
    print(f"{fund.symbol} - {fund.name}: %{fund.yield_1y:.2f} Yıllık Getiri")

3. BIST Hisse Fiyatı ve Günlük Değişim Çekme

# THYAO hisse detayını al
quote = client.stocks.get("THYAO")
print(f"{quote.symbol} Fiyatı: {quote.current_price} TL (Günlük Değişim: %{quote.daily_change_pct})")

Artık ne kırılan HTML ayrıştırıcılarıyla uğraşmanız gerekir ne de gecikmeli veri parse etme zahmetine girersiniz.

Yöntem 2: Claude Desktop ve Cursor'a Borsa Piyasasını Bağlamak (Bürküt MCP)

2026 yılı itibarıyla birçok veri analisti ve yatırımcı kod yazmak yerine yapay zeka ajanlarıyla sohbet ederek analiz yapmayı tercih ediyor. Bürküt tarafından geliştirilen açık kaynaklı burkut-mcp sunucusu sayesinde Claude Desktop veya Cursor IDE'ye Türkiye piyasalarını tek komutla entegre edebilirsiniz.

Claude Desktop Kurulumu (30 Saniye)

Claude Desktop ayar dosyanıza (claude_desktop_config.json) aşağıdaki bloğu ekleyin:

{
  "mcpServers": {
    "burkut": {
      "command": "npx",
      "args": ["-y", "burkut-mcp"],
      "env": {
        "BURKUT_API_KEY": "BURKUT_API_ANAHTARINIZ"
      }
    }
  }
}

Not: Geliştirici Portalından ücretsiz oluşturacağınız API anahtarını BURKUT_API_KEY alanına eklemeniz yeterlidir.

Claude Desktop'ı yeniden başlattığınızda yapay zekanız doğrudan Bürküt API'ye bağlanır. Artık Claude'a şu soruları doğrudan Türkçe olarak yöneltebilirsiniz:

• "Bana TEFAS'taki hisse senedi yoğun fonlar arasında 1 yılda en çok kazandıran 5 fonu listele ve risk seviyelerini karşılaştır."
• "Bugün KAP'a düşen yeni iş ilişkisi ve kâr payı dağıtım bildirimlerini özetle."
• "Bu ay talep toplayacak halka arzların dağıtım yöntemi ve fiyatları nedir?"
• "FROTO ve TUPRS şirketlerinin temettü geçmişini ve verimlerini karşılaştırmalı tablo yap."

Claude, arka planda burkut-mcp araçlarını çalıştırarak canlı verileri çeker, yorumlar ve profesyonel bir finansal analist gibi önünüze serer.

cURL ile Doğrudan REST API Entegrasyonu

Eğer Go, Python, C#, Rust veya başka bir dilde geliştirme yapıyorsanız, resmi geliştirici uç noktalarını (/api/public/v1) doğrudan HTTP istekleriyle kullanabilirsiniz:

# BIST Hisse Senedi Fiyatı Al (15 dk gecikmeli resmi veri)
curl -X GET "https://api.burkutportfoy.com/api/public/v1/stocks/THYAO"   -H "X-API-Key: bk_live_YOUR_API_KEY"

# TEFAS Fon Listesini ve Günlük Getirileri Çek
curl -X GET "https://api.burkutportfoy.com/api/public/v1/funds"   -H "X-API-Key: bk_live_YOUR_API_KEY"

# Serbest Piyasa Döviz ve Altın Kurlarını Al
curl -X GET "https://api.burkutportfoy.com/api/public/v1/forex/USD"   -H "X-API-Key: bk_live_YOUR_API_KEY"

Ücretsiz API Anahtarı ve Hızlı Başlangıç

Bürküt Geliştirici API'si hem bireysel araştırmacılara hem de kurumsal geliştiricilere yönelik tasarlanmıştır. Güvenlik, kota takibi ve adil kullanım gereği tüm geliştirici uç noktaları API anahtarı ile çalışır. Saniyeler içinde Bürküt Geliştirici Portalı üzerinden ücretsiz API Key oluşturabilirsiniz.

Daha detaylı Postman koleksiyonu, parametre açıklamaları ve SDK örnekleri için Bürküt Geliştirici Dokümantasyonu sayfamızı inceleyebilirsiniz.