Twelve Data

resmi

Twelve Data API'leri ile etkileşime geçerek yapay zeka ajanlarınız için gerçek zamanlı ve geçmiş finansal piyasa verilerine erişin.

GitHub
74

Twelve Data MCP ile neler yapabilirsiniz?

  • Gerçek zamanlı ve geçmiş fiyatları alın — hisse senetleri, ETF'ler, forex, kripto ve emtialar için mevcut veya geçmiş fiyat verilerini get_price kullanarak alın.
  • Teknik göstergeleri hesaplayın — RSI, MACD, SMA, Bollinger Bantları, ATR ve 60'tan fazla diğer göstergeyi get_technical_indicator aracılığıyla talep edin.
  • Şirket temel verilerini çekin — finansal tablolara, kazançlara, temettülere, bölünmelere, piyasa değerine ve önemli istatistiklere get_fundamentals ile erişin.
  • ETF ve yatırım fonu verilerini alın — fon profillerini, performansı, portföy dağılımını ve risk metriklerini get_fund aracılığıyla sorgulayın.
  • Şirket haberlerini alın — belirli bir sembol için en son haberleri ve basın bültenlerini get_news kullanarak edinin.
  • Piyasa istihbaratına erişin — piyasa hareketlilerini, döviz kurlarını, analist derecelendirmelerini ve fiyat hedeflerini get_market_movers ile bulun.

Dokümantasyon

Twelve Data MCP Sunucusu

Claude, ChatGPT ve diğer yapay zeka asistanlarını Twelve Data finans API'sine bağlayın — gerçek zamanlı ve geçmiş fiyatlar, 60'tan fazla teknik gösterge, temel veriler, kazançlar, temettüler, ETF'ler, şirket haberleri, piyasa hareketlileri ve daha fazlası.

Bir Twelve Data hesabına ihtiyacınız var. twelvedata.com adresinden kaydolun.

Kullanmanın iki yolu var. Çoğu kişi bulut sunucusunu kullanmalıdır (Seçenek 1) — kurulum gerektirmez.

Seçenek 1 — Bulut sunucumuzu kullanın (önerilir)

Yapay zeka asistanınızı barındırılan sunucumuza bağlayın:

https://mcp.twelvedata.com/mcp

Hepsi bu kadar. Kurulum yok, kopyalayıp yapıştıracak API anahtarı yok. Bağlandığınızda bir tarayıcı penceresi açılır ve Twelve Data hesabınızla giriş yaparsınız — kişisel API anahtarınız otomatik olarak bağlanır ve hesabınıza bağlı kalır.

Nasıl eklenir

Claude (Masaüstü / Web) ve ChatGPT özel bağlayıcıları / MCP sunucularını destekler:

  1. Asistanınızın Bağlayıcılar (veya Entegrasyonlar / MCP sunucuları) ayarlarını açın.
  2. https://mcp.twelvedata.com/mcp URL'si ile yeni bir bağlayıcı ekleyin.
  3. İstendiğinde, Bağlan / Giriş yap düğmesine tıklayın — tarayıcınızda bir Twelve Data giriş sayfası açılır.
  4. Yetkilendirin ve işlem tamam. "AAPL için RSI nedir?" veya "Bana TSLA'nın son kazançlarını göster" gibi şeyler sorun.

Tam menü adları uygulamalar ve sürümler arasında farklılık gösterir, ancak akış her zaman aynıdır: URL'yi ekleyin, ardından tarayıcı açılır penceresi aracılığıyla giriş yapın.

Seçenek 2 — API anahtarınızla yerel olarak çalıştırın

Sunucuyu kendi makinenizde çalıştırmayı mı tercih ediyorsunuz (ör. stdio üzerinden Claude Desktop için)? Yalnızca Twelve Data API anahtarınıza ihtiyacınız var — OAuth kurulumu gerekmez.

1. API anahtarınızı alın

twelvedata.com adresinden giriş yapın → kontrol paneliniz → API Anahtarları. Anahtarınızı kopyalayın.

2. Kurulum

Python 3.10+ gerektirir (3.12 önerilir; macOS'te brew install python@3.12 veya make python-install).

make install

3. API anahtarınızı ekleyin

Proje kök dizininde anahtarınızı içeren bir .env dosyası oluşturun:

TWELVE_DATA_API_KEY=your_api_key_here

4. Claude Desktop'a bağlanın

~/Library/Application Support/Claude/claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/twelve-data-mcp/.venv/bin/python",
      "args": ["/path/to/twelve-data-mcp/src/server.py"]
    }
  }
}

.venv/bin/python yolunu kullanın (sistem Python'unu değil — macOS 3.9 ile gelir ve bu sunucu 3.10+ gerektirir). Yapılandırmayı düzenledikten sonra Claude Desktop'ı yeniden başlatın.

Hepsi bu kadar — sunucu API anahtarınızı .env dosyasından okur ve her istek onu kullanır. Giriş adımı gerekmez.

Neler sorabilirsiniz

  • Fiyatlar — hisse senetleri, ETF'ler, forex, kripto, emtialar (gerçek zamanlı ve geçmiş)
  • Teknik göstergeler — RSI, MACD, SMA, BBANDS, ATR ve 60'tan fazlası
  • Temel veriler — finansal tablolar, kazançlar, temettüler, bölünmeler, şirket profilleri, piyasa değeri, temel istatistikler, halka arz takvimi
  • Fonlar — ETF ve yatırım fonu profilleri, performans, varlıklar, risk
  • Haberler — şirket haberleri ve basın bültenleri
  • Piyasa istihbaratı — hareketliler, döviz kurları, analist derecelendirmeleri, fiyat hedefleri
  • Düzenleyici — SEC/EDGAR dosyalamaları, içeriden öğrenen işlemleri, kurumsal varlıklar

Sembol formatları: hisse senetleri AAPL, kripto BTC/USD, forex EUR/USD.

Ortaklar

Kendi genel örneğinizi mi çalıştırıyorsunuz veya özel bir OAuth girişi mi kuruyorsunuz? Bu bir ortaklık düzenlemesidir — twelvedata.com adresinden bize ulaşın ve size kurulum kılavuzunu ve OAuth kimlik bilgilerini sağlayalım.